GitHub Copilot 在 VS Code 设置参考中
本文列出了Visual Studio Code中GitHub Copilot的配置设置。有关VS Code中设置的一般信息，请参阅用户和工作区设置。
团队正在不断改进 VS Code 中的 Copilot 并添加新功能。部分功能仍处于实验阶段。欢迎试用并在我们的问题中分享您的反馈。获取关于 VS Code 功能生命周期的更多信息。
提示
如果你还没有Copilot订阅，可以通过注册Copilot免费计划免费使用Copilot，并获得每月的在线建议和聊天互动限制。
一般设定
| 背景与描述 | 默认 |
|---|---|
chat.commandCenter.enabled 控制是否在VS Code标题栏显示聊天菜单。 |
确实如此 |
workbench.settings.showAISearchToggle 在设置编辑器中启用 AI 搜索设置。 |
确实如此 |
workbench.commandPalette.experimental.askChatLocation （实验）控制区，命令面板应向聊天提问。 |
“聊天视图” |
搜索。搜索视图。语义搜索行为 （预览）在搜索视图中配置何时运行语义搜索：手动（默认）、未找到文本搜索结果时，或始终运行。 |
“手动” |
搜索。搜索视图。关键词建议 （预览）控制是否在搜索视图中显示关键词建议。 |
错误 |
代码编辑设置
| 背景与描述 | 默认 |
|---|---|
github.copilot.editor.enableCodeActions 如果副驾驶命令显示为代码动作（Code Action），控制点（若可用）。 |
确实如此 |
github.copilot.renameSuggestions.triggerAutomatic 生成符号重命名建议。 |
确实如此 |
GitHub.copilot.enable 启用或禁用指定语言的内联建议。 |
{ “*”： true， “plaintext”： false， “markdown”： false， “scminput”： false } |
github.copilot.nextEditSuggestions.enabled 启用下一次编辑建议（NES）。 |
确实如此 |
editor.inline建议.编辑.allowCodeShifting 如果NES能切换代码显示建议，可以配置好。 |
“永远” |
editor.inline建议.编辑.render并排 如果可能的话，设置NES是否能并排显示更大的建议，或者Copilot NES是否应该总是在相关代码下方显示更大的建议。 |
“自动” |
github.copilot.nextEditSuggestions.fixes 启用基于诊断（曲线）的下一次编辑建议。例如，缺少导入。 |
确实如此 |
editor.inlineSuggest.minShowDelay 等待时间只需毫秒，然后才显示内联建议。 |
0 |
聊天设置
| 背景与描述 | 默认 |
|---|---|
GitHub.copilot.chat.localeOverride 指定聊天回复的地点，例如 en或FR. |
“自动” |
github.copilot.chat.useProjectTemplates 使用相关的 GitHub 项目作为入门项目 /新. |
确实如此 |
github.copilot.chat.scope选择 如果你使用，是否需要提示特定的符号范围 /解释一下而活跃编辑者没有选择。 |
错误 |
github.copilot.chat.terminalChat 位置 控制终端聊天查询应在哪里打开。 |
“聊天视图” |
chat.detectParticipant.enabled 在聊天视图中启用聊天参与者检测。 |
确实如此 |
chat.checkpoints.enabled 在聊天中启用或禁用检查点。 |
确实如此 |
chat.checkpoints.showFileChanges 在每次聊天请求的结尾显示文件变更的摘要。 |
错误 |
chat.edit请求 启用或禁用编辑之前的聊天请求。 |
“内线” |
chat.editor.fontFamily 聊天代码块中的字体家族。 |
“默认” |
chat.editor.fontSize 聊天代码块中的字体大小（像素单位）。 |
14 |
chat.editor.fontWeight（权重） 聊天代码块中的字体权重。 |
“默认” |
chat.editor.line高度 聊天代码块中的行高（像素单位）。 |
0 |
chat.editor.wordWrap 在聊天代码块中切换行代码。 |
“关掉” |
聊天.编辑.确认编辑请求移除 撤销编辑前先征求确认。 |
确实如此 |
chat.editing.confirm 编辑请求 重试 在重新编辑之前，先征求确认。 |
确实如此 |
chat.editing.autoAcceptDelay 设置一个延迟，之后建议的编辑会自动被接受，使用零来禁用自动接受。 |
0 |
chat.font家族 聊天中Markdown内容的字体家族。 |
“默认” |
chat.fontSize 聊天中Markdown内容的字体大小（像素）。 |
13 |
chat.notifyWindowOnConfirmation 当需要用户输入时，请开启或关闭显示作系统通知窗口。 |
确实如此 |
chat.notifyWindowOnResponse已收到 在收到聊天回复时，请启用或关闭显示作系统通知窗口的功能。 |
确实如此 |
chat.requestQueuing.enabled （实验性）请求进行时启用或禁用消息排队。启用后，你可以排队、引导或停止，并在当前请求中发送新消息。 |
确实如此 |
chat.requestQueuing.defaultAction 在请求进行时配置发送按钮的默认作： 排队将消息添加到队列中，牛表示当前请求让路。 |
“队列” |
chat.tools.terminal.autoReplyToPrompts 自动回复终端提示并设置默认答案。 |
错误 |
chat.tools.terminal.terminalProfile.<platform> 配置每个平台聊天终端命令的终端配置文件。 |
"" |
chat.useAgentsMdFile 启用或禁用 AGENTS.md文件作为聊天请求的上下文。 |
确实如此 |
chat.math.enabled （预览）在聊天中启用或禁用KaTeX的数学渲染。 |
错误 |
chat.viewTitle.enabled （预览）在聊天头显示当前聊天会话的标题。 |
确实如此 |
github.copilot.chat.codesearch.enabled （预览）使用 #codebase在提示中，Copilot 会自动发现需要编辑的相关文件。 |
错误 |
chat.emptyState.history.enabled （实验性）在聊天视图的空白状态下显示最近的聊天历史。 |
错误 |
chat.sendElementsToChat.enabled （实验性）启用将集成浏览器的元素发送到聊天视图作为上下文。 |
确实如此 |
chat.useNestedAgentsMdFiles （实验性）启用或禁用 AGENTS.md在你工作区的子文件夹里的文件作为聊天请求的上下文。 |
错误 |
github.copilot.chat.customOAIModels （实验性）配置自定义兼容OpenAI的聊天模型。 |
[] |
github.copilot.chat.edits.suggestRelatedFilesFromGitHistory （实验性）在聊天上下文中建议 git 历史中的相关文件。 |
确实如此 |
代理设置
| 背景与描述 | 默认 |
|---|---|
chat.agent.enabled 组织使用代理启用或禁用（需要VS Code 1.99或更高版本）。 |
确实如此 |
chat.agent.maxRequests Copilot 使用代理最多可发出的请求数。 |
25 |
github.copilot.chat.agent.autoFix 自动诊断并修复生成代码变更中的问题。 |
确实如此 |
Chat.mcp.access 组织管理哪些模型上下文协议（MCP）服务器可以在VS代码中使用。 |
确实如此 |
chat.mcp.discovery.enabled 配置自动发现其他应用程序中的MCP服务器配置。 |
错误 |
chat.tools.terminal.autoApprove 控制使用代理时自动批准的终端命令。命令可以设置为 确实如此（自动批准）或者错误（需要批准）。正则表达式可以通过在字符中包裹模式来使用。/ |
{ “rm”： false， “rmdir”： false， “del”： false， “kill”： false， “curl”： false， “wget”： false， “eval”： false， “chmod”： false， “chmod”： false， “/^Remove-Item\\b/i”： false } |
chat.tools.terminal.enableAutoApprove 组织 启用或禁用终端命令的自动批准。 |
确实如此 |
chat.tools.terminal.enforceTimeoutFromModel （实验性）控制是否强制执行代理为终端命令指定的超时值。启用后，代理在指定时长后停止跟踪命令，返回迄今为止收集的输出。 |
确实如此 |
chat.tools.terminal.ignoreDefaultAutoApproveRules 忽略终端命令默认的自动批准规则。 |
错误 |
chat.tools.global.autoApprove 组织自动批准所有工具——此设置会禁用关键的安全保护。 |
错误 |
chat.tools.urls.autoApprove 控制哪些URL请求和响应是自动批准的。 |
[] |
chat.agent.thinking.collapsedTools （实验性）配置聊天对话中工具调用细节是默认折叠还是展开。 |
永远 |
chat.agent.thinkingStyle（聊聊）。思考风格 （实验性）配置思考代币在聊天中的呈现方式。 |
固定滚动 |
chat.mcp.autoStart （实验性）检测到MCP配置变更时自动启动MCP服务器。 |
新旧 |
chat.tools.eligible自动批准 组织 （实验性）配置哪些工具需要人工批准才能被代理使用。 |
[] |
chat.tools.terminal.block检测文件写入 （实验性）要求终端命令进行文件写入，需用户批准。 |
outside sideWorkspace |
chat.tools.terminal.sandbox.enabled （实验性）启用由代理执行的终端命令的沙箱功能（仅限macOS和Linux）。启用后，命令自动批准，并限制文件系统和网络访问。 |
错误 |
chat.tools.terminal.sandbox.linuxFileSystem （实验性）配置Linux沙盒终端命令的文件系统访问规则。支持 允许写入,拒绝写， 和拒绝阅读属性。 |
{} |
chat.tools.terminal.sandbox.macFileSystem （实验性）配置macOS沙箱终端命令的文件系统访问规则。支持 允许写入,拒绝写， 和拒绝阅读属性。 |
{} |
chat.tools.terminal.sandbox.network （实验性）配置沙箱终端命令的网络访问规则。支持 允许域名属性以指定允许的域名。 |
{} |
github.copilot.chat.newWorkspaceCreation.enabled （实验性）启用在聊天中搭建新工作区的支架工具。 |
确实如此 |
github.copilot.chat.agent.thinkingTool （实验性）在使用代理时启用思考工具。 |
错误 |
github.copilot.chat.summarizeAgentConversationHistory.enabled （实验性）当上下文窗口满时，自动总结代理对话历史。 |
确实如此 |
GitHub.copilot.chat.virtualTools.threshold （实验性）使用哪些虚拟工具的工具数量。虚拟工具将相似的工具集组合在一起，并使模型能够按需激活它们。允许你在聊天请求中超过128个工具的限制。 |
128 |
代理会话
代理视图为管理本地聊天对话和远程编码代理会话提供了集中管理。该视图允许您同时作多个AI会话，跟踪其进展，并高效管理长期任务。
| 背景与描述 | 默认 |
|---|---|
workbench.startupEditor 配置VS代码欢迎页面作为代理会话的入口。设置为 agentSessions欢迎页面显示包含近期会话、嵌入聊天和快速作的 VS Code 欢迎页面。 |
无 |
chat.viewSessions.enabled 在聊天视图中显示代理会话列表。 |
确实如此 |
chat.agentsControl.enabled （实验）在指挥中心启用代理状态指示器。显示未读和正在进行的会话徽章。 |
确实如此 |
聊天。代理控制。点击行为 （实验性）在代理状态指示器中选择聊天图标时配置行为。 |
“循环”（内部人士）“默认”（稳定） |
chat.unifiedAgentsBar.enabled （实验性）用统一的聊天和搜索控制取代指挥中心搜索框。 |
错误 |
在线聊天设置
| 背景与描述 | 默认 |
|---|---|
inlineChat.defaultModel 配置编辑器内联聊天的默认语言模型。你选择的模型在会话中会保留，但 VS Code 重新加载后会重置为该默认模式。 |
无 |
inlineChat.renderMode （实验）配置在线聊天的显示方式。 悬停： 显示在线聊天以浮动覆盖层形式，区域： 在编辑器中显示内联聊天的专属区域。 |
“悬停” |
inlineChat.finishOnType。 在更改区域外输入时，完成编辑内联聊天会话。 |
错误 |
inlineChat.holdToSpeech 按住编辑器内联聊天键盘快捷键（⌘I（Windows，Linux Ctrl+I））会自动启用语音识别。 |
确实如此 |
editor.inlineSuggest.syntaxHighlightingEnabled 显示语法高亮以提供内联建议。 |
确实如此 |
inlineChat.affordance （实验性）选择文本时显示视觉提示，帮助开始内联聊天。 不对劲：毫无暗示，排水沟： 显示在行号区域，编辑： 显示在光标位置，灯泡显示。 |
“关掉” |
inlineChat.lineEmptyHint （实验性）在空行中显示编辑内联聊天的提示。 |
错误 |
inlineChat.line自然语言提示 （实验性）触发编辑器的内联聊天，只要一行大部分是单词。 |
确实如此 |
github.copilot.chat.editor.temporalContext.enabled （实验性）在编辑内联聊天的上下文中包含最近浏览和编辑的文件。 |
错误 |
代码审查设置
| 背景与描述 | 默认 |
|---|---|
github.copilot.chat.reviewSelection.enabled （预览）启用 AI 代码审查，用于编辑器文本选择。 |
确实如此 |
github.copilot.chat.reviewSelection.instructions （预览）自定义指令，添加到请求中，用于用AI审核当前编辑器选择。 |
[] |
自定义说明设置
| 背景与描述 | 默认 |
|---|---|
chat.instructions文件位置 搜索自定义指令文件的位置。相对路径可从工作区的根文件夹解析。支持文件路径的颗粒模式。 |
{ “.github/instructions”： true } |
chat.include应用指令 自动添加与匹配的指令文件 应用聊天请求的模式。 |
确实如此 |
chat.includeReferencedInstructions 自动添加通过Markdown链接引用的指令文件到聊天请求中。 |
错误 |
github.copilot.chat.codeGeneration.useInstructionFiles 自动添加自定义指令 .github/copilot-instructions.md聊天请求。 |
确实如此 |
github.copilot.chat.commitMessageGeneration.instructions （实验性）用于生成提交信息的AI定制指令。 |
[] |
github.copilot.chat.pullRequestDescriptionGeneration.instructions （实验性）用于用AI生成拉取请求标题和描述的自定义说明。 |
[] |
可重复使用的提示文件设置
| 背景与描述 | 默认 |
|---|---|
chat.promptFiles位置 搜索提示文件的位置。相对路径由工作区的根文件夹解析。支持文件路径的球状模式。 |
{ “.github/prompts”： true } |
chat.promptFiles推荐 在打开新聊天会话时启用或禁用提示文件推荐。提示词文件名和布尔或当子句的键值对列表。 |
[] |
自定义代理设置
| 背景与描述 | 默认 |
|---|---|
chat.agent文件位置 搜索自定义代理文件的位置。相对路径可从工作区的根文件夹解析。支持用户特定路径的主目录扩展（）。 ~ |
{ “.github/agents”： true } |
chat.customAgentInSubagent.enabled （实验性）启用带有子代理的自定义代理。 |
错误 |
github.copilot.chat.cli.customAgents.enabled （实验性）启用 GitHub 后台代理会话中的自定义代理。 |
错误 |
代理技能设置
| 背景与描述 | 默认 |
|---|---|
chat.useAgentSkills 启用对VS Code中代理技能的支持。 |
确实如此 |
chat.agent技能地点 寻找经纪人技能的地点。相对路径是从你工作区的根文件夹解析的。支持用户特定路径的主目录扩展（）。 ~ |
“chat.agentSkillsLocations”： { “.github/skills”： true，“.claude/skills”： true，“~/.copilot/skills”： true，“~/.claude/skills”： true} |
调试设置
| 背景与描述 | 默认 |
|---|---|
github.copilot.chat.startDebugging.enabled （预览）使实验性 /startDebugging在聊天视图中生成调试配置。 |
确实如此 |
github.copilot.chat.copilotDebugCommand.enabled （预览）启用 副驾驶调试终端指挥。 |
确实如此 |
测试设置
| 背景与描述 | 默认 |
|---|---|
github.copilot.chat.generateTests.codeLens （实验性）显示 为当前测试覆盖信息未覆盖的符号生成测试代码透镜。 |
错误 |
github.copilot.chat.setupTests.enabled （实验性）使实验性 /setupTests意图与提示/测试世代。 |
确实如此 |
笔记本设置
| 背景与描述 | 默认 |
|---|---|
notebook.experimental.generate （实验性）启用生成作，通过笔记本内联聊天创建代码单元。 |
确实如此 |
github.copilot.chat.edits.newNotebook.enabled （实验性）启用编辑模式中的笔记本工具，创建新的笔记本文件。 |
确实如此 |
github.copilot.chat.notebook.followCellExecution.enabled （实验性）在编辑器中显示当前执行的单元格。 |
错误 |
无障碍设置
| 背景与描述 | 默认 |
|---|---|
inlineChat.accessibleDiffView 在线聊天是否还会为其变更提供可访问的不同查看器。 |
“自动” |
accessibility.signals.chat请求已发送 当有聊天请求时，会播放信号——声音（音频提示）和/或广播（警报）。 |
{ “声音”： “自动”， “公告”： “自动” } |
accessibility.signals.chat 回复已收到 收到回复后会播放声音/音频提示。 |
{“声音”：“自动” } |
accessibility.signals.chat编辑修改文件 当文件被聊天编辑修改时，会播放声音/音频提示。 |
{“声音”：“自动” } |
accessibility.signals.chatUserActionRequired（需要）访问。 当用户需要在聊天中采取行动时，会播放声音/音频提示。 |
{ “声音”： “自动”， “公告”： “自动” } |
accessibility.signals.lineHasInlineSuggestion 当光标位于带有内联建议的行时，会播放声音/音频提示。 |
{“声音”：“自动” } |
accessibility.signals.next编辑建议 当有下一次编辑建议时，会播放声音/音频提示。 |
{ “声音”： “自动”， “公告”： “自动” } |
accessibility.verbose聊天进展更新 详细更新聊天动态。 |
确实如此 |
accessibility.verbosity.inlineChat 提供如何访问内联编辑器、聊天辅助功能、帮助菜单的信息，并提示在输入聚焦时如何使用该功能。 |
确实如此 |
access.verbosity.inline完成 提供如何访问内嵌建议悬停和无障碍视图的信息。 |
确实如此 |
accessibility.verbosity.panelChat 提供当聊天输入聚焦时，如何访问聊天帮助菜单的信息。 |
确实如此 |
accessibility.voice.keyword激活 控制关键词短语“Hey Code”是否被识别，从而开始语音聊天会话。 |
“关掉” |
accessibility.voice.autoSynthesize 控制在使用语音输入时，文本是否应自动朗读。 |
“关掉” |
accessibility.voice.speech 超时 语音识别在你停止说话后保持活跃的时间（以毫秒计）是几毫秒的。 |
1200 |