2025 年 5 月(版本 1.101)

发布日期:2025 年 6 月 12 日

安全更新:以下扩展程序包含安全更新:ms-python.python

更新 1.101.1:此更新解决了这些问题

更新 1.101.2:此更新解决了这些问题

下载:Windows:x64 Arm64 | Mac:通用 Intel Silicon | Linux:deb rpm tarball Arm snap


欢迎阅读 Visual Studio Code 2025 年 5 月版更新。此版本包含许多我们希望您会喜欢的内容,以下是一些主要亮点:

  • MCP

    • 通过对提示词 (prompts)、资源 (resources) 和采样 (sampling) 的支持,扩展您的代理编码流程(了解详情)。
    • 访问需要身份验证的 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 服务器可以定义提示词,以便为语言模型生成可重用的片段或任务。在聊天中,提示词可通过斜杠 / 命令访问,格式为 /mcp.servername.promptname。您可以输入纯文本或在提示词变量中包含命令输出,我们还支持在服务器提供相关内容时进行补全。

以下示例展示了我们如何使用 AI 生成提示词,使用 Gistpad MCP 服务器将其保存,然后用它来生成更新日志条目。

MCP 对资源的支持

VS Code 的 MCP 支持现在包含资源支持,其中包括对资源模板的支持。它在多个地方可用:

  1. 从 MCP 工具调用返回的资源可供模型使用,并可通过“保存”按钮或将资源拖动到资源管理器视图中保存到聊天中。
  2. 资源可以通过聊天中的“添加上下文...”按钮进行附加,然后选择“MCP 资源...”。
  3. 您可以使用“MCP:浏览资源”命令浏览和查看跨服务器的资源,或者通过“MCP:列出服务器”命令查看特定服务器的条目。

这是一个从 Gistpad MCP 服务器向聊天附加资源的示例。

MCP 对采样(实验性)的支持

VS Code 的 MCP 支持现在包含采样,允许 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 修复”操作来快速高效地解决这些问题。

自定义聊天模式(预览)

默认情况下,聊天视图支持三种内置聊天模式:询问 (Ask)、编辑 (Edit) 和代理 (Agent)。每种聊天模式都带有一组基本说明,描述 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 对所有这些工具进行了分组。

发送元素到聊天(实验性)

在上一个里程碑中,我们添加了一项新的实验性功能,您可以打开 Simple Browser 并选择 Web 元素以添加到嵌入式浏览器的聊天中。

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

随着我们继续改进此功能,我们现在也添加了对在 Live Preview 扩展程序中选择 Web 元素的支持。下载该扩展程序并从任何 HTML 文件启动实时服务器即可尝试。

辅助功能

用户操作所需声音

我们添加了一个辅助功能信号,用于指示聊天何时需要用户操作。由于我们仍在调整声音效果,此功能默认为关闭。您可以使用 accessibility.signals.chatUserActionRequired ... 来配置此行为。

新的代码操作声音

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

  • 触发代码操作时:...
  • 应用代码操作时:...

代理模式辅助功能改进

我们现在在辅助功能视图中包含有关确认对话框的丰富信息,涵盖过去的工具运行、当前的工具运行以及任何待处理的确认。这包括将要使用的输入内容。

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

编辑器体验

输入时查找

设置...

“输入时查找”一直是“查找”控件的默认行为,但现在您可以控制是保持此状态,还是将其禁用,以便仅在按下回车键后才执行搜索。

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

设置...

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

  • native:由操作系统渲染。
  • custom:由 VS Code 渲染。
  • inherit:与 ... 设置的标题栏样式匹配(允许您将原生标题栏与自定义菜单栏和上下文菜单结合使用)。

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.

设置搜索建议(预览)

设置...

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

要查看此开关,请启用该设置并重载 VS Code。我们目前正在修复一些不够准确的设置搜索结果,欢迎您反馈自然语言查询未能找到预期设置的情况。

在下一个里程碑中,我们正在考虑移除该开关,并将实验性设置更改为控制何时直接将较慢的 AI 搜索结果附加到列表末尾的设置。

搜索关键字建议(预览)

设置...

上一个里程碑中,我们在搜索视图中引入了关键字建议以帮助您更快找到相关结果。现在,我们显著提高了建议的性能,搜索结果的呈现速度比以前快约 5 倍。

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

语义搜索行为选项(预览)

设置...

借助搜索视图中的语义搜索,您可以获得基于查询含义而非仅匹配文本的结果。如果您不知道要搜索的确切术语,这尤其有用。

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

  • manual(默认):仅在从 UI 手动触发时运行语义搜索(⌘I (Windows, Linux Ctrl+I))。
  • runOnEmpty:当文本搜索未返回任何结果时,自动运行语义搜索。
  • auto:对于每次搜索查询,始终与文本搜索并行运行语义搜索。

编辑上下文

设置...

我们在稳定版中默认启用了 ... 设置。这意味着编辑器输入现在由 EditContext API 提供支持。这修复了许多错误,特别是在 IME 体验方面,并为未来在编辑器中实现更多功能和更稳健的输入体验铺平了道路。

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

代码编辑

NES 导入建议

设置...

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

Screenshot showing NES suggesting an import statement.

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

NES 接受流程

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

Notebook

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

设置...

通过跟随模式,笔记本视图将自动滚动到当前由代理执行的单元格。使用 ... 设置在 Jupyter 笔记本中启用或禁用代理单元格执行的跟随模式。

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

代理模式的笔记本工具

配置笔记本

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

此工具确保 LLM 能够在笔记本上执行操作(例如运行单元格),而无需过多用户交互,从而改善代理模式下的整体用户体验。

长期运行的代理工作流程

代理可以访问内部“笔记本摘要”工具,以帮助保持准确的上下文。当上下文变得太大以至于无法让代理进行复杂操作时,该摘要也会在汇总对话历史记录时被包含在内。

运行确认中的单元格预览

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

源代码管理

Copilot 编码代理集成

借助 Copilot 编码代理,GitHub Copilot 可以在后台独立工作以完成任务,就像人类开发人员一样。我们扩展了 GitHub Pull Requests 扩展程序,以便更轻松地在 VS Code 内分配和跟踪代理任务。

我们向扩展程序添加了以下功能:

  • 分配给 Copilot:从 VS Code 中的问题或 PR 视图将拉取请求或问题分配给 Copilot。
  • Copilot on My Behalf 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,并计划在未来扩展到更多语言。

要进行尝试,请确保启用了以下设置:

  • terminal.integrated.shellIntegration.enabled 在 VS Code 中打开 在 VS Code Insiders 中打开
  • python.terminal.shellIntegration.enabled 在 VS Code 中打开 在 VS Code Insiders 中打开
  • terminal.integrated.suggest.enabled 在 VS Code 中打开 在 VS Code Insiders 中打开
  • python.analysis.supportAllPythonDocuments 在 VS Code 中打开 在 VS Code Insiders 中打开

远程开发

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

亮点包括:

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

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

对扩展的贡献

Python

Python 聊天工具

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

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

之前在 Python 环境扩展(预览)中引入的工具已迁移到 Python 扩展中,从而使安装了 Python 扩展的所有用户都能使用这些工具。

从模板创建项目

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

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

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

PyEnv 和 Poetry 支持

我们在 Python 环境扩展中添加了对 pyenv(环境管理)和 poetry(包和环境管理)的支持。

GitHub 拉取请求

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

  • 私有仓库注释中的图像现在显示在拉取请求文件注释中。
  • “通知”视图现在默认折叠显示。-- 时间轴以及问题/拉取请求正文中的问题和拉取请求链接现在在 VS Code 中打开,而不是跳转到浏览器。
  • 已删除“拉取请求”视图中的“分配给我”查询,并且可以使用设置 githubPullRequests.queries 删除“本地拉取请求分支”和“所有打开的”查询。对于带有 Copilot 的仓库,当设置未配置时会添加“Copilot on My Behalf”查询。
  • 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 环境检测

⚠️ 重大变更 ⚠️

设置...

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

此更改可能会为依赖 navigator 对象存在性来检测 Web 环境的扩展引入重大变更。

为了帮助扩展作者迁移,我们创建了一个初始化为 undefinedglobalThis.navigator polyfill,以便您的扩展程序继续正常工作。该 polyfill 位于 ... VS Code 设置之后。默认情况下,此设置处于禁用状态且 polyfill 已到位。当您的扩展程序尝试以这种方式访问 navigator 时,我们会在扩展开发模式下捕获遥测数据并记录错误。

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

  • 检查扩展主机日志中是否有堆栈跟踪源自您扩展程序的 PendingMigrationError
  • 确保根据需要将类似 typeof navigator === 'object' 的检查迁移到 typeof process === 'object' && process.versions.node
  • 启用 ...
  • 验证扩展行为保持不变。

提议的 API

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

此 API 建议目前仅在 MCP 身份验证中利用,它使您的 AuthenticationProvider 能够声明与其关联的授权服务器。

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

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

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

此外,在注册身份验证提供程序时,您必须包含定稿的授权服务器 URL 全局变量。就像 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 issue 中听到您的反馈!

工程

Electron 35 更新

在此里程碑中,我们将 Electron 35 更新推广到稳定版用户。此更新随 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 的贡献

© . This site is unofficial and not affiliated with Microsoft.