github copilot 遵循团队规范需配置五种路径：一、项目级 .github/copilot-instructions.md 文件；二、目录级 .copilotignore 排除；三、嵌入合规示例代码块；四、绑定本地格式化工具链；五、用户级全局指令设置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 GitHub Copilot 时发现其生成的代码频繁偏离团队命名、格式或安全约定，则问题根源往往在于缺乏明确、可执行的规则注入机制。以下是强制 Copilot 遵循团队代码规范的多种配置路径：
一、创建项目级指令文件 .github/copilot-instructions.md
该文件是 Copilot 在项目中读取的最高优先级自然语言指令源，所有建议均实时受其约束。它无需手动触发，只要存在即自动生效。
1、在项目根目录下新建文件夹 .github。
2、在该文件夹内创建纯文本文件，命名为 copilot-instructions.md。
3、以 Markdown 格式编写结构化指令，开头必须包含 ---applyTo: "**"--- 声明适用范围。
4、在后续内容中分节定义命名规范、错误处理、日志方式等，例如：
"## 命名规范
- 公共函数：PascalCase（如 CalculateTaxAmount）
- 私有变量：snake_case（如 _cached_user_id）
- 常量：ALL_CAPS（如 DEFAULT_TIMEOUT_MS）"
二、配置目录级排除文件 .copilotignore
此文件用于主动屏蔽 Copilot 在敏感或不适用目录中的建议行为，避免风格污染与安全风险，适用于密钥配置、遗留模块等场景。
1、在需禁用 Copilot 的目录中新建文件，命名为 .copilotignore。
2、每行填写一个相对路径模式，支持通配符，例如：
config/secrets.json
legacy/**
node_modules/
3、保存后，Copilot 将完全跳过该目录下所有文件的代码补全与聊天上下文分析。
三、嵌入上下文示例代码块
Copilot 的补全行为高度依赖当前编辑器中可见的邻近代码结构，通过预置符合规范的样板，可实现零配置风格牵引。
1、在目标文件顶部或相邻函数位置，手动编写一段完整、合规的参考代码。
2、确保该代码块包含：标准缩进（2空格或4空格）、JSDoc 注释、类型注解及 团队指定的 API 调用形式。
3、将光标置于该代码块下方或内部，触发 Copilot 补全，其输出将严格对齐已有上下文风格。
四、绑定本地格式化工具链
利用 VS Code 编辑器的保存钩子，在 Copilot 输出后立即执行标准化修正，形成“生成→校准→落地”闭环。
1、确认项目已安装 esbenp.prettier-vscode 与 dbaeumer.vscode-eslint 插件。
2、在项目根目录的 .vscode/settings.json 中添加：
{
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.fixAll": true,
"source.organizeImports": true
}
}
3、确保项目中存在 .prettierrc 与 .eslintrc.js，且规则覆盖缩进、引号、分号等基础项。
五、设置用户级全局指令（VS Code 用户配置）
当需跨多个项目统一基础风格（如禁止 console.log、强制类型注解），可在 VS Code 用户设置中注入通用约束，作为项目级指令的补充层。
1、打开 VS Code 设置（Ctrl+,），切换至“JSON”编辑模式。
2、在 settings.json 的顶层对象中添加：
"github.copilot.advanced": {
"instructions": ["Use TypeScript type annotations for all function parameters and return values.", "Never use console.log; use logger.info() or logger.error() instead."]
}
3、该配置将作为默认上下文，附加到所有 Copilot 聊天与补全请求中，不受单个项目文件缺失影响。
