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

2024 年 11 月 (版本 1.96)

更新 1.96.1:此更新解决了这些问题,并启用了GitHub Copilot 免费计划

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

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

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

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


欢迎使用 Visual Studio Code 2024 年 11 月发布版。此版本中有许多更新,我们希望您会喜欢,其中一些主要亮点包括:

如果您想在线阅读这些发行说明,请访问 code.visualstudio.com 上的更新Insiders:想尽快试用新功能吗?您可以下载每日Insiders 版本,并在可用时立即试用最新更新。

GitHub Copilot

GitHub Copilot 免费计划

我们很高兴地宣布全新的 GitHub Copilot 免费层级。注册GitHub Copilot 免费计划,您只需要一个 GitHub 帐户。您每月有一定数量的完成和聊天交互,每月重置。

您可以直接在 VS Code 中注册。按照Copilot 设置指南中的步骤操作。

Chat view shows the Copilot message and a button that enables you to sign in to use Copilot.

了解有关Copilot 免费计划详细信息和条件的更多信息。

Copilot 编辑

上一个里程碑,我们引入了Copilot Edits(目前处于预览版),它允许您使用自然语言一次性快速编辑多个文件。从那时起,我们不断迭代体验。您可以通过在命令中心打开 Copilot 菜单,然后选择“打开 Copilot Edits”,或者通过触发 来尝试 Copilot Edits。

进度和编辑器控件

Copilot Edits 可以对不同文件进行多项更改。您现在可以更清楚地看到其进度,因为编辑会流式传输。通过编辑器叠加控件,您可以轻松地循环查看所有更改并接受或丢弃它们。

将聊天会话移动到 Copilot Edits

您可以使用“聊天”视图探索对代码进行更改的一些想法。现在,您无需应用单个代码块,而是可以将聊天会话移动到 Copilot Edits,以应用会话中的所有代码建议。

Edit with Copilot showing for a chat exchange.

工作集建议文件

在 Copilot Edits 中,工作集确定 Copilot Edits 可以建议更改的文件。为了帮助您将相关文件添加到工作集,对于 Git 存储库,Copilot Edits 现在可以根据您已添加的文件建议其他文件。例如,Copilot Edits 将建议经常与您已添加的文件一起更改的文件。

Copilot 在工作集中的“添加文件”按钮旁边显示建议的文件。您还可以选择“添加文件”,然后选择“相关文件”从建议文件列表中进行选择。

重启后恢复编辑会话

重启 VS Code 后,编辑会话现在会完全恢复。这包括工作集、接受状态以及所有过去编辑步骤的文件状态。

从资源管理器、搜索和编辑器添加到工作集

您可以使用新的“将文件添加到 Copilot Edits”上下文菜单操作,将文件添加到 Copilot Edits 工作集,该操作适用于“搜索”视图中的搜索结果和“资源管理器”视图中的文件。此外,您还可以从编辑器上下文菜单中将文本选择附加到 Copilot Edits。

Add a file from the explorer view to Copilot Edits

使用 Copilot 调试

配置调试可能很棘手,尤其是在处理新项目或语言时。在此里程碑中,我们引入了一个新的 copilot-debug 终端命令,可帮助您使用 VS Code 调试程序。您可以通过在通常运行的命令前面加上 copilot-debug 来使用它。例如,如果通常使用命令 python foo.py 运行程序,现在可以运行 copilot-debug python foo.py 来启动调试会话。

程序退出后,系统会提供重新运行程序或查看、保存或重新生成用于调试程序的 VS Code 启动配置的选项。

终端显示调试会话后重新运行、重新生成、保存或启动配置的选项。 主题:Codesong(在vscode.dev上预览)

任务支持

Copilot 的调试功能,包括 copilot-debug/startDebugging 意图,现在根据需要为在调试前需要编译步骤的代码生成 preLaunchTask。对于 Rust 和 C++ 等编译语言,通常是这种情况。

添加上下文

我们添加了新的方法,可以将符号和文件夹作为上下文包含在 Copilot Chat 和 Copilot Edits 中,从而更轻松地在工作流中引用相关信息。

符号

现在可以通过将符号从“大纲”视图或“面包屑”拖放到“聊天”视图中,轻松地将符号添加到 Copilot Chat 和 Copilot Edits 中。

我们还在聊天输入中引入了符号完成功能。通过键入 # 加上符号名称,您将看到您最近处理过的文件中的符号建议。

要引用整个项目中的符号,可以使用 #sym 打开全局符号选择器。

文件夹

现在可以通过将文件夹从资源管理器、面包屑或其他视图拖放到 Copilot Chat 中来添加它们作为上下文。

将文件夹拖放到 Copilot Edits 中时,文件夹中的所有文件都将包含在工作集中。

Copilot 使用情况图

VS Code 扩展可以使用 VS Code API 构建 Copilot 的功能。您现在可以在“运行时状态”视图中查看扩展的 Copilot 使用情况图。此图显示了该扩展在过去 30 天内发出的聊天请求数量。

Copilot usage graph in the Runtime Status view

提交消息生成的自定义说明

Copilot 可以帮助您根据所做的更改生成提交消息。在此里程碑中,我们添加了在生成提交消息时支持自定义说明的功能。例如,如果您的提交消息需要遵循特定格式,您可以在自定义说明中描述这一点。

您可以使用 github.copilot.chat.commitMessageGeneration.instructions 设置来指定自定义说明,或指定工作区中包含自定义说明的文件。这些说明将附加到用于生成提交消息的提示。获取有关如何使用自定义说明的更多信息。

内联聊天

在此里程碑中,我们进一步改进了内联聊天的用户体验:我们使进度报告更加微妙,同时禁用流式传输更改波浪线,并更漂亮地呈现检测到的命令。

此外,我们继续改进了伪代码检测,现在显示一个提示,当一行主要是自然语言时,您可以继续使用内联聊天。此功能允许您在编辑器中键入伪代码,然后将其用作内联聊天的提示。您还可以通过按 ⌘I (Windows, Linux Ctrl+I) 触发此流程。

Inline Chat hint for a line that is dominated by natural language.

此外,还有一个新的实验性设置,用于在空行上显示内联聊天提示。此设置可以通过 inlineChat.lineEmptyHint 启用。默认情况下,此设置是禁用的。

终端聊天

终端内联聊天焕然一新,外观和感觉更接近编辑器内联聊天。

Terminal inline chat looks a lot like editor chat now

以下是一些其他值得注意的改进:

  • 小部件的布局和定位得到改进,并且通常表现更好
  • 有一个模型选择器
  • 底部的按钮现在更加一致

@workspace 的性能改进

当您使用 @workspace 询问 Copilot 有关您当前打开的工作区时,我们首先需要将工作区缩小到一组相关的代码片段,我们可以将其作为上下文交给 Copilot。如果您的工作区由 GitHub 存储库支持,我们可以通过使用 GitHub 代码搜索快速找到这些相关的片段。但是,由于代码搜索索引跟踪存储库的主分支,我们无法将其用于本地更改或在分支上时。

在此里程碑中,我们努力将 GitHub 搜索的速度优势带到分支和拉取请求。这意味着我们现在搜索基于存储库主分支的远程索引,并搜索任何本地更改的文件。然后,我们将这些结果合并在一起,为 Copilot 提供一组快速且最新的片段。您可以阅读有关 GitHub 代码搜索以及如何启用它的更多信息。

辅助功能

代码操作可访问性信号

一些代码操作可能需要很长时间才能完成,例如调用外部服务生成图像 alt 文本的快速修复。它们何时触发或何时完全应用可能不明显。因此,我们添加了可访问性信号来指示代码操作已触发或已应用。

您可以使用 accessibility.signals.codeActionTriggeredaccessibility.signals.codeActionApplied 设置启用这些信号。

REPL 中的自动焦点管理

我们引入了一个新设置,以改善在 REPL 中工作时的可访问性。通过 accessibility.replEditor.autoFocusReplExecution,您现在可以指定每当执行代码时,焦点是保持不变 (none)、移动到输入框 (input) 还是转移到最近执行的单元格 (lastExecution)。默认情况下,焦点移动到输入框。

工作台

改进的扩展搜索结果

当您在“扩展”视图中使用自由格式文本搜索扩展时,已安装的扩展现在会显示在搜索结果的顶部。这使得在通过 Marketplace 搜索时更容易查找和管理已安装的扩展。

Installed extensions shown at top of search results.

从“扩展”视图下载扩展

您现在可以通过在“扩展”视图中扩展的上下文菜单中使用下载操作,直接从 VS Code 下载扩展。如果您想下载扩展而不安装它,这可能很有用。

Context menu option to download an extension from the Extensions view.

扩展磁盘空间

您现在可以在“扩展编辑器”中查看扩展在磁盘上的内存使用情况。这可以帮助您了解扩展正在使用多少磁盘空间。

Extension memory usage on disk shown in the Extensions view.

资源管理器中的查找改进

在 9 月发布版中,我们引入了在整个项目中查找文件的功能,这在以前是不可用的。但是,此更新暂时删除了高亮显示模式并限制了某些操作。

在此版本中,我们重新引入了高亮显示模式。此功能允许您轻松定位工作区中的文件和文件夹,并高亮显示匹配结果以提高可见性。此外,我们还在折叠的文件夹上引入了一个新的视觉指示器,显示其中是否隐藏了匹配项。

筛选器切换仍然可用,使您能够通过隐藏不匹配项来仅关注与查询匹配的文件和文件夹。我们还重新启用了之前版本中不得不禁用的所有上下文菜单操作。

我们还改进了使用查找控件时的用户体验。当滚动到文件资源管理器的顶部时,会在顶部创建额外的空间,确保控件不会阻碍您的搜索结果。

The find control is rendered above the first file or folder in the explorer when scrolled to the top.

在主侧边栏和辅助侧边栏之间移动视图

您已经可以通过拖放或使用“移动视图”命令将视图容器移动到另一个位置。您现在可以直接在视图容器上使用“移动到”上下文菜单操作,以在主侧边栏、辅助侧边栏或面板区域之间移动它。

在标题区域隐藏导航控件

有些人喜欢尽可能保持标题区域整洁。我们添加了一个新设置 workbench.navigationControl.enabled,可让您隐藏标题区域中的后退/前进按钮。

您还可以通过右键单击标题区域并选择“导航控件”来访问此设置。

Navigation Controls context menu when right-clicking the VS Code title area.

编辑器

配置粘贴和拖放行为

当您将文件拖放或复制粘贴到文本编辑器中时,VS Code 提供了多种将其插入到该文件中的方法。默认情况下,VS Code 会尝试插入文件的相对于工作区的路径。现在,您可以使用拖放/粘贴控件来切换资源的插入方式。扩展还可以提供自定义编辑,例如在 Markdown 中,它提供插入 Markdown 链接的编辑

通过新的 editor.pasteAs.preferenceseditor.dropIntoEditor.preferences 设置,您现在可以为默认使用的编辑类型指定偏好。例如,如果您希望复制/粘贴始终插入粘贴文件的绝对路径,只需设置

"editor.pasteAs.preferences": [
    "uri.path.absolute"
]

这些设置是编辑类型的有序列表。默认情况下应用首选类型的第一个匹配编辑。在应用默认编辑后,您仍然可以使用拖放/粘贴控件更改为不同类型的编辑。

这些新设置与我们JavaScript 和 TypeScript 中新的复制和粘贴导入支持完美配合。此功能在 JavaScript 或 TypeScript 文件之间复制和粘贴代码时自动添加导入。为了避免中断您的工作流,默认情况下,我们决定粘贴只插入纯文本,而 paste with imports 则作为粘贴控件中的一个选项提供。但是,如果您希望 VS Code 始终尝试使用导入粘贴,只需设置

"editor.pasteAs.preferences": [
    "text.updateImports"
]

现在,VS Code 会自动尝试在可能的情况下使用导入粘贴,如果无法使用导入粘贴,则回退到粘贴纯文本。目前,这仅适用于 JavaScript 和 TypeScript,但我们希望随着时间的推移,其他语言也会采用此支持。

最后,您现在还可以在设置 editor.action.pasteAs 键绑定时指定首选的粘贴样式。下面的键绑定将始终尝试粘贴和更新导入:

{
  "key": "ctrl+shift+v",
  "command": "editor.action.pasteAs",
  "args": {
    "preferences": ["text.updateImports"]
  }
}

保留编辑器查找历史

“查找”控件现在可以跨会话保留搜索历史,并在 VS Code 重启后恢复。搜索历史按工作区存储,可以通过 editor.find.history 设置禁用。

覆盖模式

您知道 VS Code 不支持在编辑器中覆盖文本,除非您安装了 Vim 键映射吗?根据普遍要求,我们现在添加了覆盖模式,以便在键入时覆盖编辑器中的文本而不是插入。一个有用的场景是在编辑 Markdown 表格时,您希望表格单元格边界保持良好对齐。

此模式可以通过命令“视图:切换覆盖/插入模式”或使用键盘上的 Insert 键进行切换。当您处于覆盖模式时,“状态栏”会显示 OVR 指示器。

在覆盖模式下,可以使用 editor.overtypeCursorStyle 设置更改光标样式。此外,还有一个设置 editor.overtypeOnPaste,它确定在覆盖模式下粘贴是覆盖还是插入。默认行为是插入粘贴的文本。

源代码管理

Git blame 信息(实验性)

在此里程碑中,我们添加了实验性支持,可以使用编辑器装饰和状态栏项显示 blame 信息。您可以通过使用 git.blame.editorDecoration.enabledgit.blame.statusBarItem.enabled 设置启用此功能。您可以将鼠标悬停在 blame 信息上以查看更多提交详细信息。

您可以使用 git.blame.editorDecoration.templategit.blame.statusBarItem.template 设置自定义编辑器和状态栏中显示的消息格式。您可以为最常见的信息使用变量。例如,以下模板显示提交的主题、作者姓名以及作者的相对日期:

{
  "git.blame.editorDecoration.template": "${subject}, ${authorName} (${authorDateAgo})"
}

如果您想调整编辑器装饰的颜色,请使用 git.blame.editorDecorationForeground 主题颜色。

尝试此实验性功能,并告诉我们您的想法。

源代码管理图标题操作

根据用户反馈,我们已将“拉取”和“推送”操作带回“源代码管理图”视图标题栏。如果当前历史记录项引用显示在“源代码管理图”中,则这些操作将启用。

如果您不想使用这些操作,或源代码管理图视图标题栏中的任何其他操作,可以右键单击标题栏并隐藏它们。

Source Control Graph title actions and context menu to hide specific items.

Notebook

跨单元格选择高亮显示

现在在笔记本中支持选择高亮显示,允许跨多个单元格进行基于文本选择的高亮显示。这由现有设置 editor.selectionHighlight 控制。

多光标:选择所有查找匹配项

笔记本现在支持“选择所有查找匹配项”的键盘快捷键。这可以通过命令 ID notebook.selectAllFindMatches 找到,并且可以使用默认的击键 ⇧⌘L (Windows, Linux Ctrl+Shift+L) 使用。

在 Markdown 中运行部分中的单元格

笔记本现在已将“运行部分中的单元格”操作公开到 Markdown 单元格的单元格工具栏。如果 Markdown 单元格有标题,则执行该部分和子部分中包含的所有单元格。如果没有标题,则在可能的情况下执行周围部分中的所有单元格。

单元格执行时间详细程度

单元格状态栏中的执行时间信息现在有一个选项可以增加详细程度。这可以通过设置 notebook.cellExecutionTimeVerbosity 打开,并且除了持续时间外,还可以显示执行时间戳。

Verbose cell execution time within cell status bar.

终端

连字支持

现在终端支持连字,无论是否使用GPU 加速。此功能可以通过设置 terminal.integrated.fontLigatures 打开。

Fonts that support ligatures like ->, ==>, and so on will now visually look like single characters

要使用此功能,请确保您还使用支持连字的字体 terminal.integrated.fontFamily

用于自定义终端标签页的新变量

终端标签页中显示的文本由 terminal.integrated.tabs.titleterminal.integrated.tabs.description 设置决定,这些设置允许使用一组变量。我们现在支持以下新变量:

  • ${shellType} - 终端中使用的 shell 的检测类型。这类似于默认值,但它不会在运行 git 命令时更改为 git,例如。

  • ${shellCommand} - 正在终端中运行的命令。这需要shell 集成

    alt text

  • ${shellPromptInput} - 正在终端中运行的命令或当前检测到的提示输入。这需要shell 集成

    Typing "echo hello" in the terminal will show "echo hello|" in the tab when configured

运行最近的命令现在显示历史源文件

运行最近的命令 shell 集成功能现在包括命令源的完整大小标题,包括相关的历史文件以及一个方便的按钮来打开它。

alt text

此命令的默认键绑定是 Ctrl+Alt+R

格式为 /path/to/file.ext, 的链接现在应在终端中被检测为链接。

测试

可归因覆盖率

在此里程碑中,我们最终确定了一个 API,使扩展能够提供基于每个测试的覆盖率,这样您就可以准确地看到任何给定测试执行了哪些代码。当可归因覆盖率可用时,在“测试覆盖率”视图中、编辑器操作中、切换到“测试覆盖率”工具栏时(通过“测试:测试覆盖率工具栏”命令)或者只需使用“测试:按测试筛选覆盖率”命令,即可使用筛选按钮。

主题:Codesong(在vscode.dev上预览)

重新设计的内联失败消息

我们重新设计了测试失败消息,使其既更引人注目又更不显眼。这对于繁忙的场景特别有用,例如在 SCM 或 Copilot Edits 的差异中。选择失败消息仍然会打开一个预览控件,以显示失败的完整详细信息。

Image of new test error messages in the editor.

持续运行 UI 的改进

以前,持续测试运行的全局状态(可通过“测试资源管理器”视图中的“眼睛”图标切换)将打开或关闭使用默认运行配置文件的持续运行。

我们重新设计了持续运行 UI,以包含一个下拉菜单,用于按配置文件单独打开或关闭持续运行。选择指示器将打开或关闭上次使用的运行配置文件集。

语言

TypeScript 5.7

我们的 JavaScript 和 TypeScript 支持现在使用 TypeScript 5.7。此主要更新包括许多语言和工具改进,以及重要的错误修复和性能优化。

您可以在 TypeScript 博客上阅读有关 TypeScript 5.7 发布的所有信息。我们还在以下部分中包含了一些工具亮点。

JavaScript 和 TypeScript 的粘贴导入

厌倦了在文件之间移动代码后不得不添加导入?试试 TypeScript 5.7+ 的粘贴导入功能。现在,无论何时在 JavaScript 或 TypeScript 之间复制和粘贴代码,VS Code 都可以为粘贴的代码添加导入。

请注意,不仅添加了导入,甚至还为粘贴代码中使用的局部变量添加了一个新的导出!

虽然我们认为此功能可以节省大量时间,但我们也对中断您现有工作流感到敏感。这就是为什么默认情况下,我们保留了复制和粘贴始终只插入粘贴文本。如果 paste with imports 编辑可用,您将看到粘贴控件,它允许您选择 paste with imports 编辑。

Paste control that shows options to insert plain text or paste with imports.

如果您更喜欢始终使用导入粘贴,可以使用新的editor.pasteAs.preferences 设置

"editor.pasteAs.preferences": [
    "text.updateImports"
]

如果编辑可用,这将始终尝试使用导入粘贴。

您还可以设置一个键绑定以在可用时使用导入粘贴:

{
  "key": "ctrl+shift+v",
  "command": "editor.action.pasteAs",
  "args": {
    "preferences": ["text.updateImports"]
  }
}

如果您愿意,甚至可以反过来,将“带导入粘贴”设为默认值,并添加一个键绑定以粘贴纯文本:

"editor.pasteAs.preferences": [
    "text.updateImports"
]
{
  "key": "ctrl+shift+v",
  "command": "editor.action.pasteAs",
  "args": {
    "preferences": ["text.plain"]
  }
}

最后,如果您想完全禁用 paste with imports,可以使用 typescript.updateImportsOnPaste.enabledjavascript.updateImportsOnPaste.enabled

远程开发

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

亮点包括:

  • remote-ssh Copilot 聊天参与者
  • 增强的会话日志记录

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

企业支持

配置允许的扩展

您现在可以使用 extensions.allowed 设置控制可以在 VS Code 中安装哪些扩展。此设置允许您按发布者、特定扩展和版本指定允许或阻止的扩展。如果扩展或版本被阻止,则如果已安装,它将被禁用。您可以指定以下类型的扩展选择器:

  • 允许或阻止来自发布者的所有扩展
  • 允许或阻止特定扩展
  • 允许特定扩展版本
  • 允许特定扩展版本和平台
  • 只允许扩展的稳定版本
  • 只允许发布者的稳定扩展版本

以下 JSON 片段显示了不同设置值的示例:

"extensions.allowed": {
    // Allow all extensions from the 'microsoft' publisher. If the key does not have a '.', it means it is a publisher ID.
    "microsoft": true,

    // Allow all extensions from the 'github' publisher
    "github": true,

    // Allow prettier extension
    "esbenp.prettier-vscode": true,

    // Do not allow docker extension
    "ms-azuretools.vscode-docker": false,

    // Allow only version 3.0.0 of the eslint extension
    "dbaeumer.vscode-eslint": ["3.0.0"],

    // Allow multiple versions of the figma extension
    "figma.figma-vscode-extension": ["3.0.0", "4.2.3", "4.1.2"],

    // Allow version 5.0.0 of the rust extension on Windows and macOS
    "rust-lang.rust-analyzer": ["5.0.0@win32-x64", "5.0.0@darwin-x64"],

    // Allow only stable versions of the GitHub Pull Requests extension
    "github.vscode-pull-request-github": "stable",

    // Allow only stable versions from redhat publisher
    "redhat": "stable"
}

通过发布者 ID 指定发布者。如果键不带句点(.),则被视为发布者 ID。如果键带句点,则被视为扩展 ID。目前不支持使用通配符。

您可以使用 microsoft 作为发布者 ID 来引用 Microsoft 发布的所有扩展,即使它们可能具有不同的发布者 ID。

不支持版本范围。如果您想允许某个扩展的多个版本,则必须单独指定每个版本。要通过平台进一步限制版本,请使用 @ 符号指定平台。例如,"rust-lang.rust-analyzer": ["5.0.0@win32-x64", "5.0.0@darwin-x64"]。有关更多详细信息,请参阅企业文档

管理员也可以通过 Windows 上的组策略配置此设置。有关更多信息,请参阅企业文档中的Windows 上的组策略部分。

使用预安装的扩展设置 VS Code

您可以使用一组预安装的扩展(引导)设置 VS Code。此功能在您准备机器镜像、虚拟机或云工作站时非常有用,其中 VS Code 已预安装,并且特定扩展立即可供用户使用。

注意:目前,预安装扩展仅在 Windows 上可用。

按照以下步骤引导扩展:

  1. 在 VS Code 安装目录中创建文件夹 bootstrap\extensions

  2. 下载要预安装的扩展的 VSIX 文件,并将它们放在 bootstrap\extensions 文件夹中。

  3. 当用户首次启动 VS Code 时,bootstrap\extensions 文件夹中的所有扩展都会在后台静默安装。

用户仍然可以卸载预安装的扩展。卸载扩展后重新启动 VS Code 不会重新安装扩展。

对扩展的贡献

Python

Python 环境扩展

在此版本中,我们推出了 Python 环境扩展,现在可在 Marketplace 上预览。

此扩展简化了 Python 环境管理,提供 UI 来创建、删除和管理环境,以及用于安装和卸载包的包管理。

它旨在通过各种 API 与您首选的环境管理器无缝集成,默认支持全局 Python 解释器、venv 和 Conda。开发人员可以构建扩展以添加对其喜欢的 Python 环境管理器的支持,并与我们的扩展 UI 集成,从而增强功能和用户体验。

您可以从 Marketplace 下载 Python 环境,并将其与 Python 扩展的预发布版本一起使用。

Python 测试增强

  • pytest 的 --rootdir 参数现在会根据工作区中是否存在 python.testing.cwd 设置进行动态调整。
  • 重新启动测试调试会话现在只重新运行指定的测试。
  • 更新了覆盖率支持,以处理 NoSource 异常。
  • pytest-describe 插件支持 UI 中的测试检测和执行。
  • 测试重写现在利用 FIFO 而不是 UDS 进行进程间通信,允许用户在自己的测试设计中利用 pytest_socket 等 pytest 插件。
  • 重写接近默认状态:此版本解决了测试重写中已知的问题,除非出现进一步的问题,否则重写实验将在 2025 年初关闭,重写设置为默认值。

Python REPL 增强

  • 智能发送到 Native REPL 后,焦点停留在编辑器上
  • Native REPL 重载后改进的处理
  • 修复 VS Code 终端中 Python 3.13 的缩进错误问题

Pylance“完整”语言服务器模式

python.analysis.languageServerMode 设置现在还支持 full 模式,使您能够利用 Pylance 的全部功能和最全面的智能感知体验。值得注意的是,这会牺牲性能,因为它会导致 Pylance 资源密集型,尤其是在大型代码库中。

python.analysis.languageServerMode 设置现在会根据其设置为 lightdefaultfull 更改以下设置的默认值:

设置 轻量 默认 完整
python.analysis.exclude ["**"] [] []
python.analysis.useLibraryCodeForTypes
python.analysis.enablePytestSupport
python.analysis.indexing
python.analysis.autoImportCompletions
python.analysis.showOnlyDirectDependenciesInAutoImport
python.analysis.packageIndexDepths [ { "name": "sklearn", "depth": 2 }, { "name": "matplotlib", "depth": 2 }, { "name": "scipy", "depth": 2 }, { "name": "django", "depth": 2 }, { "name": "flask", "depth": 2 }, { "name": "fastapi", "depth": 2 } ] [ { "name": "sklearn", "depth": 2 }, { "name": "matplotlib", "depth": 2 }, { "name": "scipy", "depth": 2 }, { "name": "django", "depth": 2 }, { "name": "flask", "depth": 2 }, { "name": "fastapi", "depth": 2 } ] { "name": "", "depth": 4, "includeAllSymbols": true }
python.analysis.regenerateStdLibIndices
python.analysis.userFileIndexingLimit 2000 2000 -1
python.analysis.includeAliasesFromUserFiles
python.analysis.functionReturnTypes
python.analysis.pytestParameters
python.analysis.supportRestructuredText
python.analysis.supportDocstringTemplate

TypeScript

TypeScript 可展开悬停 (实验性)

在此里程碑中,我们实现了从 TS 服务器查看展开/收缩信息的功能。该扩展使用可展开悬停 API 在编辑器悬停中显示 +- 标记,以显示更多或更少信息。

实验性设置可以使用 typescript.experimental.expandableHover 启用。要使此设置生效,您必须使用 TypeScript 5.8 或更高版本。您可以使用 TypeScript: Select TypeScript Version... 命令更改 TypeScript 版本。

Microsoft 帐户现在使用 MSAL(在 Windows 上支持 WAM)

为了确保 Microsoft 身份验证的强大安全基线,我们在 Microsoft 帐户扩展中采用了Microsoft 身份验证库

这项工作的突出特点之一是 WAM(Web 帐户管理器……也称为Broker)集成。简而言之,我们现在不是通过浏览器进行 Microsoft 身份验证流,而是直接与操作系统通信,这是获取 Microsoft 身份验证会话的推荐方法。此外,它更快,因为我们能够利用您已在操作系统上登录的帐户。

An authentication popup that the OS shows over VS Code.

如果您发现此新流程有任何问题,请告诉我们。如果您确实发现重大问题并且需要恢复到旧的 Microsoft 身份验证行为,您可以使用 microsoft-authentication.implementation(将其设置为 classic,并重新启动 VS Code)来完成,但请记住,此设置不会持续太久。因此,如果您在 MSAL 流程中遇到问题,请打开一个问题。

扩展开发

@vscode/chat-extension-utils

我们已经提供了聊天语言模型扩展 API 几个月了,以允许扩展作者与 GitHub Copilot 集成。但是我们发现,使用 LLM 和构建高质量的聊天扩展本身就很复杂,特别是如果您想使用工具调用。

我们发布了一个 npm 包 @vscode/chat-extension-utils,旨在尽可能轻松地启动和运行聊天参与者。它接管了您原本必须自己完成的几件事,因此您的聊天参与者可以在几行代码中实现。该包还包含一系列有用、高质量的元素,可与 @vscode/prompt-tsx 一起使用。

您可以在 chat-extension-utils 存储库中查看完整文档,并在示例聊天扩展中查看其运行情况。我们新的 LanguageModelTool API 文档也描述了如何使用它。

可归因覆盖率 API

测试覆盖率 API 现在允许扩展基于每个测试提供覆盖率信息。要实现此 API,请填充 FileCoverage 上的 includesTests?: TestItem[] 属性以指示哪些测试执行了该文件中的代码,并实现 TestRunProfile.loadDetailedCoverageForTest 以提供语句和声明覆盖率。

有关用户界面示例,请参阅上面的可归因覆盖率部分

对 JavaScript 调试终端的贡献

JavaScript 调试器现在有一种机制,允许其他扩展参与创建 JavaScript 调试终端。这使得 Node.js 以外的框架或运行时能够在熟悉的同一位置启用调试。有关更多信息,请参阅JavaScript 调试器文档

Node.js fetch API 的代理支持

全局 fetch 函数现在附带启用代理支持的功能 (http.fetchAdditionalSupport)。这类似于 https 模块,后者已经支持代理。

预览功能

粘贴代码以附加聊天上下文

以前,您已经可以将文件作为上下文附加到 Copilot Chat。为了对上下文进行更精细的控制,您现在可以粘贴代码片段以将其作为聊天上下文附加。这会添加必要的文件信息和相应的行号。您只能粘贴来自当前工作区中文件的代码。

要试用此功能,请复制一些代码并将其粘贴到内联聊天、快速聊天或聊天视图中。选择出现的粘贴控件并选择“粘贴代码附件”。或者,您可以设置 editor.pasteAs.preferences 设置:

"editor.pasteAs.preferences": [
    "chat.attach.text"
]

Attaching code as context in Copilot Chat using the paste control.

更多 Shell 的终端补全功能

在之前的迭代中,我们增加了对 pwsh 中终端补全的实验性支持。此版本中,我们开始将其扩展到其他 shell。目前主要针对 bashzsh,但由于这种新方法由扩展主机 API 提供支持,我们计划为大多数 shell 提供通用支持。

您可以通过设置 terminal.integrated.suggest.enabledterminal.integrated.suggest.enableExtensionCompletions 来尝试当前正在进行的工作。目前仅支持 cdcodecode-insiders 参数。

The command  is typed on the terminal, which shows suggestions. Then  is typed and options are provided,  is selected. Completions are requested with ctrl+space and all locales are shown.  is typed and the list is filtered to  and .

提议的 API

Quick Pick 中建议的值选择 API

对于 InputBox,您可以设置“值选择”,这使您能够以编程方式选择部分或全部输入。在此里程碑中,我们为 QuickPick 中的值选择添加了一个提议的 API。

以下是它可能看起来像的示例:

const qp = vscode.window.createQuickPick();
qp.value = '12345678';
qp.valueSelection = [4, 6];
qp.items = [
  { label: '12345678', description: 'desc 1' },
  { label: '12345678', description: 'desc 2' },
  { label: '12345678', description: 'desc 3' }
];
qp.show();

A couple of characters are selected in the quick pick's input box.

尝试valueSelectionInQuickPick 提案,并在此 GitHub 问题中告诉我们您的想法!

提议的本机窗口句柄 API

在此里程碑中,我们添加了一个新的提议 API,用于检索聚焦窗口的本机窗口句柄。本机窗口句柄是一个操作系统概念,本质上提供了指向特定窗口的指针。如果您正在与本机代码交互,并且需要(例如)在窗口顶部呈现本机对话框,这会很有用。

declare module 'vscode' {
  export namespace window {
    /**
     * Retrieves the native window handle of the current active window.
     * This will be updated when the active window changes.
     */
    export const nativeHandle: Uint8Array | undefined;
  }
}

这是专门为 Microsoft 身份验证采用 MSAL 而添加的,这样我们就可以将本机句柄传递给操作系统,以便它可以在 VS Code 上方呈现身份验证对话框。

如果您对 nativeWindowHandle 提案有任何用例或反馈,请在此 GitHub 问题中告诉我们您的想法!

工程

通过 vscode-unpkg 服务优化扩展更新

为了减少 Marketplace 基础设施的负载,VS Code 现在使用 vscode-unpkg 服务中新添加的端点来检查扩展更新。该服务实现了服务器端缓存,TTL 为 10 分钟,这显著减少了对 Marketplace 的直接请求数量。此优化通过 extensions.gallery.useUnpkgResourceApi 设置控制(默认为启用)。

如果您注意到扩展更新存在问题,您可以使用 extensions.gallery.useUnpkgResourceApi 禁用此功能,并恢复到直接 Marketplace 版本检查。

编辑器中 GPU 加速的基础工作

我们很高兴地宣布,我们已开始在编辑器中启用 GPU 加速的工作,类似于终端。这项工作的目标主要是通过减少输入延迟和提高滚动性能来改善整体编码体验。

这仍然处于早期阶段,尚未准备好进行测试,但我们想分享一些关于已取得进展的详细信息:

  • GPU 渲染器在幕后使用 WebGPU。
  • 我们目前专注于功能对等性和正确性,而不是性能。
  • 当启用 GPU 加速时,存在一种回退机制,允许行在不完全支持时“回退”到 DOM 渲染。这意味着我们可以早期自托管,并且当前不兼容的行将使用 DOM 方法显示。当前回退的一些行示例:超过 200 个字符的行、带有某些 Monaco 装饰(例如褪色未使用的变量)的行、换行的行等等。
  • Monaco 的内联装饰允许设置包含字符的实际元素的样式,这给此功能带来了巨大挑战,因为它们使用 CSS 设置样式。我们用于支持大多数内联装饰而不破坏或更改 API 的方法是检测附加到这些装饰的 CSS,然后支持一部分常见的 CSS 属性,如果并非所有样式都支持则回退。

这是此功能运行时的截图。请注意,装订线中的黄线告诉我们哪些行正在使用回退渲染。此特定情况由于 dontShow 参数具有内联装饰而使用回退渲染,因为它未使用:

GPU rendering looks mostly the same as DOM rendering currently, a yellow line appears for lines rendered via the DOM

跟踪这项工作的议题是#221145,其中包含频繁的更新和更多有关进展的详细信息。

macOS 10.15 的 EOL 警告

VS Code 桌面版将在接下来的几个里程碑中更新到 Electron 33。随着 Electron 33 的更新,VS Code 桌面版将不再在 macOS Catalina 上运行。在此里程碑中,我们已为此受影响平台的用户添加了弃用通知,以让他们为迁移做好准备。如果您是上述操作系统版本的用户,请查看我们的 FAQ 以获取更多信息。

值得注意的修复

  • 233915 通过“扩展”视图中扩展上下文菜单中的“复制链接”操作与他人共享扩展。
  • 231542 经常无法保存文件或文件数据因错误 EBUSY 被擦除
  • 233304 onDidChangeCheckboxState 在 1.95 中损坏
  • 232263 优化树视图,使跨进程调用批量处理
  • 156723 在 Wayland 下运行时修复拖放支持

感谢

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

问题跟踪

对我们问题跟踪的贡献

拉取请求

vscode 的贡献

vscode-emmet-helper 的贡献

vscode-eslint 的贡献

vscode-extension-samples 的贡献

vscode-extension-telemetry 的贡献

vscode-hexeditor 的贡献

vscode-json-languageservice 的贡献

vscode-jupyter 的贡献

vscode-mypy 的贡献

vscode-python-debugger 的贡献

vscode-python-tools-extension-template 的贡献

vscode-test-web 的贡献

inno-updater 的贡献

language-server-protocol 的贡献