copilot使用工作流

GitHub Copilot 在 VS Code 中的配置与使用工作流

#tech / ai #resource / copilot #type / howto #status / growing

Copilot 使用工作流

目标

掌握 GitHub Copilot 在 VS Code 中的安装、配置和日常使用，提高编码效率。

基础设置

安装

在 VS Code 扩展商店搜索 GitHub Copilot 和 GitHub Copilot Chat，分别安装
登录 GitHub 账号并确认 Copilot 订阅（个人版 / Pro / Business / Enterprise）
安装后状态栏右下角出现 Copilot 图标表示就绪

状态确认

点击状态栏 Copilot 图标，确认显示 “Ready”
若显示 “Not Signed In”，点击图标完成 GitHub 授权

内联建议（Inline Suggestions）

基本用法

代码补全：正常输入代码，Copilot 会以灰色文字显示建议，按 Tab 接受
逐字接受：按 Ctrl+→ 逐词接受建议（Windows/Linux）
拒绝建议：按 Esc 或继续输入忽略建议
触发建议：按 Alt+\ 手动触发 Copilot 建议

提高建议质量的技巧

写清晰的函数名和注释：函数名和注释是 Copilot 理解意图的关键信号

// 计算两个日期之间的天数差
function calculateDaysBetween(startDate: Date, endDate: Date): number {

定义明确的类型签名：TypeScript 类型能显著提升建议准确度
写好开头几行：Copilot 会根据已输入的代码模式推断后续内容
保持文件整洁：当前文件的代码上下文是 Copilot 生成建议的主要依据

Chat 面板

打开方式

Ctrl+Shift+I：打开快速聊天
侧边栏点击 Chat 图标：打开完整聊天面板
Ctrl+I：在编辑器中打开内联聊天（Inline Chat）

常用命令

命令	说明
`/explain`	解释选中的代码
`/fix`	修复选中代码中的问题
`/tests`	为选中代码生成测试
`/doc`	为选中代码生成文档注释
`/refactor`	重构选中代码

@workspace 上下文

@workspace 是 Copilot Chat 的工作区上下文引用，让它能理解整个项目的结构：

@workspace 解释这个项目的架构 — 分析项目整体结构
@workspace 哪个文件处理用户认证 — 跨文件搜索
@workspace 我该如何添加一个新的 API 路由 — 基于项目模式给出建议

其他上下文引用：

@file — 引用特定文件
@selection — 引用当前选中内容
@terminal — 引用终端输出

Prompt 工程技巧

提供上下文：先打开相关文件，或用 @file 引用
分步骤描述：复杂任务拆分为多步，逐步让 Copilot 完成
给出示例：如果已有类似代码，让 Copilot 参照现有模式
约束输出格式：明确要求 “用 TypeScript”、“遵循项目 ESLint 规范” 等
迭代优化：不满意就用 /fix 或补充说明让 Copilot 修改

常见使用场景

场景	方法
写样板代码	输入函数签名 + 注释，让 Copilot 补全
写单元测试	选中函数 → `/tests`
理解陌生代码	选中代码 → `/explain`
修 Bug	选中报错代码 → `/fix`，附上错误信息
写正则表达式	用注释描述匹配规则，Copilot 生成正则
API 调用	描述目标 API，Copilot 生成请求代码

局限性

不保证正确性：生成的代码必须人工审查，可能有逻辑错误或安全漏洞
上下文窗口有限：对超大文件或跨多个文件的复杂逻辑理解有限
不了解私有 API：对内部框架、私有库的支持依赖当前文件的 import 和注释
可能生成过时代码：训练数据有截止日期，可能使用已废弃的 API
不适合替代架构决策：适合实现细节，不适合高层设计