GitHub Copilot 配置指南

GitHub 出品的 AI 编程助手，深度集成 VS Code 和 JetBrains

难度：●○○简单参考时长：约 5-10min支持：windows · macos · linux

🌐 本指南内容三端通用

按照以下步骤在你的系统上安装 GitHub Copilot。本指南覆盖 VS Code、JetBrains IDE 和 Neovim 三种编辑器。

网络说明：GitHub Copilot 在国内可直接使用，不需要科学上网。个人版 $10/月，提供 30 天免费试用。支持支付宝付款。如果是学生或开源项目维护者，可免费获取。

1你要装的是哪一个？先搞清楚

GitHub Copilot 是一个 IDE 扩展（插件），不是一个独立的应用程序。它嵌入在你已有的编辑器里，以灰字补全和对话面板的形式提供 AI 辅助。你不装 IDE 就没法用 Copilot——这和 Cursor/Windsurf 不同（它们是自带 AI 的完整 IDE），和 Claude Code/Codex CLI 也不同（它们是命令行工具）。

产品	类型	怎么用	适合谁
GitHub Copilot（本指南）	IDE 扩展（插件）	装在 VS Code/JetBrains/Neovim 里	已有常用 IDE、主要需要代码补全的开发者
Cursor / Windsurf	完整 IDE	下载后直接打开，AI 内置在里面	想要全能 AI IDE 的开发者
Claude Code / Codex CLI	命令行工具	在终端里输入指令	需要全栈自动化能力的开发者

💡 Copilot 的核心定位：它是目前覆盖面较广的代码补全工具，在写代码时自动给出建议，按 Tab 即可补全。但它不能像 Claude Code 那样管理 Git、运行命令、操作项目文件。部分开发者将 Copilot 和 Claude Code 配合使用——Copilot 负责补全，Claude Code 负责大任务。

2你需要先有什么

安装 Copilot 之前，你需要有一个支持的编辑器：

编辑器	支持情况	推荐度
VS Code	完整支持，体验最好	⭐⭐⭐（推荐）
JetBrains IDE	IntelliJ / PyCharm / WebStorm / GoLand 等全部支持	⭐⭐⭐
Neovim	通过插件管理器安装	⭐⭐（适合 Vim 用户）

前置依赖：Copilot 本身不需要安装 Node.js 或其他运行时。但你用的编辑器（如 VS Code）需要先装好。以下按编辑器分别说明安装方式。

3方式一：VS Code 安装（推荐）

3.1 安装 VS Code（如果还没有）

访问 code.visualstudio.com （国内可直连），下载对应系统的安装包，双击安装。安装过程约 2 分钟，无需特殊配置。

3.2 安装 Copilot 扩展

打开 VS Code
按 Ctrl+Shift+X（macOS：Cmd+Shift+X）打开扩展面板
搜索 "GitHub Copilot"
找到发布者为 GitHub 的扩展，点击 Install
安装完成后，VS Code 底部状态栏会出现 Copilot 图标

注意区分：扩展商店里可能搜出多个 Copilot 相关扩展（如 Copilot Chat、Copilot Labs）。本指南装的是 GitHub Copilot（发布者 GitHub），这一个扩展同时包含代码补全和聊天功能。不要装错了。

如果扩展安装失败：① 最常见的原因是 VS Code 版本过旧——确保 VS Code 更新到最新版（帮助 → 检查更新）；② 如果下载速度慢，说明 VS Code 扩展市场连接不畅，可到 B站搜索 "VS Code 扩展离线安装" 使用 .vsix 离线包安装；③ 如果提示和已有扩展冲突，先禁用其他 AI 补全扩展（如 Tabnine、CodeGeeX 等）再装 Copilot。

4方式二：JetBrains IDE 安装

支持 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、Rider 等全部 JetBrains IDE。

打开你的 JetBrains IDE
Settings（macOS：Preferences）→ Plugins → Marketplace
搜索 "GitHub Copilot" → 点击 Install
安装完成后 重启 IDE
重启后菜单栏出现 Tools → GitHub Copilot 选项

JetBrains 常见问题：① 如果插件市场搜索不到，检查 IDE 版本（需要 2022.2 或更高）；② 安装后必须重启 IDE 才能看到 Copilot 菜单；③ 如果是公司电脑，可能需要联系 IT 开通插件市场访问权限。

5方式三：Neovim 安装（适合 Vim 用户）

Neovim 用户通过插件管理器安装。需要 Node.js 18+ 环境。

使用 lazy.nvim（推荐）

lua

-- 在 plugins.lua 或 lazy 配置目录中添加：

{ "github/copilot.vim", lazy = false }

使用 vim-plug

vim

" 在 init.vim 或 .vimrc 中添加：

Plug 'github/copilot.vim'

添加后执行 :PlugInstall，安装完成后在 Neovim 中运行 :Copilot setup。

Neovim 用户注意：Copilot.vim 是社区维护的插件，和 VS Code 版的 Copilot Chat 功能不同（Vim 版主要提供代码补全，对话功能较有限）。如果你是 Vim/Neovim 用户且需要更完整的 AI 功能，建议搭配 Claude Code CLI 使用——Copilot 负责补全，Claude Code 负责对话和项目操作。

6登录与激活

安装扩展后，编辑器底部状态栏出现 Copilot 图标（VS Code / JetBrains）或运行 :Copilot setup（Neovim）
点击图标 → 选择 Sign in to GitHub
浏览器弹出 GitHub 授权页面 → 登录你的 GitHub 账户 → 点击 Authorize GitHub Copilot
授权成功后回到编辑器，状态栏 Copilot 图标变亮表示登录成功

登录常见问题：① GitHub 在国内可以直连但偶尔较慢，如果弹窗后一直加载中，等 30 秒左右；② 如果没有 GitHub 账户，先去 github.com/signup 注册一个（国内可直连，不需要科学上网）；③ 如果浏览器没有自动弹出，VS Code 中按 F1 → 输入 "Copilot: Sign in" 手动触发；④ JetBrains 用户：Tools → GitHub Copilot → Login to GitHub。

7订阅与免费试用

方案	价格	特色	适合谁
Individual（个人版）	$10/月	30 天免费试用 · 支持支付宝	个人开发者（推荐）
Business（商业版）	$19/月/用户	代码隐私保护 · 管理后台	小团队
Enterprise（企业版）	$39/月/用户	自定义模型 · SSO · 审计日志	大型企业
免费获取方式	$0	GitHub Student Developer Pack（学生）· 知名开源项目维护者

免费试用注意事项：30 天免费试用需要绑定支付方式（信用卡或 PayPal）。试用到期前可以取消，不会扣费。如果不方便绑定支付方式，可以申请 GitHub Student Pack 免费获取（需要学生认证）。支付宝付款仅支持个人版，从 github.com 的设置页面操作。

8验证安装

打开任意代码文件，用以下方式测试：

测试代码补全

javascript
// 在编辑器中输入这段注释，然后按回车：
// 写一个函数，接收一个数组，返回去重并排序后的新数组
// 如果 Copilot 给出了灰色建议代码，说明补全正常 ✅

按 Tab 接受建议，Esc 拒绝。Alt+] / Alt+[ 查看下一条/上一条建议。

测试 Copilot Chat（对话）

按 Cmd+I（macOS）或 Ctrl+I（Windows/Linux）打开对话面板，输入：

text

解释一下这个文件的功能

如果 AI 回复了分析结果，Chat 功能正常 ✅。

如果完全看不到补全：① 确认 Copilot 扩展已启用（VS Code 状态栏 Copilot 图标应亮起，不是灰色）；② 确认已登录 GitHub 且订阅有效（或试用中）；③ 确认文件类型受支持（大多数编程语言都支持，纯文本文件不支持）；④ 按 F1 → "GitHub Copilot: Sign in" 重新登录；⑤ 检查 VS Code 设置中 "github.copilot.enable" 是否被设为 false（搜索 copilot 查看所有设置项）；⑥ 仍不行到 B站搜索 "GitHub Copilot 不工作" 查看视频排查。

9下一步：配置项目指令

在项目根目录创建 .github/copilot-instructions.md 文件，告诉 Copilot 你的编码规范：

markdown

# .github/copilot-instructions.md 示例

## 编码风格
- 使用 TypeScript 严格模式，禁止 any
- 函数组件使用 export function，不用 export default
- CSS 使用 Tailwind 原子类，不手写 .css

## 项目约定
- API 路由放在 src/app/api/ 下
- 数据库查询使用 Prisma，不手写 SQL

## Copilot 行为
- 优先使用项目已有的工具函数
- 复杂修改先输出方案，确认后再写代码

类似 Claude Code 的 CLAUDE.md 和 Cursor 的 .cursorrules。建议提交到 Git 仓库，团队成员共享一致的 AI 规范。详见「配置指南」标签页。

💡 如果上述步骤遇到问题，建议到 B站或其他网络平台搜索 "GitHub Copilot 安装教程"，视频教程通常有更直观的演示。Copilot 故障排查请见本页的「故障排查」标签页。

有疑问？来这里找答案

如果对本站内容有疑问，推荐到视频或其他知识性平台寻求解决方法，也可直接向 AI 提问获得参考性回答（注意分辨 AI 回答的正确性）

视频教程

B站搜索教程

视频演示 + 疑难解答