尝试以扩展 VS Code 中的代理模式！

2025 年 5 月（版本 1.101）

发布日期：2025 年 6 月 12 日

安全更新：以下扩展具有安全更新：ms-python.python。

更新 1.101.1：此更新解决了这些问题。

更新 1.101.2：此更新解决了这些问题。

下载：Windows：x64 Arm64 | Mac：通用 Intel Apple 芯片 | Linux：deb rpm tarball Arm snap

欢迎使用 Visual Studio Code 2025 年 5 月版。此版本中有许多更新，希望您会喜欢，其中一些主要亮点包括：

  • MCP

    • 通过支持提示、资源和采样来扩展您的代理编码流程（显示更多）。
    • 访问需要身份验证的 MCP 服务器（显示更多）。
    • 使用开发模式调试 MCP 服务器（显示更多）。
    • 从扩展发布 MCP 服务器（显示更多）。

  • 聊天

    • 通过将相关工具组合到工具集中来对其进行分组和管理（显示更多）。

  • 源代码管理

    • 在源代码管理图表视图中查看文件（显示更多）。
    • 在 VS Code 中分配和跟踪 GitHub Copilot 编码代理的工作（显示更多）。

如果您想在线阅读这些发行说明，请访问 code.visualstudio.com 上的更新。内部人员版：想尽快尝试新功能吗？您可以下载每晚的内部人员版构建，并在可用时立即尝试最新更新。

聊天

聊天工具集

VS Code 现在允许您通过建议的 API 或通过 UI 定义工具集。工具集是不同工具的集合，可以像单个工具一样使用。工具集使分组相关工具变得更容易，并可以在代理模式下快速启用或禁用它们。例如，下面的工具集用于管理 GitHub 通知（使用GitHub MCP 服务器）。

{
  "gh-news": {
    "tools": ["list_notifications", "dismiss_notification", "get_notification_details"],
    "description": "Manage GH notification",
    "icon": "github-project"
  }
}

要创建工具集，请从命令面板运行配置工具集 > 创建新工具集文件命令。然后，您可以选择要包含在工具集中的工具，并提供描述和图标。

要在聊天查询中使用工具集，请通过 # 提及其名称来引用它，例如 #gh-news。您也可以从聊天输入框中的工具选择器中选择它。

Screenshot of the Chat view showing a query about unread notifications, using the 'gh-news' tool set highlighted in both the chat interface and a JSON configuration file which defines this tool set.

在我们的文档中了解有关工具集的更多信息。

MCP 对提示的支持

VS Code 的模型上下文协议支持现在包括提示支持。提示可以由 MCP 服务器定义，以生成可重用的代码片段或语言模型任务。提示可以在聊天中作为斜杠 / 命令访问，格式为 /mcp.servername.promptname。您可以输入纯文本或在提示变量中包含命令输出，我们还支持服务器提供完成功能。

以下示例演示了我们如何使用 AI 生成提示，使用Gistpad MCP 服务器保存它，然后使用它生成变更日志条目

MCP 对资源的支持

VS Code 的模型上下文协议支持现在包括资源支持，其中包括对资源模板的支持。它在多个地方可用

  1. 从 MCP 工具调用返回的资源可供模型使用，并且可以通过保存按钮或将资源拖到资源管理器视图中保存到聊天中。
  2. 可以通过聊天中的添加上下文...按钮附加资源作为上下文，然后选择MCP 资源...。
  3. 您可以使用MCP：浏览资源命令或通过其在MCP：列出服务器命令中的条目来浏览和查看服务器上的资源。

这是将Gistpad MCP 服务器中的资源附加到聊天的示例

MCP 对采样的支持（实验性）

VS Code 的模型上下文协议支持现在包括采样，这允许 MCP 服务器向模型发出请求。第一次 MCP 服务器发出采样请求时，系统会要求您确认，您可以通过在MCP：列出服务器中选择服务器来配置 MCP 服务器可以访问的模型以及查看请求日志。

采样支持仍处于初步阶段，我们计划在未来的迭代中扩展和改进它。

MCP 对身份验证的支持

VS Code 现在支持需要身份验证的 MCP 服务器，允许您与代表您的用户帐户为该服务运行的 MCP 服务器进行交互。

此功能实现了 MCP 客户端的授权规范，并支持

  • 2025-3-26 规范，其中 MCP 服务器充当授权服务器。
  • 草案规范，其中 MCP 服务器充当资源服务器（预计即将定稿）。

如果 MCP 服务器实现了草案规范并利用 GitHub 或 Entra 作为身份验证服务器，您可以管理哪些 MCP 服务器可以访问您的帐户

Screenshot of the "Manage Trusted MCP Servers" option in the account menu.

Screenshot of the "Manage Trusted MCP Servers" Quick Pick.

您还可以管理该服务器应使用哪个帐户（通过上一个快速选择中的齿轮按钮）

Screenshot of the "Account Preference" Quick Pick.

对于依赖动态客户端注册的其他 MCP 服务器，我们将身份验证状态包含在与其他所有内容相同的位置，例如使用 Linear

Screenshot of Linear appearing in the account menu.

在那里您也可以注销。对于这些，我们不仅支持代码授权流程，还支持设备代码流程，如果您的授权服务器支持它的话。

我们还引入了命令Authentication: Remove Dynamic Authentication Providers，允许您清理任何这些动态客户端注册。这将丢弃颁发给 VS Code 的客户端 ID 以及与此身份验证提供程序关联的所有数据。

请记住，您可以使用MCP：添加服务器...命令添加 MCP 服务器。这与带身份验证的服务器的入口点相同。

MCP 开发模式

您可以通过向服务器配置添加 dev 键来为 MCP 服务器启用开发模式。这是一个包含两个属性的对象

  • watch：一个文件 glob 模式，用于监视文件更改以重新启动 MCP 服务器。
  • debug：允许您使用 MCP 服务器设置调试器。目前，我们仅支持调试分别使用 node 和 python 启动的 Node.js 和 Python 服务器。

.vscode/mcp.json

{
  "servers": {
    "gistpad": {
      "command": "node",
      "args": ["build/index.js"],
+     "dev": {
+       "watch": "build/**/*.js",
+       "debug": { "type": "node" }
+     },

聊天用户体验改进

我们根据您的反馈不断努力改进 VS Code 中的聊天用户体验。其中一个反馈是，在聊天中很难区分用户消息和 AI 响应。为了解决这个问题，我们使用户消息的显示更加清晰。

现在，撤消以前的请求也更加可见 - 只需将鼠标悬停在请求上并选择 X 按钮即可撤消该请求和任何后续请求。或者更快地，使用键盘快捷键 ⌘Backspace (Windows, Linux Delete)！

最后，聊天输入框中的附件现在更易于导航。

在我们的文档中了解有关在 VS Code 中使用聊天的更多信息。

更有效地应用编辑

编辑文件时，VS Code 可以采用两种不同的方法：要么从上到下重写文件，要么进行多个较小的编辑。两种方法有所不同，例如，前者对于大文件可能较慢，并且中间状态通常无法成功编译。因此，UI 会进行调整并有条件地禁用自动保存和波浪线，但仅在需要时才禁用。

我们还统一了保留和撤消命令的键绑定。现在，使用 ⌘Y (Windows, Linux Ctrl+Y) 和 ⌘N (Windows, Linux Ctrl+N) 来保留和撤消单个更改。同样地，我们也统一了保留和撤消文件中所有更改的键绑定，它们现在是 ⇧⌘Y (Windows, Linux Ctrl+Shift+Y) 和 ⇧⌘N (Windows, Linux Ctrl+Shift+N)。这不仅是为了统一，也消除了与流行的编辑命令（如全部删除左侧）之前的冲突。

隐式上下文

我们简化了在聊天中将当前文件添加为上下文的方式。许多人觉得我们以前的“眼球切换”有点笨拙。现在，您的当前文件作为建议的上下文项提供。只需选择该项即可将其添加或从聊天上下文中删除。在提示输入字段中，按 Shift+Tab, Enter 即可通过键盘快速完成此操作。

此外，在代理模式下，我们还会提供有关当前编辑器的提示。这不包括文件内容，只包括文件名和光标位置。然后，代理可以使用其工具自行读取文件内容，如果它认为这与您的查询相关。

在我们的文档中了解有关在聊天中添加上下文的更多信息。

修复任务配置错误

配置任务和问题匹配器可能很棘手。当任务配置中出现错误时，使用提供的使用 Github Copilot 修复操作可以快速有效地解决这些错误。

自定义聊天模式（预览）

默认情况下，聊天视图支持三种内置聊天模式：提问、编辑和代理。每种聊天模式都带有一组基本说明，描述 LLM 应如何处理请求，以及可用于该请求的工具列表。

您现在可以定义自己的自定义聊天模式，可以在聊天视图中使用。自定义聊天模式允许您调整聊天的行为并指定该模式下可用的工具。这对于专用工作流或当您想要向 LLM 提供特定说明时特别有用。例如，您可以为规划新功能创建自定义聊天模式，该模式仅对您的代码库具有只读访问权限。

要定义和使用自定义聊天模式，请按照以下步骤操作

  1. 通过命令面板中的聊天：配置聊天模式命令定义自定义模式。
  2. 在创建的 *.chatprompt.md 文件中提供自定义聊天模式的说明和可用工具。
  3. 在聊天视图中，从聊天模式下拉列表中选择聊天模式。
  4. 提交您的聊天提示。

Screenshot of the custom chat mode selected in the Chat view.

以下示例显示了自定义“规划”聊天模式

---
description: Generate an implementation plan for new features or refactoring existing code.
tools: ['codebase', 'fetch', 'findTestFiles', 'githubRepo', 'search', 'usages']
---
# Planning mode instructions
You are in planning mode. Your task is to generate an implementation plan for a new feature or for refactoring existing code.
Don't make any code edits, just generate a plan.

The plan consists of a Markdown document that describes the implementation plan, including the following sections:

* Overview: A brief description of the feature or refactoring task.
* Requirements: A list of requirements for the feature or refactoring task.
* Implementation Steps: A detailed list of steps to implement the feature or refactoring task.
* Testing: A list of tests that need to be implemented to verify the feature or refactoring task.

注意：该功能仍在开发中，但请尝试一下！请关注 VS Code Insiders 中的最新进展，并告诉我们有什么问题或缺少什么。

任务诊断意识

当聊天代理运行任务时，它现在能够识别问题匹配器识别的任何错误或警告。这种诊断上下文允许聊天代理在出现问题时更智能地响应。

终端 cwd 上下文

当代理模式打开终端并且 Shell 集成处于活动状态时，聊天代理会感知当前工作目录 (cwd)。这使得命令支持更准确和上下文感知。

浮动窗口改进

当您将聊天会话移动到浮动窗口时，标题栏中现在有两个新操作可用

  • 将聊天停靠回其来源的 VS Code 窗口
  • 在浮动窗口中启动新的聊天会话。

Screenshot of the Chat view in a floating window, highlighting the Dock and New Chat buttons in the title bar.

获取工具确认

获取工具使您能够从网页中提取信息。我们已在确认消息中添加了警告消息，以告知您潜在的提示注入。

Screenshot of the fetch tool with a warning about prompt injection.

自定义更多内置工具

现在可以在代理模式或自定义模式中启用或禁用所有内置工具。例如，禁用 editFiles 以禁止代理模式直接编辑文件，或禁用 runCommands 以禁止运行终端命令。

在代理模式下，选择配置工具按钮以打开工具选择器，并选择所需的工具集。

Screenshot of the tool picker, showing the "editFiles" tool set item cleared.

此菜单中的某些条目表示分组多个工具的工具集。例如，我们为模型提供了多个工具来编辑或创建文本文件和笔记本，这些工具也可能因模型系列而异，而 editFiles 将所有这些工具分组在一起。

发送元素到聊天（实验性）

在上一个里程碑中，我们添加了一个新的实验性功能，您可以在其中打开简单浏览器并选择网页元素以从嵌入式浏览器添加到聊天中。

Screenshot showing the Live Preview extension, highlighting the overlay controls to select web elements from the web page.

随着我们继续改进此功能，我们还增加了对在实时预览扩展中选择网页元素的支持。通过下载该扩展并从任何 HTML 文件启动实时服务器来查看此功能。

辅助功能

需要用户操作声音

我们添加了一个辅助功能信号，以指示聊天何时需要用户操作。这是选择加入功能，因为我们正在微调声音。您可以使用accessibility.signals.chatUserActionRequired来配置此行为。

新的代码操作声音

我们为以下情况引入了不同的声音

代理模式辅助功能改进

我们现在在可访问视图中包含有关确认对话框的丰富信息，涵盖过去的工具运行、当前工具运行和任何待处理的确认。这包括将使用的输入。

当响应中出现确认对话框时，操作的标题现在包含在相应代码块的 ARIA 标签、响应的 ARIA 标签和实时警报中，以便为屏幕阅读器用户提供更好的上下文。

编辑器体验

即时查找

设置：editor.find.findOnType

即时查找一直是查找控件的默认行为，但现在您可以控制是否保持这种行为，或者禁用它，以便只在按 Enter 键后才执行搜索。

带有原生窗口标题栏的自定义菜单

设置：window.menuStyle

您现在可以使用window.menuStyle设置指定 Windows 和 Linux 上菜单栏和上下文菜单以及 macOS 上上下文菜单的菜单样式

  • native：由操作系统渲染
  • custom：由 VS Code 渲染
  • inherit：与 window.titleBarStyle 设置的标题栏样式匹配（允许您使用带有自定义菜单栏和上下文菜单的本机标题栏）。

Linux 原生窗口上下文菜单

现在，当您在自定义标题栏中右键单击应用程序图标时，我们支持原生窗口上下文菜单。

Screenshot of the native window context menu over the custom title bar.

进程资源管理器 Web 支持

进程资源管理器已转换为使用我们工作台中用于编辑器窗口的浮动窗口基础架构。因此，这也意味着我们现在在连接到远程（例如在 Codespaces 中）时支持 Web 中的进程资源管理器。

Screenshot of the VS Code process explorer in a floating window.

Windows Shell 环境发现

我们现在已经在 Windows 上为 PowerShell 实现了 Shell 环境发现。这意味着 VS Code 继承了 PowerShell 配置文件中配置的任何环境，例如 Node.js 通过各种版本管理器配置的 PATH 更新。

未发布扩展警告

已安装的扩展现在会在它们不再在 Marketplace 中可用时显示警告指示器，帮助您识别可能已取消发布或删除的问题扩展。

Screenshot of an extension with a warning indicator and a message indicating it's no longer available in the Marketplace.

设置搜索建议（预览）

设置：workbench.settings.showAISearchToggle

在此里程碑中，我们在设置编辑器中添加了一个切换开关，可启动 AI 搜索以查找语义相似的结果，而不是基于字符串匹配的结果。例如，当您搜索“增加文本大小”时，AI 搜索会找到 editor.fontSize 设置。

要查看切换开关，请启用该设置并重新加载 VS Code。我们还在识别和修复一些不太准确的设置搜索结果，我们欢迎您在自然语言查询未找到预期设置时提供反馈。

对于下一个里程碑，我们还在考虑删除切换开关，并将实验性设置更改为控制何时将较慢的 AI 搜索结果直接附加到列表末尾的设置。

搜索关键词建议（预览）

设置：search.searchView.keywordSuggestions

在上一个里程碑中，我们在搜索视图中引入了关键词建议，以帮助您更快地找到相关结果。我们现在显著提高了建议的性能，因此您将比以前快约 5 倍地看到结果。

我们还将设置从聊天扩展移至 VS Code 核心，并将其从 github.copilot.chat.search.keywordSuggestions 重命名为 search.searchView.keywordSuggestions。

语义搜索行为选项（预览）

设置：search.searchView.semanticSearchBehavior

通过搜索视图中的语义搜索，您可以根据查询的含义而不是仅仅匹配文本来获取结果。如果您不知道要搜索的确切术语，这尤其有用。

默认情况下，仅当您明确请求时才运行语义搜索。我们现在添加了一个设置来控制何时触发语义搜索

  • manual（默认）：仅当通过 UI 手动触发时才运行语义搜索（⌘I (Windows, Linux Ctrl+I)）
  • runOnEmpty：当文本搜索没有返回结果时自动运行语义搜索
  • auto：始终与文本搜索并行运行语义搜索，用于每个搜索查询

编辑上下文

设置：editor.editContext

我们已在稳定版中默认启用了editor.editContext设置。这意味着编辑器的输入现在由 EditContext API 提供支持。这修复了许多错误，尤其是与 IME 体验相关的错误，并且未来将为编辑器中更通用和更强大的输入体验铺平道路。

有关 EditContext API 的更多详细信息，请参阅MDN 文档。

代码编辑

NES 导入建议

设置：github.copilot.nextEditSuggestions.fixes

上个月，我们引入了对下一编辑建议的支持，以自动建议为 TypeScript 和 JavaScript 添加缺失的导入语句。在此版本中，我们改进了这些建议的准确性和可靠性，并将支持扩展到 Python 文件。

Screenshot showing NES suggesting an import statement.

NES 已为所有 VS Code Insiders 用户启用，并将于 6 月逐步默认启用稳定版用户。您可以随时通过其设置自行启用 NES。

NES 接受流程

现在，通过改进的键盘导航，接受下一编辑建议更加无缝。一旦您接受了一个建议，只要您没有再次开始输入，就可以通过单击 Tab 继续接受后续建议。一旦您开始输入，请按 Tab 将光标移动到下一个建议，然后才能接受它。

Notebook

代理单元格执行的跟随模式

设置：github.copilot.chat.notebook.followCellExecution.enabled

通过跟随模式，笔记本视图将自动滚动到代理当前正在执行的单元格。使用github.copilot.chat.notebook.followCellExecution.enabled设置可以在 Jupyter Notebooks 中启用或禁用代理单元格执行的跟随模式。

一旦代理使用了运行单元格工具，笔记本工具栏就会更新一个图钉图标，指示跟随模式的状态。您可以在代理响应过程中切换行为而无需更改基本设置值，从而允许您实时跟随代理的工作，并在您想要查看特定代码部分时将其关闭，而代理继续迭代。当您希望再次跟随时，只需切换模式，然后在下一次执行时加入。

代理模式的笔记本工具

配置笔记本

Jupyter 扩展提供了配置 Jupyter Notebook 内核的工具。此工具确保已选择内核并可用于 Notebook。这包括引导您完成在需要时创建虚拟环境（推荐方法）或提示您选择现有 Python 环境的过程。

此工具确保 LLM 可以通过最少的用户交互在 Notebook 上执行操作，从而改善代理模式下的整体用户体验。

长时间运行的代理工作流

代理可以访问一个内部笔记本摘要工具，以帮助其保持准确的上下文。当上下文变得太大而无法让代理继续执行复杂操作时，该摘要也会包含在对话历史记录的摘要中。

运行确认中的单元格预览

当代理请求确认运行笔记本单元格时，会显示该单元格的代码片段。聊天视图中的单元格链接现在也使您能够直接导航到笔记本中的单元格。

源代码管理

Copilot 编码代理集成

借助 Copilot 编码代理，GitHub Copilot 可以在后台独立工作以完成任务，就像人类开发人员一样。我们扩展了 GitHub Pull Requests 扩展，使其更容易在 VS Code 中分配和跟踪代理任务。

我们已向扩展添加了以下功能

  • 分配给 Copilot：从 VS Code 中的问题或 PR 视图将拉取请求或问题分配给 Copilot
  • Copilot 代表我 PR 查询：快速查看 Copilot 正在为您处理的所有拉取请求。
  • PR 视图：查看 Copilot 编码代理的状态并在浏览器中打开会话详细信息。

Screenshot showing the GitHub Pull Requests view, highlighting the assign to Copilot action, and the PR query for work assigned to Copilot.

源代码管理历史项详细信息

根据大众需求，现在选择源代码管理图表视图中的项目会显示该历史项目的资源。您可以从 ... 菜单中选择树视图或列表视图表示形式。

要在多文件差异编辑器中打开历史项的所有资源，请使用悬停时的打开更改操作。从图表视图中选择特定资源只会打开该资源的差异编辑器。选择打开文件操作以打开该特定版本的文件。

将历史项添加到聊天上下文

您现在可以将源代码管理历史项作为上下文添加到聊天请求中。当您希望将特定提交或拉取请求的内容作为聊天提示的上下文提供时，这会很有用。

Screenshot of the Chat view input box that has a history item added as context.

要将历史项添加到聊天中，请从聊天视图中使用添加上下文 > 源代码管理，然后选择特定的历史项。或者，右键单击源代码管理图表中的历史项，然后从上下文菜单中选择Copilot > 将历史项添加到聊天。

任务

实例策略

任务 runOptions 现在具有 instancePolicy 属性，该属性决定当任务达到其 instanceLimit 时会发生什么。

选项包括 prompt（默认）、silent、terminateNewest、terminateOldest 和 warn。

Screenshot showing an being configured in a file and displays the options with prompt as the default value.

终端

基于语言服务器的终端建议

语言服务器完成功能现在可在终端中用于交互式 Python REPL 会话。这使得您在编辑器中获得的相同语言完成功能现在可在终端中获得。我们首先支持通过 Pylance 实现 Python，并计划未来扩展到更多语言。

要试用，请确保启用以下设置

远程开发

远程开发扩展允许您使用开发容器、通过 SSH 的远程机器或远程隧道，或者适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。

亮点包括：

  • SSH 预连接脚本
  • 远程资源管理器改进

您可以在远程开发发行说明中了解有关这些功能的更多信息。

对扩展的贡献

Python

Python 聊天工具

Python 扩展现在包括以下聊天工具：“获取 Python 环境信息”、“获取 Python 环境可执行文件信息”、“安装 Python 包”和“配置 Python 环境”。您可以直接在提示中引用它们，方法是添加 #getPythonEnvironmentInfo #installPythonPackage，或者代理模式会在适用时自动调用该工具。这些工具根据文件或工作区上下文无缝检测适当的环境信息，并使用准确的环境解析处理包安装。

“配置 Python 环境”工具可确保为工作区正确设置 Python 环境。这包括在需要时创建虚拟环境，并将其选择为工作区的活动 Python 环境。

以前在Python 环境扩展（预览）中引入的工具已迁移到 Python 扩展，从而使所有安装了 Python 扩展的用户都可以使用这些工具。

从模板创建项目

Python 环境扩展现在支持为 Python 包和基本脚本创建项目，允许您跳过脚手架并更快地开始编码。使用命令Python Envs: Create Project from Template选择要创建包还是脚本。

对于包创建，您可以命名包，创建虚拟环境，并接收一个包含测试子文件夹、pyproject.toml、dev-requirements.txt 以及样板 __main__.py 和 __init__.py 文件的脚手架项目。

对于脚本，它会创建一个您选择名称的新 python 文件并包含样板代码。

PyEnv 和 Poetry 支持

我们在Python 环境扩展中添加了对 pyenv（用于环境管理）和 poetry（用于包和环境管理）的支持。

GitHub 拉取请求

GitHub Pull Requests 扩展取得了更多进展，该扩展使您能够处理、创建和管理拉取请求和问题。新功能包括

  • 现在在拉取请求文件注释中显示来自私有存储库的注释中的图像。
  • “通知”视图现在默认显示，已折叠。-- 时间线和问题/拉取请求正文中的问题和拉取请求链接现在在 VS Code 中打开，而不是转到浏览器。
  • “拉取请求”视图中的“分配给我”查询已删除，“本地拉取请求分支”和“所有打开”查询可以使用设置 githubPullRequests.queries 删除。对于带有 Copilot 的存储库，当设置未配置时，会添加“Copilot 代替我”查询。
  • Copilot 的“开始工作”、“停止工作”和“查看会话”现在显示在时间线中。

查看扩展 0.112.0 版本的更新日志以了解其他亮点。

扩展开发

MCP 扩展 API

扩展现在可以发布 MCP 服务器集合。这使您能够将 MCP 服务器与您的扩展捆绑在一起，或者构建从其他来源动态发现 MCP 服务器的扩展。在我们的MCP 扩展开发指南中了解更多信息，或者查看MCP 扩展示例。

打包扩展时的秘密扫描

VSCE 现在在打包您的扩展时扫描秘密。如果在您的源文件中检测到任何潜在的秘密（例如，API 密钥、令牌、凭据或环境变量文件，如 .env），VSCE 会在打包过程中显示错误。这有助于您避免意外地将敏感信息发布到 Marketplace。请务必在发布扩展之前审查并解决任何错误。

如果您需要绕过特定的检查，可以在运行 VSCE 时使用 --allow-package-secrets 或 --allow-package-env-file 标志。这些标志允许您配置在打包过程中应跳过哪些秘密或环境文件检查。

Web 环境检测

⚠️ 破坏性更改 ⚠️

设置：extensions.supportNodeGlobalNavigator

Node.js 扩展主机现已从 v20 更新到 v22，作为我们Electron 35 运行时更新的一部分。此更新带来了对桌面和远程扩展主机中 navigator 全局对象的支持。

此更改可能会为依赖于 navigator 对象存在以检测 Web 环境的扩展引入破坏性更改。

为了帮助扩展作者迁移，我们为 globalThis.navigator 创建了一个 polyfill，它被初始化为 undefined，因此您的扩展可以继续正常工作。polyfill 位于 extensions.supportNodeGlobalNavigator VS Code 设置后面。默认情况下，此设置已禁用，并且 polyfill 已就位。当您的扩展尝试以这种方式访问 navigator 时，我们会捕获遥测并记录错误（在扩展开发模式下）。

将来，此设置可能会默认启用，因此我们敦促扩展作者将其代码迁移以与新的 navigator 全局对象兼容。请按照以下步骤迁移您的代码

  • 检查扩展主机日志中是否存在源自您的扩展的 PendingMigrationError。
  • 确保 typeof navigator === 'object' 等检查根据需要迁移到 typeof process === 'object' && process.versions.node。
  • 启用 extensions.supportNodeGlobalNavigator。
  • 验证扩展行为是否保持不变。

提议的 API

身份验证提供程序：MCP 支持的授权服务器

目前仅在MCP 身份验证中利用，此 API 提案允许您的 AuthenticationProvider 声明与其关联的授权服务器。

例如，如果您查看 GitHub 身份验证提供程序，它在身份验证提供程序贡献的 authorizationServerGlobs 属性中包含典型的 GitHub 授权 URL

{
  "label": "GitHub",
  "id": "github",
  "authorizationServerGlobs": ["https://github.com/login/oauth"]
}

此属性用于激活您的扩展 - 如果请求的授权服务器匹配，您的扩展将被激活。

此外，在注册身份验证提供程序时，您必须包含最终确定的授权服务器 URL glob。就像GitHub 身份验证在此处所做的一样

vscode.authentication.registerAuthenticationProvider(
  type,
  this._githubServer.friendlyName,
  this,
  {
    supportsMultipleAccounts: true,
    supportedAuthorizationServers: [
      ghesUri ?? vscode.Uri.parse('https://github.com/login/oauth')
    ]
  }
);

对于更复杂的示例，请查看 Microsoft 身份验证。授权服务器取决于租户是否放在路径中。因此，对于这种情况，我们在贡献中使用通配符

{
  "label": "Microsoft",
  "id": "microsoft",
  "authorizationServerGlobs": [
    "https://login.microsoftonline.com/*/v2.0"
  ]
},

以及在注册中

authentication.registerAuthenticationProvider('microsoft', 'Microsoft', authProvider, {
  supportsMultipleAccounts: true,
  supportedAuthorizationServers: [Uri.parse('https://login.microsoftonline.com/*/v2.0')]
});

然后，当调用方在请求身份验证时传入授权服务器 URL 时，它会通过已存在的 AuthenticationProviderSessionOptions 传递给 getSessions 和 createSession 函数。

如前所述，此功能目前用于 MCP 支持，我们从 MCP 服务器接收用于身份验证的授权服务器 URL。然后，该 URL 会映射到身份验证提供程序，如果不存在，则会为该身份验证服务器动态创建一个身份验证提供程序。

完整的 API 提案可在 vscode 存储库中找到，我们很高兴在 GitHub 问题中听到您的反馈！

工程

Electron 35 更新

在此里程碑中，我们将 Electron 35 更新推广给稳定版用户。此更新附带 Chromium 134.0.6998.205 和 Node.js 22.15.1。我们要感谢所有在 Insider 版本上自托管并提供早期反馈的人。

在实际扩展中采用 ESM

上一个里程碑，我们宣布了对 JavaScript 模块 (ESM) 的支持。这使得扩展可以使用 import 和 export 语句，但目前仅在针对 NodeJS 扩展主机时。

本月，我们对 GitHub Issue Notebooks 进行了实际采用。这并非易事，因为此扩展可以在 NodeJS 扩展主机（支持 ESM 扩展）和 Web 工作程序扩展主机中运行，而 Web 工作程序扩展主机目前不支持 ESM 扩展。这需要更复杂的打包器配置，您可能希望从其 esbuild-config 中获取灵感。

值得注意的修复

  • 250077 - 基于 Tree-Sitter 的语法高亮取决于模型服务

感谢

最后但同样重要的是，向 VS Code 的贡献者们致以衷心的感谢。

问题跟踪

对我们问题跟踪的贡献

拉取请求

对 vscode 的贡献

对 vscode-copilot-release 的贡献

对 vscode-css-languageservice 的贡献

对 vscode-custom-data 的贡献

对 vscode-eslint 的贡献

对 vscode-generator-code 的贡献

对 vscode-js-debug 的贡献

对 vscode-jupyter 的贡献

对 vscode-languageserver-node 的贡献

对 vscode-markdown-tm-grammar 的贡献

对 vscode-prompt-tsx 的贡献

对 vscode-pull-request-github 的贡献

对 vscode-python-debugger 的贡献

对 debug-adapter-protocol 的贡献

对 language-server-protocol 的贡献

对 lsprotocol 的贡献