VSCode GitHub Copilot 安装与实战指南

2.3 登录和授权

安装完成后，状态栏会提示登录：

1. 点击右下角通知或状态栏图标
2. 浏览器将跳转至 GitHub 授权页
3. 确认权限并接受
4. 返回 VSCode，状态栏显示绿色图标即表示成功

三、基本使用：代码自动完成

3.1 内联代码建议

Copilot 会在您输入时以灰色文本提供建议：

• 按 Tab 键接受建议
• 按 Esc 键拒绝
• 继续输入可刷新建议

例如编写排序函数时：

// 示例：开始编写一个排序函数
public void QuickSort(int[] array, int left, int right) {
    // Copilot 将自动建议完整的快速排序实现
}

3.2 自定义配置

通过设置调整行为，如启用特定语言或修改 Tab 键逻辑：

{
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": true,
    "javascript": true
  },
  "editor.inlineSuggest.enabled": true,
  "github.copilot.editor.enableAutoCompletions": true
}

3.3 注释引导生成

清晰的注释能显著提升生成质量：

// 创建一个递归函数，计算斐波那契数列的第 n 个数
// 要求：使用记忆化技术优化性能
// 参数：n - 要计算的位置（从 0 开始）
// 返回：斐波那契数列第 n 个数的值
public int Fibonacci(int n) {
    // Copilot 会根据注释生成带记忆化的实现
}

四、使用 Copilot Chat

4.1 启动聊天会话

支持三种交互方式：

1. 聊天视图：左侧活动栏图标或快捷键 Ctrl+Alt+I
2. 内联聊天：编辑器中按 Ctrl+I，聚焦当前上下文
3. 快速聊天：快捷键 Ctrl+Shift+Alt+L

4.2 常用命令

Chat 支持斜杠命令增强交互：

4.3 聊天模式

• Ask 模式：一般问题解答
• Edit 模式：多文件编辑重构
• Agent 模式：自主完成复杂任务

Agent 模式示例提示：

创建一个 React 网站，包含主页和关于页面，使用 React Router 处理路由，
添加导航栏并使用 Tailwind CSS 设计样式，添加适当测试。

五、高级使用技巧

5.1 多文件编辑

在 Edit 模式下，点击 "Add Context" 添加相关文件作为上下文，描述变更需求后查看建议。

5.2 代理模式实战

Agent 模式可自动规划、编写、测试。完整任务描述示例：

创建一个 C# 控制台应用，从 CSV 读取数据，处理后保存到 SQLite 数据库，
提供命令行参数支持，添加错误处理和日志记录，遵循 SOLID 原则。

5.3 定制化响应

通过自定义指令规范输出风格：

1. 设置搜索 copilot.chat.customInstructions
2. 添加偏好，例如：

我喜欢简洁但有完整注释的代码。请使用 CQRS 架构模式。
我的代码风格遵循 C# 编码规范，使用 PascalCase 命名类和方法，
使用 camelCase 命名变量。尽可能使用最新的 C# 功能。

六、常见问题解决

6.1 无法提供建议

若未显示建议，尝试以下步骤：

1. 检查网络连接稳定性
2. 验证 GitHub 登录状态
3. 确认订阅有效
4. 重启 VSCode
5. 重新安装扩展

6.2 提高建议质量

• 提供更多上下文（详细注释或函数签名）
• 保持编码风格一致
• 明确表达意图
• 利用多行注释指导复杂任务

/*
 * 实现一个图片处理类，需要支持以下功能：
 * 1. 加载本地图片文件
 * 2. 应用各种滤镜（灰度、模糊、锐化等）
 * 3. 调整图片大小，支持保持原始比例
 * 4. 保存处理后的图片到不同格式
 * 5. 异步处理大型图片
 */
public class ImageProcessor {
    // Copilot 将根据上面的详细要求生成代码
}

七、最佳实践

7.1 安全注意事项

• 审查生成的代码，勿盲目接受
• 避免在注释中包含 API 密钥等敏感信息
• 关键功能配合安全扫描工具
• 启用代码重复检测

7.2 效率提升技巧

• 启用 Next Edit Suggestions 预测后续编辑
• 利用内联聊天快速重构
• 创建常用提示模板
• 结合 Git 编写提交消息
• 使用 Copilot 解释陌生代码

八、参考文档

• GitHub Copilot 官方文档
• VS Code 中的 Copilot 入门指南
• Copilot 编程技巧与模式
• VSCode 快捷键备忘单

常见快捷键总结