三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

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

发布时间：2026/8/9 2:57:06 三亩地 编程学习日记
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 会显示灰色建议：

操作快捷键
接受建议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（核心功能）

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

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

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

3.4 快捷键速查表

功能快捷键
接受建议Tab
拒绝建议Esc
打开 Copilot ChatCtrl+Enter
解释选中代码右键 → “Explain with Copilot”
查看多个建议Alt+[/Alt+]
切换 Copilot 启用状态Ctrl+Shift+P→ “Copilot: Toggle Enable”

❓ 第四章：常见问题解答

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

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

对比项GitHub Copilot通义灵码DeepSeek Coder
中文理解⚠️ 一般（需配置）✅✅ 强✅✅ 强
实时补全流畅度✅✅✅ 行业标杆✅✅ 流畅✅✅ 高质量
是否可私有部署❌✅ 企业版支持✅ 支持
成本$10/月免费免费 API
推荐场景国际项目、GitHub生态中文项目、阿里云用户安全要求高、本地化

选择建议：日常开发可组合使用——用国产工具保中文体验，用 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 面板会显示所有找到的仓库

⚠️ 注意：

  • 这个功能是实验性的，扫描大型项目时可能会影响性能
  • 如果你的项目层级很深或文件很多，建议用方案一
编程学习 学习日记 实战经验
← 返回列表