一、安装准备
1.1 系统要求
在安装 GitHub Copilot 之前,请确保您的系统满足以下要求:
- Visual Studio Code:最新版本(建议使用 1.78.0 或更高版本)
- 操作系统:Windows 10+/macOS 10.15+/Linux
- GitHub 账户:有效的 GitHub 账户
- GitHub Copilot 订阅:免费计划或付费订阅
1.2 Copilot 订阅选择
GitHub Copilot 目前提供以下几种订阅计划:
| 计划 | 价格 | 功能限制 | 适合人群 |
|---|
| Copilot Free | 免费 | 每月 2000 次代码完成,50 次聊天请求 | 初学者、学生、轻度使用者 |
| Copilot Pro | $10/月或$100/年 | 无限制代码完成和聊天功能 | 个人开发者、自由职业者 |
| Copilot Business | $19/用户/月 | 组织级管理、安全功能、IP 保护 | 小型团队和中型企业 |
| Copilot Enterprise | 企业定价 | 定制化功能、私有模型训练、高级安全 | 大型企业组织 |
1.3 获取访问权限
如果您是首次使用:
- 访问 GitHub Copilot 主页
- 点击"Get started for free"注册免费计划,或选择其他订阅
- 使用 GitHub 账号登录并完成订阅流程
- 学生、教师和开源项目维护者可以申请免费访问 Copilot Pro
二、安装步骤
2.1 安装 GitHub Copilot 基础扩展
- 打开 VSCode
- 点击左侧活动栏中的扩展图标 (⇧⌘X / Ctrl+Shift+X)
- 在搜索框中输入"GitHub Copilot"
- 找到官方的 GitHub Copilot 扩展并点击"安装"
扩展 ID: GitHub.copilot 发布者:GitHub
2.2 安装 GitHub Copilot Chat 扩展
- 在扩展搜索框中输入"GitHub Copilot Chat"
- 找到官方的 GitHub Copilot Chat 扩展并点击"安装"
扩展 ID: GitHub.copilot-chat 发布者:GitHub
2.3 登录和授权
- 安装完成后,VSCode 右下角会显示通知,点击"Sign in"
- 也可以点击状态栏中的 Copilot 图标进行登录
- 浏览器会打开 GitHub 授权页面
- 使用您的 GitHub 账户登录
- 接受必要的权限请求
- 完成授权后回到 VSCode
- 成功后,状态栏中会显示 Copilot 图标且不再有感叹号
三、基本使用:代码自动完成
3.1 内联代码建议
安装并授权成功后,Copilot 会自动开始工作:
- 创建或打开任何代码文件
- 开始编写代码,Copilot 会以灰色文本形式显示建议
- 按 Tab 键接受建议,按 Esc 键拒绝建议
- 继续输入将获得新的建议
public void QuickSort(int[] array, int left, int right)
{
}
3.2 自定义 Copilot 配置
可以通过 VSCode 设置调整 Copilot 的行为:
- 打开设置 (⌘, / Ctrl+,)
- 搜索"copilot"
- 常用设置包括:
- 启用/禁用 Copilot
- 指定启用 Copilot 的语言
- 调整内联建议行为
- 配置 Tab 键行为
{
"github.copilot.enable": {
"*": true,
"plaintext": false,
"markdown": true,
"javascript": true
},
"editor.inlineSuggest.enabled": true,
"github.copilot.editor.enableAutoCompletions": true
}
3.3 使用注释引导 Copilot
Copilot 对注释非常敏感,可以通过精心编写的注释来引导它生成您期望的代码:
public int Fibonacci(int n)
{
}
四、使用 Copilot Chat
4.1 启动聊天会话
Copilot Chat 提供三种交互方式:
- 聊天视图:
- 点击左侧活动栏中的 Copilot 图标
- 或使用快捷键 ⌃⌘I (Windows/Linux: Ctrl+Alt+I)
- 内联聊天:
- 在代码编辑器中按 ⌘I (Windows/Linux: Ctrl+I)
- 此方式专注于当前代码上下文
- 快速聊天:
- 使用快捷键 ⇧⌥⌘L (Windows/Linux: Ctrl+Shift+Alt+L)
- 或运行命令"Chat: Open Quick Chat"
4.2 常见 Chat 命令和技巧
Chat 中可以使用各种斜杠命令增强交互:
| 命令 | 功能 | 示例 |
|---|
/help | 显示所有可用命令 | /help |
/explain | 解释选中的代码 | /explain 为什么这段代码会导致内存泄漏? |
/tests | 生成测试代码 | /tests 为这个函数生成单元测试 |
/fix | 修复代码问题 | /fix 修复这段代码中的 bug |
/optimize | 优化代码性能 | /optimize 这段代码如何优化性能? |
/vscode | 关于 VSCode 的帮助 | /vscode 如何配置调试器? |
/terminal | 终端相关帮助 | /terminal 如何在 Windows 上运行 Linux 命令? |
4.3 聊天模式
GitHub Copilot Chat 提供三种主要的聊天模式:
- Ask 模式:用于一般性问题解答和代码解释
- Edit 模式:专注于多文件代码编辑和重构
- Agent 模式:可以自主完成复杂编码任务
选择合适的模式可以大大提高工作效率:
# 使用 Agent 模式的示例提示
创建一个 React 网站,包含主页和关于页面,使用 React Router 处理路由,
添加一个导航栏,并使用 Tailwind CSS 进行样式设计。添加适当的测试。
五、高级使用技巧
5.1 多文件编辑
使用 Edit 模式进行跨文件修改:
- 打开 Chat 视图并选择"Edit"模式
- 点击"Add Context"添加相关文件作为上下文
- 描述您希望进行的更改
- 查看并确认 Copilot 建议的变更
5.2 代理模式实战
Agent 模式是 Copilot 最强大的功能之一:
- 在 Chat 视图中选择"Agent"模式
- Copilot 会自动规划、编写代码、运行测试,遇到问题时会自动调整
描述完整的开发任务,例如:
5.3 定制化 Copilot 响应
使用自定义指令让 Copilot 更符合您的编码风格:
- 打开设置
- 搜索"copilot.chat.customInstructions"
添加您的自定义指令,例如:
我喜欢简洁但有完整注释的代码。请使用 CQRS 架构模式。
我的代码风格遵循 C# 编码规范,使用 PascalCase 命名类和方法,
使用 camelCase 命名变量。尽可能使用最新的 C# 功能如记录类型和 nullable 引用类型。
六、常见问题解决
6.1 Copilot 无法提供建议
如果 Copilot 没有显示代码建议,请尝试以下解决方案:
- 检查网络连接:Copilot 需要稳定的互联网连接
- 验证登录状态:确保已成功登录 GitHub 账户
- 检查订阅:确认您的 Copilot 订阅有效
- 重启 VSCode:完全关闭并重新启动 VSCode
- 重新安装扩展:卸载并重新安装 Copilot 扩展
6.2 提高建议质量
获取更好的 Copilot 建议:
- 提供更多上下文:编写详细的注释或函数签名
- 使用适当的代码风格:Copilot 会尝试匹配您的编码风格
- 编写清晰的提示:明确表达您的意图
- 利用多行注释:复杂任务使用多行注释来指导 Copilot
public class ImageProcessor
{
}
七、Copilot 最佳实践
7.1 安全最佳实践
使用 Copilot 时注意以下安全事项:
- 审查生成的代码:不要盲目接受所有建议
- 注意敏感信息:不要在注释中包含 API 密钥等敏感信息
- 安全审查:对关键功能使用安全扫描工具
- 启用代码重复过滤:在设置中启用 Copilot 的代码重复检测
7.2 提高工作效率的技巧
- 启用 Next Edit Suggestions:提前预测您可能需要的编辑
- 利用内联聊天:快速修改或重构当前代码
- 创建定制化提示模板:为常见任务创建标准提示
- 结合 Git 使用:利用 Copilot 帮助编写提交消息
- 使用 Copilot 解释陌生代码:快速理解新接手的项目
八、未来展望
随着微软宣布 GitHub Copilot Chat 扩展开源,我们可以期待:
- 社区贡献:更多创新功能和改进
- 与 VSCode 更深度整合:AI 功能将成为编辑器核心
- 更多模型选择:支持更多 AI 语言模型
- 领域特定优化:针对不同编程领域的专业化功能
- 更强大的 Agent 能力:能够处理更复杂的开发任务
相关资源
常见快捷键总结
| 功能 | Windows/Linux | macOS |
|---|
| 接受 Copilot 建议 | Tab | Tab |
| 拒绝 Copilot 建议 | Esc | Esc |
| 显示内联建议 | Alt+] | Option+] |
| 打开聊天视图 | Ctrl+Alt+I | ⌃⌘I |
| 打开内联聊天 | Ctrl+I | ⌘I |
| 打开快速聊天 | Ctrl+Shift+Alt+L | ⇧⌥⌘L |
| 查看下一个建议 | Alt+] | ⌥] |
| 查看上一个建议 | Alt+[ | ⌥[ |
| 触发建议 | Alt+\ | ⌥\ |