实操审校说明
本文属于工具实操教程。插件版本、免费额度、模型入口和界面名称可能随产品更新变化,请以官方客户端或插件市场实际显示为准。教程重点是可复现工作流,不承诺固定效率提升。
VS Code + GitHub Copilot 实操教程:从安装到项目开发
📅 更新时间:2026 年 6 月
🔧 参考环境:VS Code v1.101+ / GitHub Copilot v1.254+ / Node.js 18+
👤 适合人群:想提升编码效率的开发者
⏱ 预计完成时间:20 分钟
一、GitHub Copilot 是什么?
GitHub Copilot 是 AI 代码助手,可以:
- 根据注释自动补全代码(Tab 接受建议)
- 用自然语言描述需求,直接生成代码
- 解释复杂代码、写单元测试、重构代码
- 支持几乎所有编程语言
费用:个人版 $10/月,学生/开源维护者免费。
二、工具版本要求
| 工具 | 版本要求 | 检查命令 |
| VS Code | 1.101+ | code --version |
| GitHub Copilot 插件 | 1.254+ | VS Code → 扩展里查看 |
| Node.js(可选) | 18+ | node --version |
| Git(可选) | 2.30+ | git --version |
三、安装 GitHub Copilot
步骤1:安装 VS Code
下载:https://code.visualstudio.com/
步骤2:安装 Copilot 插件
- 打开 VS Code
- 左侧扩展图标(或
Ctrl+Shift+X) - 搜索
GitHub Copilot - 点击安装(两个都装:
GitHub Copilot+GitHub Copilot Chat)
步骤3:登录 GitHub 账号
- VS Code 右下角会弹出登录提示,点击登录
- 浏览器打开 GitHub 授权页面,点击授权
- 授权成功后,VS Code 右下角显示「GitHub Copilot 已启用」
四、核心功能1:代码补全(Tab 补全)
使用方式
写代码时,Copilot 会自动给出灰色建议,按 Tab 接受,Esc 拒绝。
示例1:写函数
# 写一个函数,计算斐波那契数列的第n项
(写到这里停,Copilot 会自动补全整个函数)
示例2:写注释生成代码
// 创建一个函数,将数组按照指定键值分组
(Copilot 会生成完整的 groupBy 函数)
技巧
| 操作 | 快捷键 |
| 接受建议 | Tab |
| 查看下一条建议 | Alt+] 或 Alt+↓ |
| 查看上一条建议 | Alt+[ 或 Alt+↑ |
| 拒绝建议 | Esc |
五、核心功能2:Copilot Chat(对话生成代码)
按 Ctrl+I(内联对话)或 Ctrl+Shift+I(侧边栏对话)打开 Chat。
常用提示词模板
生成代码:
用 Python 写一个函数,输入一个网址,返回网页的标题和描述
解释代码:
解释下面这段代码的作用:
(粘贴代码)
写测试:
为上面这个函数写单元测试,使用 pytest
重构代码:
重构下面的代码,提高可读性:
(粘贴代码)
修复 Bug:
这段代码有什么问题?怎么修?
(粘贴代码 + 错误信息)
六、核心功能3:内联对话(Ctrl+I)
在编辑器里按 Ctrl+I,可以直接描述需求,Copilot 会生成代码并插入光标位置。
示例:
- 选中一段代码
- 按
Ctrl+I - 输入:
添加详细的注释 - Copilot 会自动添加注释
七、真实场景实战
场景1:快速搭建一个 Express API
- 新建
server.js - 在文件里输入:
// 创建一个 Express 服务器,有 GET /api/users 和 POST /api/users 两个接口
- 按
Tab接受 Copilot 生成的完整代码 - 运行
node server.js测试
场景2:用 Python 写数据分析脚本
- 新建
analyze.py - 输入注释描述需求,Copilot 会自动生成
pandas代码 - 用 Chat 让 Copilot 解释每行代码
场景3:重构旧代码
- 选中一段复杂的函数
Ctrl+I→ 输入拆分这个函数,提高可读性- Copilot 会自动重构
八、Copilot 设置优化
开启多行建议
VS Code 设置(Ctrl+,)→ 搜索 copilot:
- ✅ 勾选
GitHub Copilot: Enable Auto Suggestions - ✅ 勾选
GitHub Copilot: Editor: Enable Inline Suggest
排除敏感文件
不希望 Copilot 读取的文件,在 .gitignore 里添加,或在设置里配置:
// settings.json
"github.copilot.editor.enable": {
"**/*.env": false,
"**/secrets/**": false
}
九、免费替代方案
如果不想付费,可以用:
| 工具 | 费用 | 特点 |
| 通义灵码 | 免费 | 阿里出品,中文友好 |
| 腾讯云 CodeBuddy | 免费 | 腾讯出品,支持企业微信登录 |
| CodeGeex | 免费 | 智谱 AI 出品,支持 100+ 语言 |
| Cursor | 免费版够用 | 独立编辑器,AI 能力强 |
十、常见问题
❌ 问题1:Copilot 不弹出建议
原因:未登录或网络问题
解决:
- 检查右下角是否显示「GitHub Copilot 已启用」
- 公司网络可能需要配置代理:VS Code 设置 →
Http: Proxy
❌ 问题2:建议质量差
解决:
- 写更详细的注释(Copilot 根据注释生成代码)
- 在函数名和变量名里用有意义的英文单词
- 打开相关文件(Copilot 会根据项目上下文给出更好的建议)
❌ 问题3:免费版用不了
解决:学生可以申请 GitHub Student Pack(免费 Copilot + 其他福利)
十一、完整配置参考
settings.json 推荐配置:
{
"github.copilot.enable": {
"*": true,
"markdown": true,
"plaintext": false
},
"github.copilot.editor.enableAutoSuggestions": true,
"github.copilot.chat.startLanguageServer": true
}
*掌握 Copilot 后编码效率提升 30%+。下一步学习 通义灵码实操 作为免费替代方案。*