在 VS Code 中使用聊天功能

在 Visual Studio Code 中使用聊天功能，通过自然语言来询问有关您的代码库的问题或在整个项目中进行编辑。聊天功能可以在不同模式下运行，针对您的用例进行优化，从提问到进行多文件编辑或启动自主编码工作流。

为何在 VS Code 中使用聊天功能？

聊天功能使您能够与 AI 进行持续的对话。您可以提出后续问题并迭代您的请求。以下是您可以在 VS Code 中使用聊天功能的一些示例：

• 搭建新应用 - “创建一个使用 TypeScript 和 Tailwind CSS 的新 React 应用”
• 添加功能 - “添加一个登录页面，并根据 #styles.css 对其进行样式设置”
• 理解您的代码 - “解释这个身份验证中间件是如何工作的”
• 调试问题 - “为什么我在此循环中遇到了空引用？”
• 优化性能 - “帮我提高这个数据库查询的效率”
• 生成测试 - “为 calculateTotal 函数创建单元测试”

先决条件

• 您的计算机上已安装 VS Code。请从 Visual Studio Code 网站下载。

• 拥有 GitHub Copilot 的访问权限。请按照在 VS Code 中设置 GitHub Copilot的步骤操作。

  提示

  如果您没有 Copilot 订阅，可以直接在 VS Code 内注册免费使用 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 标题栏中的“聊天”菜单来访问每种聊天体验。

选择一种聊天模式

聊天模式是预定义的配置或角色，用于为特定任务（如规划、提问或执行自主编码任务）定制 VS Code 中的聊天功能。

要切换聊天模式，请打开聊天视图（⌃⌘I (Windows、Linux 为 Ctrl+Alt+I)），然后从聊天模式下拉列表中选择所需的模式。

VS Code 自带三种内置聊天模式：询问 (Ask)、编辑 (Edit) 和 代理 (Agent)。您可以为特定场景定义自己的聊天模式，例如规划新功能或研究实现方案。了解更多关于VS Code 中的聊天模式的信息。

更改语言模型

VS Code 提供了多种内置语言模型供选择。一些模型针对快速编码任务进行了优化，而另一些则更适合较慢的规划和推理任务。使用聊天输入字段中的模型选择器来更改 Copilot 用于生成响应的模型。

您还可以添加来自其他模型提供商的模型并在聊天中使用它们。获取有关如何使用其他提供商的模型的更多详细信息。

提交聊天提示

在聊天输入字段中输入自然语言提示，以在 VS Code 中发出聊天请求。根据您选择的聊天模式，您的提示将得到相应的处理。例如，在询问模式下，响应

聊天响应可能包含富内容的组合，例如 Markdown 文本、代码块、按钮、文件树等。

要获得更相关的响应或引用工作区中的特定文件或产物（例如测试失败或终端输出），请通过 #-提及相关上下文项来向您的聊天提示添加上下文。

添加聊天上下文

VS Code 会尝试根据您的自然语言提示来确定聊天请求的意图和范围。为了帮助获得更相关的响应，请在您的聊天提示中提供额外的上下文，例如文件、测试结果、终端输出等。

使用聊天视图中的 添加上下文 按钮或输入 #-提及来为您的聊天提示添加上下文。例如，输入 #codebase 来执行完整的代码库搜索，或输入 #<文件|文件夹|符号> 来引用工作区中的特定文件、文件夹或符号。在聊天输入字段中输入 # 以查看上下文项列表。

如果您安装了提供工具的 MCP 服务器或扩展，您也可以通过在聊天提示中 #-提及这些工具来直接引用它们。例如：

• summarize #fetch code.visualstudio.com/updates：使用 fetch 内置工具检索网页内容
• what is terminal suggest #githubRepo microsoft/code：使用 githubRepo 内置工具在 GitHub 仓库中执行代码搜索。

您还可以通过输入 # 后跟工具名称来直接在提示中引用代理模式工具。您可以在所有聊天模式（询问、编辑和代理模式）中执行此操作。例如，使用 #fetch 工具将网页内容添加为聊天提示的上下文，或使用 #githubRepo 在 GitHub 仓库中执行代码搜索。

获取有关向聊天提示添加上下文的更多详细信息。

提示示例

有关更多提示示例，请参阅 GitHub 文档中的 Copilot 聊天手册。

视觉

聊天支持视觉功能，这意味着您可以将图像作为上下文附加到聊天提示中，并就其提问。例如，附加一段代码的屏幕截图并要求解释它，或者附加一个 UI 草图并要求代理模式实现它。

聊天历史记录

当您在聊天会话中迭代并发送多个聊天提示时，VS Code 会使用聊天提示和响应的历史记录作为当前聊天提示的上下文。这意味着您可以提出后续问题或澄清您之前的问题，而无需重复上下文。例如，您可以问“这个和...有什么不同？”，“现在添加一个测试用例”，“更详细地解释一下”等等。

您可以随时使用聊天视图中的新建聊天 (+) 按钮 (⌘N (Windows、Linux 为 Ctrl+N)) 创建一个新的聊天会话。如果您想切换到不同的话题并避免之前的上下文和历史记录，这会很有用。

要查看聊天会话的历史记录，请选择聊天视图中的显示聊天... 按钮，或通过命令面板中的聊天: 显示聊天... 命令。选择一个历史记录条目以在聊天视图中打开该聊天会话并继续对话。

您可以使用命令面板中的聊天: 导出聊天... 命令将聊天会话的所有提示和响应导出为 JSON 文件。要以 Markdown 格式将特定的聊天提示或响应复制到剪贴板，请右键单击消息并选择复制。要复制整个聊天会话，请右键单击聊天视图并选择全部复制。

编辑上一个聊天请求

您可以在当前聊天会话中编辑之前的聊天请求。这在您想要优化提示或纠正错误时非常有用。编辑聊天请求相当于撤销该请求，然后用编辑后的提示提交一个新的请求。

当您编辑之前的聊天请求时，会执行以下步骤：

1. 编辑后的请求以及所有后续的请求和响应都将从对话历史中移除。
2. 由这些请求所做的任何编辑都将被恢复到请求发出之前的状态。
3. 编辑后的请求被添加到对话历史中，并提交给语言模型以获得新的响应。

您可以使用 chat.editRequests 设置来配置编辑之前聊天请求的方式：

• inline：在聊天视图中选择请求，使其可进行原地编辑。使用 Escape 退出编辑模式。
• hover：将鼠标悬停在聊天请求上，然后选择编辑图标（铅笔）以使其可进行原地编辑。使用 Escape 退出编辑模式。
• input：将鼠标悬停在聊天请求上，然后选择编辑图标（铅笔）以在聊天输入字段中编辑请求。
• none：禁用在聊天视图中编辑聊天请求。

使用检查点恢复聊天请求

聊天检查点提供了一种将工作区状态恢复到先前时间点的方法，当聊天交互导致多个文件发生更改时尤其有用。

当启用检查点时，VS Code 会在聊天交互的关键点自动创建文件的快照，这样如果聊天请求所做的更改不符合您的预期，或者您想尝试不同的方法，您可以返回到一个已知的良好状态。

要启用检查点，请配置 chat.checkpoints.enabled 设置。

恢复检查点

当您恢复一个检查点时，VS Code 会将工作区恢复到该检查点时的状态。这意味着在该检查点之后对文件所做的所有更改都将被撤销。

要将您的工作区恢复到之前的检查点：

1. 在聊天视图中，导航到聊天会话中之前的聊天请求。

2. 将鼠标悬停在聊天请求上，然后选择恢复检查点。

   

3. 确认您要恢复检查点并撤销该时间点之后所做的任何文件更改。

   请注意，聊天请求已从对话历史中移除，并且工作区文件已恢复到检查点时的状态。

恢复后重做

恢复到之前的检查点后，您可以重做被撤销的更改。如果您不小心恢复到了某个检查点，这可能会很有用。

要在恢复检查点后重做更改，请在聊天视图中选择重做。

查看检查点中的文件更改

为了帮助您了解每个聊天请求的影响，并更容易决定要恢复到哪个检查点，请启用 chat.checkpoints.showFileChanges 设置。这会显示在每个聊天请求结束时被修改的文件列表，以及每个文件中添加和删除的行数。

在编辑器选项卡或单独的窗口中打开聊天

您可以将聊天会话作为单独的编辑器选项卡打开，甚至可以作为单独的浮动窗口打开。此功能使您可以同时打开多个聊天会话。

在聊天视图中，选择右上角的 ... 图标，然后选择在编辑器中打开聊天或在新窗口中打开聊天。以下屏幕截图显示了在浮动窗口中运行的聊天视图：

默认情况下，聊天会话以紧凑模式打开，该模式会隐藏标题栏和其他 UI 元素。选择浮动窗口标题栏中的紧凑模式图标，可以在紧凑模式和普通模式之间切换。

或者，启用始终置顶模式，以始终将聊天视图保持在其他窗口之上。

了解更多关于 VS Code 中的浮动窗口。

使用语音交互

借助 VS Code 中的语音控制功能（由 VS Code Speech 扩展提供），您可以使用语音发起聊天对话：

• 使用您的声音来口述您的聊天提示
• 使用“Hey Code”语音命令与 Copilot Chat 开始语音会话
• 使用“按住说话”模式加速聊天的语音输入

了解更多关于如何在 VS Code 中使用语音交互的信息。

聊天调试视图

聊天调试视图是一个专用视图，您可以在其中查看 AI 请求和响应的详细信息。对于每个聊天请求，您可以看到系统提示、用户提示以及发送给语言模型的上下文的详细信息。您可以查看语言模型的详细响应，以及作为聊天请求一部分被调用的工具的响应。

要打开聊天调试视图，请从命令面板（⇧⌘P (Windows、Linux 为 Ctrl+Shift+P)）运行开发者: 显示聊天调试视图命令。

从命令行启动聊天

您可以使用 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 信任中心了解更多关于安全性、隐私和透明度的信息。

常见问题

如何防止聊天视图自动打开？

默认情况下，聊天视图在辅助侧边栏中打开。当您为某个工作区关闭聊天视图时，VS Code 会记住此设置，并且在下次打开该工作区时不会自动打开聊天视图。

您可以直接从聊天视图更改默认可见性：

1. 打开聊天视图（⌃⌘I (Windows、Linux 为 Ctrl+Alt+I)）。
2. 选择聊天视图右上角的 ... 图标。
3. 选择默认显示视图以启用或禁用聊天视图的自动打开。

您还可以使用 workbench.secondarySideBar.defaultVisibility 设置来控制辅助侧边栏的默认可见性。将其设置为 hidden 以防止聊天视图自动打开。

如何在不同的聊天模式之间进行选择？

不同的聊天模式针对不同的用例进行了优化：

• 使用编辑器行内聊天直接在活动编辑器中提问或进行编辑。这对于进行代码更改或提出仅限于活动文件范围的问题非常有用。

• 使用询问模式来询问有关您的代码库或技术概念的问题。响应可能包含代码建议，您可以手动、逐个地应用到您的代码库中。更改不会自动应用于您的代码库。

• 使用编辑模式根据您的聊天提示直接在代码库的多个文件中应用编辑。您为您的提示提供相关的上下文和文件。

• 使用代理模式来启动一个自主编码工作流，AI 会自主确定相关的上下文和文件，并决定需要执行哪些任务来完成请求。然后它会独立迭代以实现期望的结果，并在出现问题时进行修复。代理模式可以调用扩展或 MCP 服务器中的工具来执行专门的任务，例如运行终端命令、验证测试用例或访问 API。

其他资源

您可以在 GitHub Copilot 文档中阅读更多关于 GitHub Copilot 以及如何在 VS Code 中使用它的信息。

或者查看 YouTube 上的 VS Code Copilot 系列视频，您可以在其中找到更多入门内容和针对特定编程语言（如 Python、C#、Java、PowerShell、C++ 等）使用 Copilot 的视频。

后续步骤

• 使用询问模式来询问有关您的代码的问题
• 使用代理模式启动自主编码会话
• 使用编辑模式在多个文件中进行代码编辑
• 了解在 VS Code 中使用 AI 的安全注意事项