实操审校说明

本文属于工具实操教程。插件版本、免费额度、模型入口和界面名称可能随产品更新变化,请以官方客户端或插件市场实际显示为准。教程重点是可复现工作流,不承诺固定效率提升。


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 Code1.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 插件

  1. 打开 VS Code
  2. 左侧扩展图标(或 Ctrl+Shift+X
  3. 搜索 GitHub Copilot
  4. 点击安装(两个都装:GitHub Copilot + GitHub Copilot Chat

步骤3:登录 GitHub 账号

  1. VS Code 右下角会弹出登录提示,点击登录
  2. 浏览器打开 GitHub 授权页面,点击授权
  3. 授权成功后,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 会生成代码并插入光标位置。

示例:

  1. 选中一段代码
  2. Ctrl+I
  3. 输入:添加详细的注释
  4. Copilot 会自动添加注释

七、真实场景实战

场景1:快速搭建一个 Express API

  1. 新建 server.js
  2. 在文件里输入:
// 创建一个 Express 服务器,有 GET /api/users 和 POST /api/users 两个接口
  1. Tab 接受 Copilot 生成的完整代码
  2. 运行 node server.js 测试

场景2:用 Python 写数据分析脚本

  1. 新建 analyze.py
  2. 输入注释描述需求,Copilot 会自动生成 pandas 代码
  3. 用 Chat 让 Copilot 解释每行代码

场景3:重构旧代码

  1. 选中一段复杂的函数
  2. Ctrl+I → 输入 拆分这个函数,提高可读性
  3. 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 不弹出建议

原因:未登录或网络问题

解决

  1. 检查右下角是否显示「GitHub Copilot 已启用」
  2. 公司网络可能需要配置代理:VS Code 设置 → Http: Proxy

❌ 问题2:建议质量差

解决

  1. 写更详细的注释(Copilot 根据注释生成代码)
  2. 在函数名和变量名里用有意义的英文单词
  3. 打开相关文件(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%+。下一步学习 通义灵码实操 作为免费替代方案。*