GitHub Copilot 入门指南

GitHub Copilot 是 GitHub 推出的 AI 编程助手，深度集成于 VS Code 等主流 IDE 和终端。截至 2026 年 5 月，Copilot 已支持多模型切换、Agent 模式、CLI 终端、Skills 插件等丰富功能。

本文面向首次使用者，以 VS Code 为例介绍基本使用、常用命令，以及如何接入 DeepSeek V4、使用 Superpowers 和 UI UX Pro Max 插件。

基本使用（VS Code）

安装与登录

1. 在 VS Code 扩展商店搜索 GitHub Copilot 并安装
2. 安装完成后点击左下角账户图标，登录 GitHub 账号
3. 如需付费，在 GitHub Copilot 设置 中开通订阅

三种工作模式

Copilot Chat 支持三种模式，点击聊天框下方的模式切换按钮：

内联代码补全

在编辑器中编写代码时，Copilot 会自动以灰色文字提供补全建议：

• Tab — 接受建议
• Esc — 拒绝建议
• Ctrl + Enter — 查看多个备选建议（在新面板中展示）
• Alt + ] / Alt + [ — 在多个建议之间切换

1
2
3
4
5

// 写一个函数签名，Copilot 自动补全函数体
function calculateTotal(items) {
  // Copilot 自动补全 ↓
  return items.reduce((sum, item) => sum + item.price * item.qty, 0);
}

Copilot Chat 聊天

快捷键：

文件引用：在聊天中输入 # 可以引用当前打开的文件、选中代码、工作区文件，让 Copilot 获取精准上下文。

1

#file:src/auth.ts 解释这个文件中的认证流程

选中代码后右键，可快速执行：

• Copilot > Explain This（解释代码）
• Copilot > Fix This（修复问题）
• Copilot > Generate Tests（生成测试）
• Copilot > Generate Docs（生成文档）

常用命令

Chat 中的斜杠命令

Agent 模式专用命令

CLI 命令（终端使用）

在终端中安装 Copilot CLI：

1
2
3
4
5

# 使用 PowerShell（Windows）
winget install GitHub.Copilot.CLI

# 或使用 npm
npm install -g @github/copilot-cli

启动后可直接在终端对话：

1

copilot

1

copilot> 帮我写一个读取 CSV 并计算平均值的 Python 脚本

CLI 模式下的常用命令：

接入 DeepSeek V4

根据 DeepSeek 官方文档，有两种接入方式：通过 VS Code 插件直接集成，或通过 Copilot CLI 配置环境变量。Free 订阅即可使用，无需 Pro+。

方式一：VS Code 插件（推荐，零门槛）

安装 DeepSeek V4 for Copilot Chat 插件，将 DeepSeek V4 Pro / Flash 直接添加到 Copilot 的模型选择器中。无需替换 Copilot，Agent 模式、工具调用、Skills、MCP 全部保留。

步骤 1：安装插件

• 需 VS Code 1.116 或更高版本
• 确保已安装 GitHub Copilot 并登录（Free / Pro / Enterprise 均可）
• 从 VS Code Marketplace 安装插件（搜索 deepseek-v4-for-copilot）

步骤 2：获取 DeepSeek API Key

前往 DeepSeek 开放平台 创建 API Key（以 sk- 开头）。

步骤 3：配置 API Key

打开 VS Code 命令面板（Ctrl+Shift+P），执行 DeepSeek: Set API Key，粘贴 Key。Key 安全存储在操作系统密钥链中。

步骤 4：选择模型并开始使用

打开 Copilot Chat（Ctrl+Shift+I），点击模型选择器，选择 DeepSeek V4 Pro 或 DeepSeek V4 Flash。即可正常使用，Agent 模式、工具调用等功能全部由 DeepSeek 驱动。

可选：配置思考深度

在模型选择器中点击 DeepSeek 模型旁的齿轮图标：

可选：配置视觉代理模型

执行命令 DeepSeek: Set Vision Proxy Model，选择用于图片描述的 Copilot 模型。将截图拖入聊天框后，插件会自动描述图片内容再发送给 DeepSeek。

方式二：Copilot CLI（命令终端）

通过 BYOK 模式在终端中使用 DeepSeek。关键：必须使用 anthropic 提供者类型（而非 openai）。

步骤 1：安装 Copilot CLI

1

npm install -g @github/copilot

需要 Node.js 22 或更高版本。

步骤 2：获取 API Key

同上，前往 DeepSeek 开放平台 创建。

步骤 3：配置环境变量（PowerShell）

1
2
3
4
5
6
7
8
9

# 核心三项（必须）
$env:COPILOT_PROVIDER_TYPE        = "anthropic"
$env:COPILOT_PROVIDER_BASE_URL    = "https://api.deepseek.com/anthropic"
$env:COPILOT_PROVIDER_API_KEY     = "sk-你的DeepSeek_API_Key"
$env:COPILOT_MODEL                = "deepseek-v4-pro"

# Token 限制（推荐配置）
$env:COPILOT_PROVIDER_MAX_PROMPT_TOKENS  = "840000"
$env:COPILOT_PROVIDER_MAX_OUTPUT_TOKENS  = "128000"

永久设置（推荐）：

1
2
3
4
5
6

[Environment]::SetEnvironmentVariable("COPILOT_PROVIDER_TYPE", "anthropic", "User")
[Environment]::SetEnvironmentVariable("COPILOT_PROVIDER_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("COPILOT_PROVIDER_API_KEY", "sk-你的API_Key", "User")
[Environment]::SetEnvironmentVariable("COPILOT_MODEL", "deepseek-v4-pro", "User")
[Environment]::SetEnvironmentVariable("COPILOT_PROVIDER_MAX_PROMPT_TOKENS", "840000", "User")
[Environment]::SetEnvironmentVariable("COPILOT_PROVIDER_MAX_OUTPUT_TOKENS", "128000", "User")

由于 deepseek-v4-pro 不在 Copilot CLI 的内置模型目录中，需要显式配置 token 限制，否则可能因上下文超限出错。

步骤 4：启动

1

copilot

Agent 模式、工具调用、MCP 全部由 DeepSeek 驱动。

可选：离线模式

阻止 Copilot CLI 连接 GitHub 服务器（提示词仍发送到 DeepSeek）：

1

$env:COPILOT_OFFLINE = "true"

切换模型：修改 COPILOT_MODEL 为 deepseek-v4-flash 即可切换到 Flash 模型。运行 copilot help providers 可查看所有可用环境变量。

使用 Superpowers

Superpowers 是一套 204K+ Star 的 AI 代理开发方法论，已在 Copilot CLI 上原生支持。

安装

Copilot CLI：

1
2

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

安装后，Superpowers 的 15+ 个 Skills 会自动注册到 Copilot 的工作流中，无需手动激活。

Superpowers 工作流

flowchart TD
    S1["1. brainstorming<br/>苏格拉底式提问，细化需求"] --> S2
    S2["2. using-git-worktrees<br/>创建隔离的 Git worktree"] --> S3
    S3["3. writing-plans<br/>拆分为 2-5 分钟的小任务"] --> S4
    S4["4. subagent-driven-development<br/>子 Agent 逐个执行 + 审查"] --> S5
    S5["5. test-driven-development<br/>严格执行 RED-GREEN-REFACTOR"] --> S6
    S6["6. requesting-code-review<br/>按严重级别报告问题"] --> S7
    S7["7. finishing-a-development-branch<br/>验证测试 → 合并 / PR / 清理"]

实际使用

安装 Superpowers 后，在使用 Copilot CLI 时会自动触发。例如：

1

copilot> 帮我给这个项目添加用户认证功能

Copilot 不会直接写代码，而是先进行 brainstorming：

• 询问你想要的认证方式（JWT？Session？OAuth？）
• 确认技术栈和约束条件
• 展示设计方案供你确认

然后自动创建 Git worktree，编写详细实施计划，再逐任务执行。整个过程无需手动调用 Skill，全自动流转。

使用 UI UX Pro Max

UI UX Pro Max 是一个 82K+ Star 的 UI/UX 设计智能 Skill，提供 161 条推理规则、67 种 UI 风格、161 套配色方案。

安装

通过 CLI 工具一键安装：

1
2
3

npm install -g uipro-cli
cd /path/to/project
uipro init --ai copilot

安装完成后，当你在对话中提出 UI/UX 相关请求时，Skill 会自动激活。也可以使用斜杠命令显式调用：

1

/ui-ux-pro-max 为我的 SaaS 产品设计一个落地页

实际使用

flowchart TD
    A["用户请求"] --> B["并行搜索<br/>产品类型 · 风格 · 颜色 · 布局 · 字体"]
    B --> C["推理引擎<br/>输出完整设计系统"]
    C --> D["代码生成 + 预交付检查"]

示例对话：

1

copilot> 帮我做一个医疗健康数据分析仪表盘，要暗色主题

Copilot 结合 UI UX Pro Max 会自动：

1. 分析”医疗健康仪表盘”的产品类型
2. 推荐合适的 UI 风格（数据密集型仪表盘风格）
3. 生成配色方案（暗色主题 + 医疗行业配色）
4. 输出可直接运行的代码（React + Tailwind / HTML 等）

技术栈支持

UI UX Pro Max 支持 15 种技术栈，在提示词中指定即可：

1

/ui-ux-pro-max 用 React + Tailwind 做一个暗色金融仪表盘

最佳实践

提供充足的上下文

1
2

#file:src/components/UserList.tsx
参考这个组件的写法，帮我创建一个类似的 ProductList 组件

用 @ 引用工作区文件

在聊天中 @ + 模糊搜索文件名，让 Copilot 精确理解你的代码：

1

@UserService.ts 修改 getUserById 方法，添加缓存逻辑

善用 Agent 模式做复杂任务

1
2

切换到 Agent 模式：
帮我把项目中所有的 console.log 替换成统一的 logger 调用，然后生成一个 commit

Agent 模式会自主：搜索文件 → 替换代码 → 运行测试 → 提交 commit。

自定义指令

在 VS Code 中配置 .github/copilot-instructions.md 或设置面板中的 “Custom Instructions”，让 Copilot 遵循项目约定：

1
2
3
4
5
6
7

# copilot-instructions.md

- 使用 TypeScript 严格模式
- 所有函数必须有 JSDoc 注释
- 组件使用函数式写法，不要 class component
- 样式用 Tailwind CSS，不要单独 CSS 文件
- 测试用 Vitest，文件命名 \*.test.ts

Copilot Memory

Copilot 支持跨会话记忆：

• 用户级别偏好：记住你的代码风格、常用技术栈
• 仓库级别事实：记住项目架构、关键约定

可在 GitHub Settings > Copilot 中管理记忆内容。

与其他 AI 助手对比

参考链接

• GitHub Copilot 官方文档
• VS Code Copilot 指南
• Copilot CLI
• Copilot 支持的 AI 模型
• DeepSeek 开放平台
• Superpowers
• UI UX Pro Max