GitHub Copilot for VS Code 中文使用完整教程
GitHub Copilot for VS Code 中文使用完整教程
本教程将带你从零开始，完整掌握如何在 VS Code 中使用 GitHub Copilot 生成中文内容，包括安装配置、中文优化、日常使用技巧和常见问题解决。
📦 第一章：安装与登录
1.1 安装 Copilot 扩展
- 打开 VS Code，点击左侧活动栏的扩展图标（或按
Ctrl+Shift+X/Cmd+Shift+X） - 在搜索框中输入
GitHub Copilot - 找到由 GitHub 官方发布的扩展，点击安装按钮
- 安装完成后，点击重新加载以激活扩展
1.2 登录 GitHub 账号授权
- 按
Ctrl+Shift+P（Mac:Cmd+Shift+P）打开命令面板 - 输入
GitHub Copilot: Login并回车 - 选择浏览器登录方式，在弹出的 GitHub 页面中完成授权
- 返回 VS Code，确认右下角状态栏出现Copilot 笑脸图标且为绿色（表示已激活）
网络问题提示：如果你在国内且遇到登录失败（如
connect ETIMEDOUT），需要配置代理。在 VS Code 设置中搜索http.proxy，设置为你的代理地址（如http://127.0.0.1:7890）。
⚙️ 第二章：中文专属优化配置
Copilot 本身没有"一键切换中文"的开关，但通过以下配置可以大幅提升中文输出质量。
2.1 全局配置（推荐：一次配置，所有项目生效）
这是让你所有项目都默认生成中文的关键配置。
操作步骤：
- 按
Ctrl+Shift+P→ 输入Preferences: Open User Settings (JSON) - 将以下配置粘贴进去并保存：
{// 将 Copilot Chat 整体语言设置为中文"github.copilot.chat.localeOverride":"zh-CN",// 配置 Commit Message 生成规则（核心）"github.copilot.chat.commitMessageGeneration.instructions":[{"text":"Always generate git commit messages in Simplified Chinese."},{"text":"使用约定式提交格式：<类型>: <描述>"},{"text":"常用类型包括：feat（新功能）、fix（修复）、docs（文档）、style（格式）、refactor（重构）、test（测试）、chore（杂务）"},{"text":"描述使用中文，简明扼要，不加句号"},{"text":"只输出最终的 commit message，不要输出解释或额外内容"}],// 启用内联建议（自动补全）"editor.inlineSuggest.enabled":true,// 确保 Copilot 已启用"github.copilot.enable":{"*":true}}注意：
github.copilot.chat.localeOverride只控制 Chat 响应语言，真正决定 commit message 规则的是commitMessageGeneration.instructions。两个都配置效果最佳。
2.2 进阶：提示词前缀配置（提升代码注释中文质量）
如果你希望 Copilot 在编写代码注释时也使用中文，可以在配置中添加：
{"github.copilot.advanced":{"promptPrefix":"你是一个资深中国全栈工程师，代码需符合以下要求：\n1. 使用中文注释\n2. 代码清晰规范\n3. 优先使用国产框架"}}2.3 团队共享配置（适合项目组统一规范）
如果你希望团队所有成员使用同一套中文规范，不要用 User Settings，而是放在项目仓库中：
第一步：在项目根目录创建.vscode/settings.json：
{"github.copilot.chat.commitMessageGeneration.instructions":[{"file":".github/commit-message-instructions.md"}]}第二步：创建.github/commit-message-instructions.md：
# Git Commit Message Rules - 所有 git commit message 必须使用简体中文。 - 严格使用格式：`<类型>: <描述>` - 允许类型：feat（新功能）、fix（修复）、docs（文档）、refactor（重构）、test（测试） - 只输出最终 commit message，不要附加解释。 - 描述要短、准、清晰。这样团队成员拉取代码后会自动生效。
💡 第三章：日常使用技巧
3.1 代码补全（Inline Mode）
当你输入代码时，Copilot 会显示灰色建议：
| 操作 | 快捷键 |
|---|---|
| 接受建议 | Tab |
| 拒绝/忽略 | Esc |
| 查看下一个建议 | Alt+](Mac:Option+]) |
| 查看上一个建议 | Alt+[(Mac:Option+[) |
| 打开建议面板（显示多个备选） | Ctrl+Enter |
中文注释驱动示例：
# 创建一个 Flask API，接收用户名并返回欢迎语输入上述中文注释后按回车，Copilot 会自动生成完整代码。
3.2 对话模式（Copilot Chat）
按Ctrl+Enter打开聊天面板，可以：
- 问问题：“如何用 Python 发送带附件的邮件？”
- 解释代码：选中代码 → 右键 → “Explain with Copilot”
- 修复错误：“帮我修复这个报错：TypeError: …”
- 重构代码：“把这个 for 循环改成列表推导式”
3.3 生成 Commit Message（核心功能）
- 先执行
git add暂存改动 - 打开源代码管理面板（Source Control）
- 点击输入框上方的✨ Generate Commit Message图标
- Copilot 会按之前配置的中文规范自动生成提交信息
注意：如果一键生成偶尔不听话（输出英文），可以在 Copilot Chat 中手动发指令兜底：
请根据当前已暂存改动，用中文生成一条 git commit message，格式：类型: 描述
3.4 快捷键速查表
| 功能 | 快捷键 |
|---|---|
| 接受建议 | Tab |
| 拒绝建议 | Esc |
| 打开 Copilot Chat | Ctrl+Enter |
| 解释选中代码 | 右键 → “Explain with Copilot” |
| 查看多个建议 | Alt+[/Alt+] |
| 切换 Copilot 启用状态 | Ctrl+Shift+P→ “Copilot: Toggle Enable” |
❓ 第四章：常见问题解答
Q1：Copilot 不显示任何建议怎么办？
检查以下三项：
- 状态栏 Copilot 图标是否为绿色（已登录激活）
- 设置中
github.copilot.enable是否为true - 当前文件是否有语言模式（右下角显示如 JavaScript、Python）
- 尝试输入足够长的上下文（如完整的函数签名或详细注释）
Q2：为什么 Copilot 还是输出英文？
Copilot 的语言输出主要由输入提示的语言决定：
- ✅ 用中文写注释 → 更容易得到中文输出
- ❌ 用英文或中英混杂 → 输出不稳定
- 技巧：在注释中明确要求，如
# 用中文解释下面这段代码的功能
Q3：如何让变量名也变成中文/拼音？
目前无法实现。编程语言标准要求标识符为 ASCII 字符，Copilot 不会生成中文变量名。变量名和函数名永远是英文，只有注释和 commit message 可以是中文。
Q4：生成 commit message 不符合格式要求怎么办？
最稳的兜底方案：直接在 Copilot Chat 里手动发指令：
请根据当前已暂存改动，严格按以下格式生成一条 git commit message： <类型>: <中文描述> 只允许类型：feat、fix、docs、refactor、test 只输出最终结果，不要解释。Q5：需要代理才能用吗？
如果你在国内且无法直接访问 GitHub 服务，需要配置代理：
- VS Code 设置 → 搜索
http.proxy→ 设置为http://127.0.0.1:7890（端口根据你的代理软件调整）
📊 第五章：与国产工具对比
| 对比项 | GitHub Copilot | 通义灵码 | DeepSeek Coder |
|---|---|---|---|
| 中文理解 | ⚠️ 一般（需配置） | ✅✅ 强 | ✅✅ 强 |
| 实时补全流畅度 | ✅✅✅ 行业标杆 | ✅✅ 流畅 | ✅✅ 高质量 |
| 是否可私有部署 | ❌ | ✅ 企业版支持 | ✅ 支持 |
| 成本 | $10/月 | 免费 | 免费 API |
| 推荐场景 | 国际项目、GitHub生态 | 中文项目、阿里云用户 | 安全要求高、本地化 |
选择建议：日常开发可组合使用——用国产工具保中文体验，用 Copilot 获取国际前沿能力。
📚 第六章：进阶学习资源
如果你想更系统地掌握 GitHub Copilot，推荐阅读：
- 《GitHub Copilot编程指南》（机械工业出版社，2025年5月出版）
- 作者：(美)库尔特·道斯韦尔
- 内容涵盖：安装配置、功能实战、单元测试、代码重构、CI/CD、企业版安全特性等
核心总结：
- 安装→ 扩展市场安装 + GitHub 登录授权
- 中文配置→ 修改 User Settings JSON，关键是
commitMessageGeneration.instructions - 日常使用→ Tab 接受建议，
Ctrl+Enter打开 Chat 对话 - Commit Message→ git add 后点击 ✨ 图标自动生成
- 不听话时→ 在 Chat 里手动发指令兜底
git.autorefresh这个设置，需要通过修改 VS Code 的配置文件settings.json来开启或关闭。
你可以用下面两种方法中的任意一种来找到它，我比较推荐第一种图形化操作，对新手更友好一些。
🖱️ 方法一：通过设置界面搜索（推荐）
这是最直观的方式，不用记代码：
- 打开 VS Code，按下快捷键
Ctrl + ,（Mac 上是Cmd + ,），这会直接打开设置页面。 - 在顶部的搜索框里输入
git.autorefresh。 - 搜索结果里就会出现这个选项，你只需要勾选或取消勾选它旁边的选框就行。
方案一：在父文件夹中创建多根工作区文件（推荐）
在my-project文件夹内创建一个.code-workspace文件，把各个子仓库添加进去。这样你以后打开my-project时，直接双击这个工作区文件就可以了。
操作步骤：
- 打开
my-project文件夹（用 VS Code 直接打开） - 添加子仓库到工作区：
- 点击菜单栏
文件>将文件夹添加到工作区... - 依次选择每个包含
.git的子文件夹（如frontend、backend、shared/libs/utils）
- 点击菜单栏
- 保存工作区到父文件夹内：
- 点击
文件>将工作区另存为... - 保存路径选择
my-project文件夹内，起名为my-project.code-workspace
- 点击
以后使用方式：
- 双击
my-project/my-project.codeworkspace打开，就能看到所有子仓库 - 或者先打开 VS Code，通过
文件>打开工作区选择这个文件
方案二：修改 VS Code 设置，开启多仓库检测(推荐最好用)
VS Code 有一个实验性功能，可以自动检测子文件夹中的 Git 仓库。
设置方法：
- 按
Ctrl + ,打开设置 - 搜索
git.repositoryScanForSubfolders - 勾选这个选项
- 再搜索
git.autoRepositoryDetection - 设置为
true或subFolders
设置完成后：
- 直接打开
my-project父文件夹 - VS Code 会扫描所有子文件夹，自动识别包含
.git的仓库 - SCM 面板会显示所有找到的仓库
⚠️ 注意：
- 这个功能是实验性的，扫描大型项目时可能会影响性能
- 如果你的项目层级很深或文件很多，建议用方案一