在 VS Code 中使用聊天功能
在 Visual Studio Code 中使用聊天功能，通过自然语言提问关于代码库的问题，或在整个项目中进行编辑。聊天功能可以在不同模式下运行，针对您的用例进行优化，从提问到进行多文件编辑或启动自主编码工作流。
当您需要执行以下操作时，可能会想在 VS Code 中使用聊天功能：
- 理解代码 - “解释一下这个身份验证中间件是如何工作的”
- 调试问题 - “为什么我在此循环中遇到空引用？”
- 获取代码建议 - “向我展示如何在 Python 中实现二叉搜索树”
- 优化性能 - “帮我提高此数据库查询的效率”
- 学习最佳实践 - “在异步函数中处理错误的推荐方法是什么？”
- 获取 VS Code 技巧 - “如何自定义键盘快捷键？”
先决条件
- 安装最新版本的 Visual Studio Code
- 访问 Copilot。Copilot 免费计划并获得每月补全和聊天交互的限制。
在 VS Code 中访问聊天功能
您可以在 VS Code 中以不同方式使用自然语言聊天，每种方式都针对特定的用例和任务进行了优化。
| 体验 | 用例 | 用户体验 |
|---|---|---|
| 聊天视图 ⌃⌘I (Windows、Linux 为 Ctrl+Alt+I) |
在侧边的专用视图中进行持续的多轮聊天对话。在不同的聊天模式之间切换，以提出问题、跨文件编辑代码或启动自主编码工作流。 |  |
| 内联聊天 ⌘I (Windows、Linux 为 Ctrl+I) |
直接从编辑器（编辑器内联聊天）或集成终端（终端内联聊天）启动聊天对话，以在原地获取建议。 |  |
| 快速聊天 ⇧⌥⌘L (Windows、Linux 为 Ctrl+Shift+Alt+L) |
快速提问一个问题，然后回到您正在做的事情中。 |  |
通过相应的键盘快捷键或 VS Code 标题栏中的 Copilot 菜单访问每种聊天体验。
选择聊天模式
聊天模式是预定义的配置，用于为特定任务（如提问、编辑代码或执行自主编码任务）自定义 VS Code 中的聊天功能。VS Code 附带三种内置聊天模式：提问 (Ask)、编辑 (Edit) 和代理 (Agent)。您还可以为特定场景定义自己的聊天模式，例如规划新功能或研究实现方案。
要切换聊天模式，请打开聊天视图（⌃⌘I (Windows、Linux 为 Ctrl+Alt+I)），然后从聊天模式下拉列表中选择所需的模式。
了解更多关于 VS Code 中的聊天模式。
更改语言模型
VS Code 提供多种内置语言模型供您选择。某些模型针对快速编码任务进行了优化，而其他模型则更适合较慢的规划和推理任务。使用聊天输入字段中的模型选择器来更改 Copilot 用于生成响应的模型。
您还可以从其他模型提供商处添加模型（预览版）并在聊天中使用它们。获取有关如何使用其他提供商的模型的更多详细信息。
可用模型的列表可能会根据您的 Copilot 订阅而有所不同，并可能随时间变化。有关可用语言模型的更多信息，请参阅 GitHub Copilot 文档。
提交聊天提示
在聊天输入框中输入自然语言提示，以在 VS Code 中发出聊天请求。根据聊天模式，您可以询问有关代码库的问题、获取代码建议或在项目中的多个文件之间进行代码编辑，并调用专门的工具。
聊天响应可能包含丰富内容的组合，例如 Markdown 文本、代码块、按钮、文件树等。
要获得更相关的响应或引用工作区中的特定文件或构件（例如测试失败或终端输出），请通过 #-提及相关上下文项来向您的聊天提示添加上下文。
通过 chat.math.enabled 设置（预览版）启用在聊天响应中渲染数学方程式。
添加聊天上下文
VS Code 会尝试根据您的自然语言提示来确定聊天请求的意图和范围。为了帮助获得更相关的响应，请在您的聊天提示中提供额外的上下文，例如文件、测试结果、终端输出等。
在聊天视图中使用“添加上下文”按钮或输入 #-提及来为您的聊天提示添加上下文。例如，输入 #codebase 进行完整的代码库搜索，或输入 #<文件 | 文件夹 | 符号> 来引用工作区中的特定文件、文件夹或符号。在聊天输入字段中输入 # 以查看上下文项列表。
如果您已安装提供工具的 MCP 服务器或扩展，您也可以通过在聊天提示中 #-提及这些工具来直接引用它们。例如：
summarize #fetch code.visualstudio.com/updates：使用fetch内置工具检索网页内容what is terminal suggest #githubRepo microsoft/code：使用githubRepo内置工具在 GitHub 仓库中执行代码搜索。
您还可以通过输入 # 后跟工具名称来直接在提示中引用代理模式工具。您可以在所有聊天模式（提问、编辑和代理模式）中执行此操作。例如，使用 #fetch 工具将网页内容添加为聊天提示的上下文，或使用 #githubRepo 在 GitHub 仓库中执行代码搜索。
获取有关向聊天提示添加上下文的更多详细信息。
提示示例
询问一般技术主题
“什么是链表？”“排名前 10 的流行 Web 框架”
理解代码库
“解释一下 #codebase 中的身份验证是如何工作的”“数据库连接字符串在哪里配置？ #codebase”“如何构建这个 #codebase？”“#getUser 在哪里被使用了？ #usages”
为您的应用添加新功能
“创建一个关于页面并将其包含在导航栏中 #codebase”“为更新地址信息添加一个新的 API 路由 #codebase”“添加一个登录按钮，并根据 #styles.css 进行样式设计”
修复工作区中的问题
“修复 #problems 中的问题”“修复失败的测试 #testFailure”
引用来自网络的内容
“如何在 React 18 中使用 'useState' hook？ #fetch https://18.reactjs.ac.cn/reference/react/useState#usage”“构建一个用于获取地址信息的 API 端点，使用来自 #githubRepo contoso/api-templates 的模板”
有关更多提示示例，请参阅 GitHub 文档中的Copilot Chat Cookbook。
在聊天输入字段中输入 /help 以获取有关 Copilot 以及如何与聊天交互的帮助。
视觉
聊天支持视觉功能，这意味着您可以将图像作为上下文附加到您的聊天提示中并询问相关问题。例如，附加一个代码块的截图并要求解释它，或者附加一个 UI 草图并要求代理模式实现它。
您可以将图像从 Web 浏览器拖放到聊天视图中，以将其添加为上下文。
聊天记录
当您在一次聊天会话中迭代并发送多个聊天提示时，VS Code 会使用聊天提示和响应的历史记录作为您当前聊天提示的上下文。这意味着您可以提出后续问题或澄清您之前的问题，而无需重复上下文。例如，您可以问“这个与...有什么不同？”、“现在添加一个测试用例”、“更详细地解释一下”等等。
您可以随时使用聊天视图中的“新聊天”（+）按钮（⌘N (Windows、Linux 为 Ctrl+N)）创建一个新的聊天会话。如果您想切换到不同的话题并避免之前的上下文和历史记录，这会很有用。
要查看聊天会话的历史记录，请选择聊天视图中的“显示聊天...”按钮，或通过命令面板中的“聊天: 显示聊天...”命令。选择一个历史记录条目以在聊天视图中打开该聊天会话并继续对话。
您可以使用命令面板中的“聊天: 导出聊天...”命令，将聊天会话的所有提示和响应导出到一个 JSON 文件中。
编辑之前的聊天请求（实验性）
编辑聊天请求的功能自 VS Code 1.102 版本起可用，目前是一项实验性功能。
您可以在当前聊天会话中编辑之前的聊天请求。如果您想优化提示或更正错误，这会很有用。编辑聊天请求相当于撤销该请求，然后用编辑后的提示提交一个新的请求。
当您编辑之前的聊天请求时，将执行以下步骤：
- 被编辑的请求以及所有后续的请求和响应都将从对话历史中移除。
- 由这些请求所做的任何编辑都将恢复到请求前的状态。
- 被编辑的请求将被添加到对话历史中，并提交给语言模型以获得新的响应。
您可以使用 chat.editRequests 设置来配置编辑之前的聊天请求：
inline：在聊天视图中选择请求，使其可就地编辑。使用 Escape 退出编辑模式。hover：将鼠标悬停在聊天请求上，然后选择编辑图标（铅笔）以使其可就地编辑。使用 Escape 退出编辑模式。input：将鼠标悬停在聊天请求上，然后选择编辑图标（铅笔）以在聊天输入字段中编辑该请求。none：禁用在聊天视图中编辑聊天请求。
使用检查点撤销聊天请求（预览版）
检查点功能自 VS Code 1.103 版本起可用，目前处于预览阶段。
聊天检查点提供了一种将工作区状态恢复到先前时间点的方法，当聊天交互导致跨多个文件的更改时尤其有用。
启用检查点后，VS Code 会在聊天交互的关键点自动创建文件快照，允许您在聊天请求所做的更改不符合预期或想尝试不同方法时，返回到一个已知的良好状态。
要启用检查点，请配置 chat.checkpoints.enabled 设置。
恢复检查点
当您恢复一个检查点时，VS Code 会将工作区恢复到该检查点时的状态。这意味着在该检查点之后对文件所做的所有更改都将被撤销。
要将您的工作区恢复到先前的检查点：
-
在聊天视图中，导航到聊天会话中先前的聊天请求。
-
将鼠标悬停在聊天请求上，然后选择“恢复检查点”。
-
确认您要恢复检查点并撤销该时间点之后所做的任何文件更改。
请注意，聊天请求将从对话历史中移除，并且工作区文件将恢复到检查点时的状态。
恢复后重做
恢复到先前的检查点后，您可以重做被撤销的更改。如果您不小心恢复到了一个检查点，这可能会很有用。
要在恢复检查点后重做更改，请在聊天视图中选择“重做”。
查看检查点中的文件更改
为了帮助您了解每个聊天请求的影响，并更容易地决定要恢复到哪个检查点，请启用 chat.checkpoints.showFileChanges 设置。这会显示在每个聊天请求结束时被修改的文件列表，以及每个文件中添加和删除的行数。
在编辑器标签页或单独窗口中打开聊天
您可以将聊天会话作为单独的编辑器标签页，甚至是一个单独的浮动窗口打开。此功能使您可以同时打开多个聊天会话。
在聊天视图中，选择右上角的 ... 图标，然后选择“在编辑器中打开聊天”或“在新窗口中打开聊天”。以下截图显示了在浮动窗口中运行的聊天视图：
默认情况下，聊天会话以紧凑模式打开，该模式会隐藏标题栏和其他 UI 元素。选择浮动窗口标题栏中的紧凑模式图标，可在紧凑模式和普通模式之间切换。
或者，启用“始终置顶”模式，以始终将聊天视图保持在其他窗口的顶部。
了解更多关于 VS Code 中的浮动窗口。
使用语音交互
借助 VS Code 中的语音控制功能（由 VS Code Speech 扩展提供），您可以使用语音发起聊天对话：
- 使用您的声音来口述您的聊天提示
- 使用“Hey Code”语音命令与 Copilot Chat 开始语音会话
- 通过使用“按住说话”模式来加速聊天的语音输入
了解更多关于如何在 VS Code 中使用语音交互。
聊天调试视图
聊天调试视图是一个专用视图，您可以在其中查看 AI 请求和响应的详细信息。对于每个聊天请求，您可以看到系统提示、用户提示以及发送给语言模型的上下文的详细信息。您可以查看语言模型的详细响应，以及作为聊天请求一部分调用的工具的响应。
要打开聊天调试视图，请从命令面板（⇧⌘P (Windows、Linux 为 Ctrl+Shift+P)）运行“Developer: Show Chat Debug View”命令。
从命令行启动聊天
您可以通过在 VS Code CLI 中使用 chat 子命令，直接从命令行启动聊天会话。这使您可以在当前工作目录中打开一个聊天会话，并附带您提供的提示。
例如，以下命令会为当前目录打开聊天，并提问“查找并修复所有未指定类型的变量”：
code chat Find and fix all untyped variables
chat 子命令具有以下命令行选项：
-m,--mode：用于聊天会话的聊天模式。可用选项：ask、edit、agent或自定义模式的标识符。默认为agent。-a,--add-file：将文件添加为聊天会话的上下文。--maximize：最大化聊天会话视图。-r,--reuse-window：使用最后一个活动窗口进行聊天会话。-n,--new-window：为聊天会话打开一个空窗口。
chat 子命令还支持通过在命令末尾传递 - 来从 stdin 管道输入。例如：
python app.py | code chat why does it fail -
隐私与透明度
为了给私有仓库启用更多的工作区搜索功能，我们需要额外的权限。如果我们检测到尚未获得这些权限，我们会在启动时请求。一旦授予，我们将安全地存储会话以备将来使用。
在 GitHub Copilot 信任中心了解更多关于安全性、隐私和透明度的信息。
常见问题
我该如何选择不同的聊天模式？
不同的聊天模式针对不同的用例进行了优化：
-
使用编辑器内联聊天直接在活动编辑器中提问或进行编辑。这对于进行代码更改或提出仅限于当前文件的问题非常有用。
-
使用提问模式来询问关于您的代码库或技术概念的问题。响应可能包含代码建议，您可以手动、逐个地应用到您的代码库中。更改不会自动应用到您的代码库。
-
使用编辑模式根据您的聊天提示直接在代码库中的多个文件之间应用编辑。您为您的提示提供相关的上下文和文件。
-
使用代理模式来启动一个自主编码工作流，AI 会自主确定相关的上下文和文件，并确定为完成请求需要执行哪些任务。然后它会独立迭代以达到期望的结果，并在此过程中修复出现的问题。代理模式可以调用扩展或 MCP 服务器中的工具来执行专门任务，例如运行终端命令、验证测试用例或访问 API。
其他资源
您可以在 GitHub Copilot 文档中阅读更多关于GitHub Copilot 以及如何在 VS Code 中使用它的信息。
或者查看 YouTube 上的 VS Code Copilot 系列，您可以在那里找到更多入门内容和针对特定编程语言的视频，学习如何将 Copilot 与 Python、C#、Java、PowerShell、C++ 等结合使用。