#安装与登录

本教程主线是 Visual Studio Code + GitHub 账号。官方也支持 Visual Studio、JetBrains、Vim/Neovim、Xcode、Eclipse 等，步骤以 Installing the GitHub Copilot extension 为准。

你需要：GitHub 账号，以及 Copilot Free 或付费套餐的访问权限（见 简介）。没有套餐时，VS Code 首次启用 AI 功能通常会引导你开通 Copilot Free。

#安装 VS Code

从 code.visualstudio.com/Download 安装最新稳定版。

Windows： 运行安装程序，建议勾选「添加到 PATH」。用 PowerShell 7 确认：

code --version

macOS： 把 VS Code 拖进「应用程序」。若终端里没有 code：命令面板（Cmd+Shift+P）→ Shell Command: Install 'code' command in PATH。

code --version

打开一个文件夹（仓库根），不要只开单个零散文件。Chat 的工作区上下文以文件夹为准。

#安装 GitHub Copilot 扩展

官方现在有两条路，效果相同：装上 Copilot 相关扩展并用 GitHub 登录。

#方式 A：状态栏引导（官方推荐）

1. 打开 VS Code，把鼠标悬停在状态栏的 Copilot 图标上。
2. 选择 Use AI Features（文案以你当前版本为准）。
3. 按提示选择登录方式。首次设置时，所需扩展会自动安装，不必先手动搜一遍。

详见 VS Code 文档 Set up GitHub Copilot in VS Code。

#方式 B：扩展市场（你明确要装插件时）

1. 打开扩展视图：Windows Ctrl+Shift+X，macOS Cmd+Shift+X。
2. 搜索 GitHub Copilot（发布者 GitHub）。
3. 安装。当前 VS Code 会一并带上 Chat 能力；若市场里仍能看到 GitHub Copilot Chat，按页面说明安装即可。
4. 也可以在浏览器打开 Marketplace: GitHub Copilot，点 Install。

扩展 ID 以市场页为准，常见为 GitHub.copilot。

#用 GitHub 登录

没有登录就没有补全和 Chat。

1. 点击活动栏 Accounts，或状态栏 Copilot 菜单里的 Sign in to use Copilot / Sign in with GitHub to use GitHub Copilot。
2. 命令面板也可运行 GitHub Copilot: Sign in。
3. 浏览器打开 GitHub，批准 VS Code / Copilot 所需权限。
4. 回到编辑器，状态栏 Copilot 图标应变为已登录。

Windows 与 macOS 相同，都是浏览器 OAuth 回调。公司代理若拦截 github.com / api.github.com，先让网络放行，见官方 Network settings for GitHub Copilot。

换账号：Accounts → 先 Sign out，再按上面登录。工作区要用另一个 GitHub 身份时，见 VS Code 的 “Use a different GitHub account” 说明。

GitHub Enterprise（GHE.com）：登录对话框选 Continue with GHE.com 并填实例 URL。托管用户可能要先改 github.copilot.advanced 的 authProvider，见 Using GitHub Copilot with an account on GHE.com。

#可选：JetBrains

在 IntelliJ IDEA、PyCharm、WebStorm 等兼容 IDE 里：

1. Settings / Preferences → Plugins → Marketplace，搜索 GitHub Copilot，安装后重启。
2. 菜单 Tools → GitHub Copilot → Login to GitHub。
3. Copy and Open 设备码，在浏览器粘贴并 Authorize GitHub Copilot Plugin。
4. 回到 IDE 点 OK。

兼容 IDE 列表与版本以 JetBrains Marketplace: GitHub Copilot 为准。也可不装插件、改走 JetBrains AI Assistant 或 Copilot CLI，对照见官方 Using GitHub Copilot in JetBrains IDEs。

#可选：Visual Studio（Windows）

需要 Visual Studio 2022 17.8+。较新版本（17.10 起）已内置统一的 Copilot 组件。把 GitHub 账号加入 Visual Studio keychain，步骤见 Microsoft 的 Install GitHub Copilot in Visual Studio。macOS 上的 Visual Studio for Mac 已停更，不要把它当主路径。

#快速自检

组织账号：管理员可能禁用 Chat、CLI 或 cloud agent。扩展绿灯但功能灰掉时，先问组织策略，而不是重装 VS Code。

#常见问题

登录成功但没有幽灵文本？
确认当前语言未被禁用；看状态栏 Copilot 是否被 pause。可命令面板运行触发建议相关命令。仍无输出时，对照 Troubleshooting common issues with GitHub Copilot。

公司仓库不想用 AI？
VS Code 可用 chat.disableAIFeatures 在用户或工作区关掉内置 AI。组织侧还可配置 content exclusion，见官方文档。

只想先看文档？
可以先读 快速上手 的示例，装好后再原样练习。

#下一步

• 快速上手
• 行内补全