在 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 上的更新内部版本:想尽快试用新功能?您可以下载每晚内部版本,并在最新更新发布后立即试用。

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 编辑(目前处于预览阶段),它允许您使用自然语言快速同时编辑多个文件。自那时起,我们继续改进体验。您可以通过在命令中心打开 Copilot 菜单,然后选择“打开 Copilot 编辑”,或触发来试用 Copilot 编辑。

进度和编辑器控件

Copilot 编辑可以在不同文件中进行多处更改。现在,当编辑流式传输时,您可以更清楚地看到其进度。借助编辑器叠加控件,您可以轻松循环浏览所有更改并接受或放弃它们。

将聊天会话移动到 Copilot 编辑

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

Edit with Copilot showing for a chat exchange.

工作集建议文件

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

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

重启后恢复编辑会话

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

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

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

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 代码搜索以及如何启用它的信息。

辅助功能

代码操作辅助功能信号

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

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

REPL 中的自动焦点管理

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

工作台

改进的扩展搜索结果

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

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 文件之间复制和粘贴代码时自动添加导入。为了避免干扰您的工作流,默认情况下,我们决定粘贴只插入纯文本,而“粘贴并导入”作为选项在粘贴控件中提供。但是,如果您希望 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.

笔记本

跨单元格选择高亮显示

选择高亮显示现在在笔记本中得到支持,允许跨多个单元格进行基于文本选择的高亮显示。这由现有的 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, <line> 的链接现在应在终端中被检测为链接。

测试

可归因覆盖率

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

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

重新设计的内联失败消息

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

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 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"]
  }
}

最后,如果您想完全禁用粘贴时导入,您可以使用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 环境扩展,现在可在市场中预览。

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

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

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

Python 测试增强

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

Python REPL 增强

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

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

python.analysis.languageServerMode 设置现在还支持 full 模式,使您能够充分利用 Pylance 的全部功能和最全面的 IntelliSense 体验。值得注意的是,这将以牺牲性能为代价,因为它可能导致 Pylance 占用大量资源,尤其是在大型代码库中。

python.analysis.languageServerMode 设置现在会根据其是设置为 lightdefault 还是 full 来更改以下设置的默认值

设置 默认 完整
python.analysis.exclude ["**"] [] []
python.analysis.useLibraryCodeForTypes false true true
python.analysis.enablePytestSupport false true true
python.analysis.indexing false true true
python.analysis.autoImportCompletions false false true
python.analysis.showOnlyDirectDependenciesInAutoImport false false true
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 false false true
python.analysis.userFileIndexingLimit 2000 2000 -1
python.analysis.includeAliasesFromUserFiles false false true
python.analysis.functionReturnTypes false false true
python.analysis.pytestParameters false false true
python.analysis.supportRestructuredText false false true
python.analysis.supportDocstringTemplate false false true

TypeScript

TypeScript 可扩展悬停(实验性)

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

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

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

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

这项工作的突出特点之一是 WAM(Web 帐户管理器…也称为代理)集成。简单来说,我们不再通过浏览器进行 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 服务优化扩展更新

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

如果您发现扩展更新问题,可以使用 extensions.gallery.useUnpkgResourceApi 禁用此功能,并恢复到直接市场版本检查。

编辑器中 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 的贡献