在你的 IDE 中使用 GitHub Copilot Chat

先决条件

• 访问 GitHub Copilot。请参阅“关于 GitHub Copilot”。

• 最新版本的 Visual Studio Code。请参阅 Visual Studio Code 下载页面。
• GitHub Copilot 扩展 - 从 Visual Studio Marketplace 安装此扩展。有关更多信息，请参阅 Microsoft 文档中的“在 Visual Studio Code 中设置 GitHub Copilot”。
• 在 Visual Studio Code 中登录到 GitHub。如果您遇到身份验证问题，请参阅“在 IDE 中排查 GitHub Copilot Chat 问题”。

如果您通过组织访问 GitHub Copilot，而您的组织所有者已禁用聊天功能，则您将无法使用 GitHub Copilot Chat。请参阅“管理组织中的 Copilot 政策和功能”。

提交提示

您可以要求 Copilot Chat 提供代码建议、解释代码、生成单元测试以及建议代码修复。

1. 通过单击活动栏中的聊天图标或输入 Control+Command+i (Mac)/Ctrl+Alt+i (Windows/Linux) 来打开聊天视图。

   

   提示

   有关其他访问 Copilot Chat 的方式（包括与代码内联），请参阅下文的 其他访问 Copilot Chat 的方式。

2. 在提示框中输入提示，或单击其中一个建议的提示。有关示例提示，请参阅下文的“示例提示”。

3. 评估副驾驶的响应，并在需要时提出后续请求。

   响应可能包含文本、代码块、按钮、图像、URI 和文件树。响应通常包含交互式元素。例如，响应可能包含一个菜单来插入代码块，或一个按钮来调用 Visual Studio Code 命令。

在提示中使用关键字

你可以使用特殊关键字来帮助副驾驶理解你的提示。

聊天参与者

使用聊天参与者将你的提示限定到特定域。要使用聊天参与者，请在聊天提示框中键入 @，后跟聊天参与者名称。聊天参与者包括

• @workspace：了解工作区中代码的上下文。当你希望副驾驶考虑项目的结构、代码的不同部分如何交互，或项目中的设计模式时，请使用 @workspace。请参阅“询问有关你的项目的问题”。
• @vscode：了解 Visual Studio Code 命令和功能的上下文。当你希望获得 Visual Studio Code 的帮助时，请使用 @vscode。请参阅“询问有关 Visual Studio Code 的问题”。
• @terminal：了解 Visual Studio Code 终端外壳及其内容的上下文。当你希望获得创建或调试终端命令的帮助时，请使用 @terminal。请参阅“询问有关命令行的问题”。

要查看所有可用的聊天参与者，请在聊天提示框中键入 @。另请参阅 Visual Studio Code 文档中的聊天参与者。

斜杠命令

使用斜杠命令来避免为常见场景编写复杂的提示。要使用斜杠命令，请在聊天提示框中键入 /，后跟一个命令。斜杠命令包括

• /tests：为选定的代码生成单元测试
• /fix：针对选定代码中的问题提出修复建议
• /explain：解释选定的代码
• /clear：开始新的聊天

要查看所有可用的斜杠命令，请在聊天提示框中键入 /。另请参阅 Visual Studio Code 文档中的 斜杠命令。

聊天变量

使用聊天变量在提示中包含特定上下文。要使用聊天变量，请在聊天提示框中键入 #，后跟聊天变量。聊天变量包括

• #file：在聊天中将特定文件作为上下文包含在内。
• #git：包含有关当前 Git 存储库的信息。
• #terminalLastCommand：包含活动 Visual Studio Code 终端中最后运行的命令。

要查看所有可用的聊天变量，请在聊天提示框中键入 #。另请参阅 Visual Studio Code 文档中的 聊天变量。

示例提示

您可以向 Copilot Chat 询问有关您的项目或一般软件的具体问题。您还可以要求 Copilot Chat 编写代码、修复错误、编写测试和记录代码。

询问一般软件问题

您可以向 Copilot Chat 询问一般软件问题。例如

• 告诉我有关 nodejs Web 服务器框架的信息
• 如何创建 express 应用程序
• @terminal 如何更新 npm 包（使用 @terminal 聊天参与者）

询问有关您的项目的问题

您可以向 Copilot Chat 询问有关您的项目的问题。

• 此函数使用什么排序算法
• @workspace 如何安排通知
• #file:gameReducer.js #file:gameInit.js 这些文件如何关联

为了给 Copilot 提供正确的上下文，请尝试以下一些策略

• 突出显示相关的代码行
• 使用聊天变量，如 #selection、#file、#editor、#codebase 或 #git
• 使用 @workspace 聊天参与者

编写代码

您可以要求 Copilot 为您编写代码。例如

• 编写一个函数来对列表中的所有数字求和
• 为该函数添加错误处理
• @workspace 添加表单验证，类似于时事通讯页面

当 Copilot 返回代码块时，响应包括复制代码或将代码插入光标、新文件或终端的选项。

设置新项目

使用 /new 斜杠命令设置新项目。例如

• /new 带有 typescript 的 react 应用
• /new python django web 应用程序
• /new node.js express 服务器

Copilot 将建议目录结构并提供一个按钮来创建建议的文件和内容。要预览建议的文件，请在建议的目录结构中选择文件名。

使用 /newNotebook 斜杠命令设置新的 Jupyter 笔记本。例如

• /newNotebook 检索泰坦尼克号数据集并使用 Seaborn 绘制数据

修复、改进和重构代码

如果你的活动文件包含错误，请使用 /fix 斜杠命令要求 Copilot 修复错误。

你还可以提出一般请求来改进或重构代码。

• 你将如何改进此代码？
• 将此代码翻译成 C#
• 为该函数添加错误处理

编写测试

使用 /tests 斜杠命令要求 Copilot 为活动文件或选定的代码编写测试。例如

• /tests
• /tests 使用 Jest 框架
• /tests 确保该函数拒绝空列表

/tests 斜杠命令为现有代码编写测试。如果你希望在编写代码之前编写测试（测试驱动开发），请省略 /tests 命令。例如

• 为应该对整数列表求和的 JavaScript 函数添加测试

询问有关 Visual Studio Code 的问题

使用 @vscode 聊天参与者询问有关 Visual Studio Code 的具体问题。例如

• @vscode 告诉我如何调试 node.js 应用
• @vscode 我如何更改 Visual Studio Code 颜色
• @vscode 我如何更改键绑定

询问有关命令行的问题

使用 @terminal 聊天参与者询问有关命令行的具体问题。例如

• @terminal 查找 src 目录中的最大文件
• @terminal #terminalLastCommand 解释上一个命令和任何错误

访问 Copilot Chat 的其他方式

除了通过聊天视图提交提示之外，你还可以通过其他方式提交提示

• 内联：要在编辑器或集成终端中直接开始内联聊天，请输入 Command+i（Mac）/ Ctrl+i（Windows/Linux）。
• 快速聊天：要打开快速聊天下拉菜单，请输入 Shift+Command+i（Mac）/ Shift+Ctrl+i（Windows/Linux）
• 智能操作：要通过上下文菜单提交提示，请在编辑器中右键单击，在出现的菜单中选择Copilot，然后选择其中一项操作。当选择一行代码时，有时也会通过闪光图标访问智能操作。

有关更多详细信息，请参阅 Visual Studio Code 文档中的内联聊天、快速聊天和聊天智能操作。

分享反馈

要指示响应是否有用，请使用响应旁边显示的竖起大拇指和竖起大拇指图标。

要对 GitHub Copilot Chat 扩展提供反馈，请在 microsoft/vscode-copilot-release 存储库中打开一个问题。

进一步阅读

• Visual Studio Code 文档中的在 VS Code 中使用 Copilot Chat和在 VS Code 中开始使用 GitHub Copilot Chat

• "关于 IDE 中的 GitHub Copilot Chat"

• "GitHub 附加产品和功能条款"

• GitHub Copilot 常见问题解答