编辑

VS Code 中的 GitHub Copilot 速查表

Visual Studio Code 中的 GitHub Copilot 提供了 AI 驱动的功能，帮助您更快、更轻松地编写代码。本速查表快速概述了 Visual Studio Code 中 GitHub Copilot 的各项功能。

提示

如果您还没有 Copilot 订阅，可以通过注册 Copilot 免费计划来免费使用 Copilot，并获得每月的补全和聊天交互限制。

基本键盘快捷键

⌃⌘I (Windows、Linux Ctrl+Alt+I) - 打开聊天视图
⌘I (Windows、Linux Ctrl+I) - 在聊天视图中输入语音聊天提示
⌘N (Windows、Linux Ctrl+N) - 在聊天视图中开始新的聊天会话
⇧⌘I (Windows Ctrl+Shift+I, Linux Ctrl+Shift+Alt+I) - 切换到代理模式
⌘I (Windows、Linux Ctrl+I) - 在编辑器或终端中开始行内聊天
⌘I (Windows、Linux Ctrl+I) (按住) - 开始行内语音聊天
Tab - 接受行内建议或导航到下一个编辑建议
Escape - 关闭行内建议

在 VS Code 中访问 AI

使用自然语言开始聊天对话
- 聊天视图 (⌃⌘I (Windows、Linux Ctrl+Alt+I)): 在辅助侧边栏中保持进行中的聊天对话
- 在编辑器或终端中进行行内聊天 (⌘I (Windows、Linux Ctrl+I)): 在工作流程中提问
- 快速聊天 (⇧⌥⌘L (Windows、Linux Ctrl+Shift+Alt+L)): 在不离开当前任务的情况下快速提问
编辑器中的 AI
- 代码补全：在您输入时获取建议，按 Tab 接受建议
- 编辑上下文菜单操作：访问常见的 AI 操作，如解释或修复代码、生成测试或审查选定的文本
- 代码操作：获取编辑器代码操作（灯泡图标），以修复 linting 和编译器错误
整个 VS Code 中特定于任务的智能操作
- 生成提交消息和拉取请求的标题和描述
- 修复测试错误
- 语义化文件搜索建议

VS Code 中的聊天体验

开始自然语言聊天对话以获取编码任务的帮助。例如，请求解释一段代码或一个编程概念、重构一段代码或实现一个新功能。获取有关使用 Copilot 聊天的更多信息。

操作	描述
⌃⌘I (Windows、Linux Ctrl+Alt+I)	在辅助侧边栏中打开聊天视图。
⌘I (Windows、Linux Ctrl+I)	开始行内聊天，在编辑器或终端中打开聊天。
⇧⌥⌘L (Windows、Linux Ctrl+Shift+Alt+L)	打开快速聊天，而不中断您的工作流程。
⌘N (Windows、Linux Ctrl+N)	在聊天视图中开始新的聊天会话。
	在聊天视图中切换不同的聊天模式。
⌥⌘. (Windows、Linux Ctrl+Alt+.)	显示模型选择器以为聊天选择不同的 AI 模型。
`添加上下文...`	将不同类型的上下文附加到您的聊天提示。
`/`-命令	使用斜杠命令执行常见任务或调用可重用的聊天提示。
`#`-提及	引用常用工具或聊天变量以在您的提示中提供上下文。
`@`-提及	引用聊天参与者以处理特定领域的请求。
编辑 ()	编辑之前的聊天提示并恢复更改。
历史记录 ()	访问您的聊天会话历史。
语音 ()	通过语音输入聊天提示（语音聊天）。聊天响应将被大声读出。
KaTeX	在聊天响应中呈现数学方程式。通过 chat.math.enabled 启用。

提示

使用 #-提及为您的聊天提示添加更多上下文。

使用 / 命令和 @ 参与者以获得更精确和相关的答案。

要具体、保持简单，并提出后续问题以获得最佳结果。

选择适合您需求的聊天模式：提问、编辑、代理或创建自定义模式。

为您的提示添加上下文

通过为您的聊天提示提供上下文，获得更相关的响应。从不同类型的上下文中选择，例如文件、符号、编辑器选择、源代码管理提交、测试失败等。

操作	描述
添加上下文	打开快速选择器，为您的聊天提示选择相关上下文。从不同类型的上下文中选择，例如工作区文件、符号、当前编辑器选择、终端选择等。
拖放文件	从资源管理器或搜索视图中拖放文件，或将编辑器选项卡拖到聊天视图上。
拖放文件夹	将文件夹拖放到聊天视图上，以附加其中的文件。
拖放问题	从“问题”面板拖放一个项目。
`#<文件\|文件夹\|符号>`	输入 `#`，后跟文件、文件夹或符号名称，以将其添加为聊天上下文。
`#-提及	输入 `#`，后跟一个聊天工具，以添加特定的上下文类型或工具。

聊天工具

在聊天中使用工具，在处理用户请求时完成专门任务。这些任务的例子包括列出目录中的文件、编辑工作区中的文件、运行终端命令、从终端获取输出等等。选择内置工具或来自 MCP 服务器和扩展的工具。

下表列出了 VS Code 内置的工具

聊天变量/工具	描述
`#changes`	源代码管理变更列表。
`#codebase`	在当前工作区中执行代码搜索，以自动为聊天提示找到相关上下文。
`#editFiles`	用于在工作区中创建和编辑文件的工具集。
`#extensions`	用于查找和询问有关 VS Code 扩展的问题的工具。例如，“how to get started with Python #extensions?”
`#fetch`	从网页获取内容 - 提供 URL。
`#findTestFiles`	用于在当前工作区中查找测试文件的工具。
`#githubRepo`	用于在 GitHub 仓库中执行代码搜索的工具。例如，“what is a global snippet #githubRepo microsoft/vscode.”
`#new`	用于搭建新的 VS Code 工作区的工具。
`#openSimpleBrowser`	用于打开内置的简单浏览器并预览本地部署的 Web 应用程序的工具。
`#problems`	将来自问题面板的工作区问题和错误作为上下文添加。在修复代码或调试时非常有用。
`#readCellOutput`	用于读取 notebook 单元格输出的工具。
`#runCommands`	用于在终端中运行命令并读取输出的工具。
`#runNotebooks`	用于在 notebook 中运行单元格并读取输出的工具。
`#runTasks`	用于在工作区中运行任务并读取输出的工具。
`#runTests`	用于在工作区中运行测试并读取输出的工具。
`#search`	用于在当前工作区中搜索文件的工具集。
`#searchResults`	将搜索视图的结果作为上下文添加到您的提示中。
`#selection`	将当前编辑器选择作为上下文添加到您的提示中。
`#terminalSelection`	将当前终端选择作为上下文添加到您的聊天提示中。
`#terminalLastCommand`	将最后运行的终端命令作为上下文添加到您的聊天提示中。
`#testFailure`	将测试失败信息作为上下文添加。在运行和诊断测试时非常有用。
`#usages`	“查找所有引用”、“查找实现”和“转到定义”的组合。
`#VSCodeAPI`	用于引用 VS Code 扩展 API 并询问与 VS Code 扩展开发相关问题的工具。

斜杠命令

斜杠命令是聊天中特定功能的快捷方式。您可以使用它们快速执行操作，如修复问题、生成测试或解释代码。

斜杠命令	描述
`/docs`	从编辑器行内聊天生成代码文档注释。
`/explain`	解释代码块、文件或编程概念。
`/fix`	要求 Copilot 修复代码块或解决编译器或 linting 错误。
`/help`	获取有关在 VS Code 中使用聊天的帮助。
`/tests`	为编辑器中所有或仅选定的方法和函数生成测试。
`/setupTests`	获取有关为您的代码设置测试框架的帮助。获取相关测试框架的推荐、设置和配置步骤，以及 VS Code 测试扩展的建议。
`/clear`	在聊天视图中开始新的聊天会话。
`/new`	搭建新的 VS Code 工作区或文件。使用自然语言描述您需要的项目/文件类型，并在创建前预览搭建的内容。
`/newNotebook`	根据您的要求搭建一个新的 Jupyter notebook。使用自然语言描述 notebook 应包含的内容。
`/search`	为搜索视图生成一个搜索查询。使用自然语言描述您想搜索的内容。
`/startDebugging`	生成一个 `launch.json` 调试配置文件并从聊天视图开始调试会话。
`/<提示文件名>`	在聊天中运行一个可重用的提示文件。

聊天参与者

使用聊天参与者在聊天中处理特定领域的请求。聊天参与者以 @ 为前缀，可用于询问特定主题的问题。VS Code 提供了内置的聊天参与者，如 @github、@terminal 和 @vscode，扩展可以提供额外的参与者。

聊天参与者	描述
`@github`	使用 `@github` 参与者询问有关 GitHub 仓库、问题、拉取请求等问题。获取有关可用的 GitHub 技能的更多信息。示例：`@github What are all of the open PRs assigned to me?`, `@github Show me the recent merged PRs from @dancing-mona`
`@terminal`	使用 `@terminal` 参与者询问有关集成终端或 shell 命令的问题。示例：`@terminal list the 5 largest files in this workspace`
`@vscode`	使用 `@vscode` 参与者询问有关 VS Code 功能、设置和 VS Code 扩展 API 的问题。示例：`@vscode how to enable word wrapping?`
`@workspace`	使用 `@workspace` 参与者询问有关当前工作区的问题。示例：`@workspace how is authentication implemented?`

代理模式

通过聊天代理模式，您可以使用自然语言指定一个高级别任务，让 AI 自主地对请求进行推理，规划所需的工作，并将更改应用到您的代码库中。代理模式结合使用代码编辑和工具调用来完成您指定的任务。在处理您的请求时，它会监控编辑和工具的结果，并迭代解决出现的任何问题。

操作	描述
⇧⌘I (Windows Ctrl+Shift+I, Linux Ctrl+Shift+Alt+I)	在聊天视图中切换到代理模式
工具 ()	配置在代理模式下可用的工具。从内置工具、MCP 服务器和扩展提供的工具中选择。
自动批准工具 (实验性)	在代理模式下启用所有工具的自动批准 (chat.tools.autoApprove)。
自动批准终端命令 (实验性)	在代理模式下启用终端命令的自动批准 (chat.tools.terminal.autoApprove)。
MCP	配置 MCP 服务器，以额外的功能和工具扩展代理模式。

提示

向代理模式添加额外的工具以扩展其功能。

配置自定义聊天模式，以定义代理模式的运作方式，例如实现一个只读的规划模式。

定义自定义指令，以指导代理模式如何生成和结构化代码。

自定义您的聊天体验

自定义您的聊天体验，以生成与您的编码风格、工具和开发工作流程相匹配的响应。在 VS Code 中有几种方法可以自定义您的聊天体验。

自定义指令：为生成代码、执行代码审查或生成提交消息等任务定义通用准则或规则。自定义指令描述了 AI 应在何种条件下操作（任务应如何完成）。
可重用的提示文件：为常见任务（如生成代码或执行代码审查）定义可重用的提示。提示文件是独立的提示，您可以直接在聊天中运行。它们描述了要执行的任务（应该做什么）。
聊天模式：定义聊天如何运作、可以使用哪些工具以及如何与代码库交互。每个聊天提示都在聊天模式的范围内运行，无需为每个请求配置工具和指令。

提示

定义特定语言的指令，以获得更准确的每种语言生成代码。

将您的指令存储在工作区中，以便轻松与您的团队共享。

为常见任务定义可重用的提示文件，以节省时间并帮助团队成员快速上手。

编辑器 AI 功能

在编辑器中编码时，您可以使用 Copilot 在输入时生成代码补全。调用行内聊天来提问并从 Copilot 获得帮助，同时保持在编码流程中。例如，要求 Copilot 为函数或方法生成单元测试。获取有关代码补全和行内聊天的更多信息。

操作	描述
代码补全	在编辑器中开始输入，并获得与您的编码风格相匹配并考虑您现有代码的代码建议。
代码注释	通过在代码注释中编写指令来提供代码补全提示。示例：`# 编写一个计算器类，包含加、减、乘的方法。使用静态方法。`
⌘I (Windows、Linux Ctrl+I)	开始编辑器行内聊天，直接从编辑器发送聊天请求。使用自然语言并引用聊天变量和斜杠命令来提供上下文。
F2	在重命名代码中的符号时获取 AI 驱动的建议。
上下文菜单操作	使用编辑器上下文菜单访问常见的 AI 操作，例如解释代码、生成测试、审查代码等。在编辑器中右键单击以打开上下文菜单并选择生成代码。
代码操作 (灯泡)	在编辑器中选择代码操作（灯泡），以修复代码中的 linting 或编译器错误。

提示

使用有意义的方法或函数名称，以更快地获得更好的代码补全。

选择一个代码块来限定您的行内聊天提示范围，或通过附加文件或符号来附加相关上下文。

使用编辑器上下文菜单选项，直接从编辑器访问常见的 AI 驱动操作。

源代码管理和问题

使用 AI 分析您的提交和拉取请求中的更改，并为提交消息和拉取请求描述提供建议。

操作	描述
`#changes`	将当前的源代码管理更改作为上下文添加到您的聊天提示中。
提交作为上下文	将源代码管理历史中的一个提交作为上下文添加到您的聊天提示中。
提交消息	为源代码管理提交中的当前更改生成提交消息。
拉取请求描述	生成与您拉取请求中更改相对应的拉取请求标题和描述。
`@github`	在聊天中使用 `@github` 参与者，询问有关您仓库中的问题、拉取请求等。获取有关可用的 GitHub 技能的更多信息。示例：`@github What are all of the open PRs assigned to me?`, `@github Show me the recent merged pr's from @dancing-mona`

审查代码 (实验性)

使用 AI 对代码块进行快速审查，或对工作区中未提交的更改进行审查。审查反馈会以注释的形式显示在编辑器中，您可以在其中应用这些建议。

操作	描述
审查并评论 (预览)	选择一个代码块，然后从编辑器上下文菜单中选择生成代码 > 审查并评论，进行快速审查。
代码审查	在源代码管理视图中选择代码审查按钮，对所有未提交的更改进行更深入的审查。

搜索和设置

在搜索视图中获取语义相关的搜索结果，或在设置编辑器中帮助搜索设置。

操作	描述
语义搜索 (预览)	在搜索视图中包含语义搜索结果 (search.searchView.semanticSearchBehavior)。
设置搜索 (预览)	在设置编辑器中包含语义搜索结果 (workbench.settings.showAISearchToggle)。

生成测试

Copilot 可以为您的代码库中的函数和方法生成测试。获取有关聊天中斜杠命令的更多信息。

操作	描述
`/tests`	为编辑器中所有或仅选定的方法和函数生成测试。生成的测试会附加到现有的测试文件中，或者会创建一个新的测试文件。
`/setupTests`	获取有关为您的代码设置测试框架的帮助。获取相关测试框架的推荐、设置和配置步骤，以及 VS Code 测试扩展的建议。
`/fixTestFailure`	向 Copilot 请求有关如何修复失败测试的建议。
测试覆盖率 (实验性)	为尚未被测试覆盖的函数和方法生成测试。获取更多信息。

提示

提供有关要使用的测试框架或库的详细信息。

调试和修复问题

使用 Copilot 帮助修复编码问题，并在 VS Code 中获取有关配置和启动调试会话的帮助。

操作	描述
`/fix`	向 Copilot 请求有关如何修复代码块或如何解决代码中任何编译器或 linting 错误的建议。例如，帮助解决未解析的 Node.js 包名。
`/fixTestFailure`	向 Copilot 请求有关如何修复失败测试的建议。
`/startDebugging` (实验性)	生成一个 `launch.json` 调试配置文件，并从聊天视图开始一个调试会话。
`copilot-debug` 命令	帮助您调试程序的终端命令。在一个运行命令前加上前缀来为其启动一个调试会话（例如，`copilot-debug python foo.py`）。

提示

提供有关您需要的修复类型的附加信息，例如优化内存消耗或性能。

注意编辑器中表示修复代码问题建议的 Copilot 代码操作。

搭建新项目

Copilot 可以通过生成项目结构的脚手架来帮助您创建新项目，或根据您的要求生成一个 notebook。

操作	描述
代理模式	使用代理模式并使用自然语言提示来创建新项目或文件。例如，`Create a svelte web application to track my tasks`。
`/new`	在聊天视图中使用 `/new` 命令来搭建新项目或新文件。使用自然语言描述您需要的项目/文件类型，并在创建前预览搭建的内容。示例：`/new Express app using typescript and svelte`
`/newNotebook`	在聊天视图中使用 `/newNotebook` 命令，根据您的要求生成一个新的 Jupyter notebook。使用自然语言描述 notebook 应包含的内容。示例：`/newNotebook get census data and preview key insights with Seaborn`。

终端

获取有关 shell 命令的帮助以及如何在终端中运行命令时解决错误。

操作	描述
⌘I (Windows、Linux Ctrl+I)	开始终端行内聊天，使用自然语言询问有关 shell 命令和终端的问题。示例：`how many cores on this machine?`
`@terminal`	在聊天视图中使用 `@terminal` 参与者询问有关集成终端或 shell 命令的问题。示例：`@terminal list the 5 largest files in this workspace`
`@terminal /explain`	在聊天视图中使用 `/explain` 命令来解释终端中的某些内容。示例：`@terminal /explain top shell command`

Python 和 notebook 支持

您可以使用聊天来帮助您在原生 Python REPL 和 Jupyter notebook 中完成 Python 编程任务。

操作	描述
生成 ⌘I (Windows、Linux Ctrl+I)	在 notebook 中开始行内聊天，以生成代码块或 Markdown 块。
`#`	在您的聊天提示中附加来自 Jupyter 内核的变量，以获得更相关的响应。
原生 REPL + ⌘I (Windows、Linux Ctrl+I)	在原生 Python REPL 中开始行内聊天并运行生成的命令。
⌃⌘I (Windows、Linux Ctrl+Alt+I)	打开聊天视图并使用编辑或代理模式进行 notebook 编辑。
`/newNotebook`	在聊天视图中使用 `/newNotebook` 命令，根据您的要求生成一个新的 Jupyter notebook。使用自然语言描述 notebook 应包含的内容。示例：`/newNotebook get census data and preview key insights with Seaborn`。

后续步骤

教程：在 VS Code 中开始使用 AI 功能

08/07/2025