导航菜单

你是不是也 装完 VS Code 想试 Copilot，却在扩展市场搜出来一堆名字，搞不清该装哪个、装完又登不上？很多人卡在这一步反复卸载重装——本讲帮你 5 分钟把扩展装对、账号登进去。

 

 

官方文档链接（建议收藏）

• 本讲 · 安装扩展：https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-extension
• 本讲 · 个人设置向导：https://docs.github.com/en/copilot/how-tos/set-up/set-up-for-self
• VS Code 官方 · Set up Copilot：https://code.visualstudio.com/docs/copilot/setup
• Copilot 文档首页：https://docs.github.com/en/copilot

 

在 VS Code 里找到扩展

打开 VS Code，按 Ctrl+Shift+X（Mac 用 Cmd+Shift+X）打开扩展面板，搜索框输入 GitHub Copilot。你会看到两个关键扩展：

• GitHub Copilot（GitHub.copilot）——核心补全引擎，装了它才有行内灰色建议
• GitHub Copilot Chat（GitHub.copilot-chat）——侧边栏对话能力

官方文档说的是：首次设置时两个扩展会自动一起安装，你不需要手动逐个装。但如果你之前只装了其中一个、或者手动卸载过，搜到后点 Install 补上就行。

我踩过的坑是：装完扩展不要急着重启，先看左下角状态栏有没有 Copilot 图标。如果图标显示一个感叹号或禁止符号，说明还没登录——往下走。

 

登录 GitHub 账号

装好扩展后，VS Code 左下角会出现 Copilot 图标。点击它，选择 Sign in to GitHub，弹出一个设备码对话框：

1. 点 Copy and Open——设备码自动复制到剪贴板，同时浏览器打开 GitHub 设备激活页
2. 浏览器里粘贴设备码，点 Continue
3. 如果提示授权，点 Authorize VS Code

回到 VS Code，左下角 Copilot 图标变成正常状态就说明登录成功了。

我一般会：登录成功后随便打开一个代码文件，等几秒钟看有没有灰色补全建议弹出来——有的话就确认一切正常。

 

登录失败怎么办

国内环境下这一步最容易出问题，常见几种情况：

• 浏览器打不开 github.com：这不是 Copilot 的问题，是网络环境需要先解决访问。能正常打开 github.com 是前提。
• 设备码过期：对话框弹出后 5 分钟内没操作，码会失效。重新点一次 Sign in to GitHub 就行。
• Copilot 图标一直转圈：检查 VS Code 底部有没有 "Signing in…" 提示；如果卡住超过 1 分钟，Ctrl+Shift+P 输入 GitHub Copilot: Sign in 重新触发。
• 公司账号提示权限不足：如果你的 GitHub 账号属于组织（Organization），管理员可能没有开启 Copilot 权限——先确认组织侧是否已购买或启用。

还有一个容易忽略的：VS Code 里如果你同时登录了多个 GitHub 账号，Copilot 默认用主账号。不确定的话，Ctrl+Shift+P 搜 GitHub: Sign out 先退出再重新用目标账号登录。

 

跟做清单

• [ ] 打开 VS Code 扩展面板（Ctrl+Shift+X），搜 GitHub Copilot
• [ ] 确认 GitHub Copilot 和 GitHub Copilot Chat 两个扩展都显示 Installed
• [ ] 点左下角 Copilot 图标 → Sign in to GitHub → 完成设备码授权
• [ ] 随便打开一个代码文件，等几秒看有没有灰色补全建议
• [ ] 如果登录失败，先确认 github.com 在浏览器能正常打开
• [ ] 收藏本讲四个 Docs 链接