参加你附近的 ,了解 VS Code 中的 AI 辅助开发。

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 上的更新Insiders:想尽快尝试新功能吗?您可以下载每晚Insiders版本并尽快尝试最新更新。

聊天

聊天工具集

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 服务器设置调试器。目前,我们仅支持调试分别使用nodepython启动的 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.

获取工具确认

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

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.

随着我们继续改进此功能,我们还在Live Preview 扩展程序中添加了选择网页元素的支持。通过下载该扩展程序并从任何 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

我们已在 Stable 版中默认启用了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 月逐步默认启用 Stable 用户。您可以随时通过其设置自行启用 NES。

NES 接受流程

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

Notebook

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

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

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

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

代理模式的笔记本工具

配置笔记本

Jupyter 扩展程序提供了用于配置 Jupyter 笔记本内核的工具。此工具确保已选择内核并已准备好在笔记本中使用。这包括在需要时引导您完成创建虚拟环境的过程(推荐方法),或提示您选择现有的 Python 环境。

此工具确保 LLM 可以在最少的用户交互下对笔记本执行操作,例如运行单元格,从而提高代理模式下的整体用户体验。

长时间运行的代理工作流

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

运行确认中的单元格预览

当代理请求确认运行该单元格时,会显示笔记本单元格的代码片段。聊天视图中的单元格链接现在还可以让您直接导航到笔记本中的单元格。

源代码管理

Copilot 编码代理集成

借助 Copilot 编码代理,GitHub Copilot 可以在后台独立工作以完成任务,就像人类开发人员一样。我们扩展了 GitHub 拉取请求扩展程序,使其更容易在 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(默认)、silentterminateNewestterminateOldestwarn

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 环境:从模板创建项目”来选择要创建包还是脚本。

对于包创建,您可以命名包,创建虚拟环境,并接收一个包含测试子文件夹、pyproject.tomldev-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 <secret_type>--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传递给getSessionscreateSession函数。

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

完整的 API 提案可在vscode 存储库中找到,我们很乐意在GitHub 问题中听取您的反馈!

工程

Electron 35 更新

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

在真实世界扩展中采用 ESM

上个月,我们宣布了对 JavaScript 模块 (ESM) 的支持。这使扩展能够使用importexport语句,但目前仅当面向 NodeJS 扩展主机时。

本月,我们通过GitHub Issue Notebooks进行了真实世界的采用。这并非易事,因为此扩展程序可以在 NodeJS 扩展主机(支持 ESM 扩展程序)和 Web Worker 扩展主机(目前不支持 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的贡献