GitHub Copilot for VS Code 中文使用完整教程

GitHub Copilot for VS Code 中文使用完整教程

本教程将带你从零开始，完整掌握如何在 VS Code 中使用 GitHub Copilot 生成中文内容，包括安装配置、中文优化、日常使用技巧和常见问题解决。

📦 第一章：安装与登录

1.1 安装 Copilot 扩展

1. 打开 VS Code，点击左侧活动栏的扩展图标（或按 Ctrl+Shift+X / Cmd+Shift+X）
2. 在搜索框中输入 GitHub Copilot
3. 找到由 GitHub 官方发布的扩展，点击安装按钮
4. 安装完成后，点击重新加载以激活扩展

1.2 登录 GitHub 账号授权

1. 按 Ctrl+Shift+P（Mac: Cmd+Shift+P）打开命令面板
2. 输入 GitHub Copilot: Login 并回车
3. 选择浏览器登录方式，在弹出的 GitHub 页面中完成授权
4. 返回 VS Code，确认右下角状态栏出现 Copilot 笑脸图标且为绿色（表示已激活）

网络问题提示：如果你在国内且遇到登录失败（如 connect ETIMEDOUT），需要配置代理。在 VS Code 设置中搜索 http.proxy，设置为你的代理地址（如 http://127.0.0.1:7890）。

⚙️ 第二章：中文专属优化配置

Copilot 本身没有"一键切换中文"的开关，但通过以下配置可以大幅提升中文输出质量。

2.1 全局配置（推荐：一次配置，所有项目生效）

这是让你所有项目都默认生成中文的关键配置。

操作步骤：

1. 按 Ctrl+Shift+P → 输入 Preferences: Open User Settings (JSON)
2. 将以下配置粘贴进去并保存：

{
  // 将 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 会显示灰色建议：

中文注释驱动示例：

# 创建一个 Flask API，接收用户名并返回欢迎语

输入上述中文注释后按回车，Copilot 会自动生成完整代码。

3.2 对话模式（Copilot Chat）

按 Ctrl+Enter 打开聊天面板，可以：

• 问问题：“如何用 Python 发送带附件的邮件？”
• 解释代码：选中代码 → 右键 → “Explain with Copilot”
• 修复错误：“帮我修复这个报错：TypeError: …”
• 重构代码：“把这个 for 循环改成列表推导式”

3.3 生成 Commit Message（核心功能）

1. 先执行 git add 暂存改动
2. 打开源代码管理面板（Source Control）
3. 点击输入框上方的 ✨ Generate Commit Message 图标
4. Copilot 会按之前配置的中文规范自动生成提交信息

注意：如果一键生成偶尔不听话（输出英文），可以在 Copilot Chat 中手动发指令兜底：

请根据当前已暂存改动，用中文生成一条 git commit message，格式：类型: 描述

3.4 快捷键速查表

❓ 第四章：常见问题解答

Q1：Copilot 不显示任何建议怎么办？

检查以下三项：

1. 状态栏 Copilot 图标是否为绿色（已登录激活）
2. 设置中 github.copilot.enable 是否为 true
3. 当前文件是否有语言模式（右下角显示如 JavaScript、Python）
4. 尝试输入足够长的上下文（如完整的函数签名或详细注释）

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（端口根据你的代理软件调整）

📊 第五章：与国产工具对比

选择建议：日常开发可组合使用——用国产工具保中文体验，用 Copilot 获取国际前沿能力。

📚 第六章：进阶学习资源

如果你想更系统地掌握 GitHub Copilot，推荐阅读：

• 《GitHub Copilot编程指南》（机械工业出版社，2025年5月出版）
  • 作者：(美)库尔特·道斯韦尔
  • 内容涵盖：安装配置、功能实战、单元测试、代码重构、CI/CD、企业版安全特性等

核心总结：

1. 安装 → 扩展市场安装 + GitHub 登录授权
2. 中文配置 → 修改 User Settings JSON，关键是 commitMessageGeneration.instructions
3. 日常使用 → Tab 接受建议，Ctrl+Enter 打开 Chat 对话
4. Commit Message → git add 后点击 ✨ 图标自动生成
5. 不听话时 → 在 Chat 里手动发指令兜底

git.autorefresh 这个设置，需要通过修改 VS Code 的配置文件 settings.json 来开启或关闭。

你可以用下面两种方法中的任意一种来找到它，我比较推荐第一种图形化操作，对新手更友好一些。

🖱️ 方法一：通过设置界面搜索（推荐）

这是最直观的方式，不用记代码：

1. 打开 VS Code，按下快捷键 Ctrl + , （Mac 上是 Cmd + ,），这会直接打开设置页面。
2. 在顶部的搜索框里输入 git.autorefresh。
3. 搜索结果里就会出现这个选项，你只需要勾选或取消勾选它旁边的选框就行。

方案一：在父文件夹中创建多根工作区文件（推荐）

在 my-project 文件夹内创建一个 .code-workspace 文件，把各个子仓库添加进去。这样你以后打开 my-project 时，直接双击这个工作区文件就可以了。

操作步骤：

1. 打开 my-project 文件夹（用 VS Code 直接打开）
2. 添加子仓库到工作区：
   • 点击菜单栏 文件 > 将文件夹添加到工作区...
   • 依次选择每个包含 .git 的子文件夹（如 frontend、backend、shared/libs/utils）
3. 保存工作区到父文件夹内：
   • 点击 文件 > 将工作区另存为...
   • 保存路径选择 my-project 文件夹内，起名为 my-project.code-workspace

以后使用方式：

• 双击 my-project/my-project.codeworkspace 打开，就能看到所有子仓库
• 或者先打开 VS Code，通过 文件 > 打开工作区 选择这个文件

方案二：修改 VS Code 设置，开启多仓库检测(推荐最好用)

VS Code 有一个实验性功能，可以自动检测子文件夹中的 Git 仓库。

设置方法：

1. 按 Ctrl + , 打开设置
2. 搜索 git.repositoryScanForSubfolders
3. 勾选这个选项
4. 再搜索 git.autoRepositoryDetection
5. 设置为 true 或 subFolders

设置完成后：

• 直接打开 my-project 父文件夹
• VS Code 会扫描所有子文件夹，自动识别包含 .git 的仓库
• SCM 面板会显示所有找到的仓库

⚠️ 注意：

• 这个功能是实验性的，扫描大型项目时可能会影响性能
• 如果你的项目层级很深或文件很多，建议用方案一