Copilot写Git提交说明：添加示例提示词提升稳定性

核心结论：要让Microsoft Copilot稳定输出高质量的中文Git提交信息，不能只依赖抽象规则，必须将具体的代码变更场景嵌入提示词。缺乏示例支撑，Copilot如同缺乏经验的记录者，输出结果随场景理解偏差而波动极大。

比如，指令只写“修复登录页样式”，Copilot可能将其理解为padding微调、字体颜色替换或响应式断点变更，甚至误判为按钮交互逻辑。当你提供包含文件路径、修改前后对比的改动快照，并附上一条匹配的提交信息示例，Copilot便能精准建立场景与格式的映射关系。

缺失示例的代价显著——GitHub 2026年4月的A/B测试显示，无示例场景下生成内容的波动率高出63%。

示例为何不可或缺

本质在于语义映射差异。Copilot是文本关联型模型，缺乏人类对代码改动的直觉理解。单一指令“修复登录页样式”可对应圆角调整、字体颜色更换或响应式断点修改，三种完全不同的变更在模型眼中可能映射为同一条提交信息。

当提示词中明确包含文件路径、行号、修改前后的具体内容，以及对应的提交信息格式范例，Copilot便能准确识别模式。类比学做菜，仅有食谱清单不够，完整的烹饪演示才能掌握要点。

在VS Code中添加含示例的提示词

配置流程仅需三步：

第一步：进入VS Code设置，点击左下角齿轮，选择“设置”。
第二步：搜索关键词“copilot commit”，定位到“GitHub Copilot Chat: Commit Message Generation Instructions”，点击其右侧的“在settings.json中编辑”。
第三步：将settings.json中"git-commit-instructions"字段的纯规则文本，替换为下方提供的含三组真实示例的完整提示词模板，保存文件。

务必先清除原有英文提示词，否则新配置不会生效。

直接可用的含示例提示词模板

请严格复制以下内容（不含```符号），粘贴进settings.json对应字段的字符串值内。注意不要包含外层引号，也不要换行缩进：

```
请根据本次代码变更，生成符合Conventional Commits规范的中文提交信息。语言：简体中文；禁止使用“我们”“我”等人称代词；每行不超过72字符；Header必须包含type(scope)和subject，Body用短横线列表展开细节。

示例1：
变更内容：修改src/components/LoginForm.tsx，将input框的border-radius从4px改为6px，移除box-shadow
生成结果：
fix(ui): 调整登录表单输入框圆角与阴影
- 将border-radius从4px改为6px
- 移除box-shadow样式

示例2：
变更内容：新增tests/utils/date.test.ts，覆盖formatDate()函数的时区处理逻辑
生成结果：
test(utils): 为日期格式化工具添加时区处理测试用例
- 新增formatDate()在UTC+8和UTC-5时区下的输出校验
- 补充无效时区参数的边界测试

示例3：
变更内容：重命名src/api/auth.ts → src/api/authentication.ts，同步更新所有import路径
生成结果：
refactor(api): 重命名认证模块文件并更新引用路径
- 将auth.ts重命名为authentication.ts
- 更新5处import语句中的路径
- 修正tsconfig.json中paths别名映射
```

复制上方代码块内全部内容（不含```符号），直接粘贴至JSON字符串值位置。唯一注意事项：双引号必须完整闭合，否则JSON语法错误会导致Copilot提交信息生成功能完全失效。

验证配置是否生效

配置完成后，通过以下两种方法快速验证：

方法一：在VS Code中打开含有未提交更改的Git项目，按下Ctrl+Shift+P，输入“GitHub Copilot: Generate Commit Message”并回车。
方法二：右键点击源代码管理视图的“更改”区域，选择“Generate commit message with GitHub Copilot”。

若生成的提交信息包含中文、具备type(scope)前缀、Body项以短横线开头，且与当前文件改动高度相关，则配置成功。反之，若返回英文或格式错乱，请检查settings.json的语法，通常为双引号未正确闭合导致。

来源：互联网