现已发布!了解 11 月的新功能和修复。

2024 年 11 月(版本 1.96)

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


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

如果您想在线阅读这些发行说明,请访问 更新(位于 code.visualstudio.com 上)。 Insiders: 想尽快尝试新功能吗?您可以下载每晚的 Insiders 构建版本,并尽快尝试最新的更新。

GitHub Copilot

Copilot 编辑

在上一个里程碑中,我们引入了 Copilot 编辑(目前处于预览版),它允许您使用自然语言一次快速编辑多个文件。从那时起,我们继续迭代体验。您可以通过打开命令中心中的 Copilot 菜单,然后选择“打开 Copilot 编辑”,或通过触发 ⇧⌘I(Windows Ctrl+Shift+I,Linux Ctrl+Shift+Alt+I来试用 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 聊天和 Copilot 编辑中的上下文的新方法,从而使您在工作流程中更容易引用相关信息。

符号

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

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

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

文件夹

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

当文件夹被拖入 Copilot 编辑中时,该文件夹中的所有文件都会包含在工作集中。

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)。默认情况下,焦点会移动到输入框。

工作台

改进的扩展搜索结果

当您在扩展视图中使用自由文本搜索扩展时,已安装的扩展现在会显示在搜索结果的顶部。这使得在搜索 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 文件之间复制和粘贴代码时,此功能会自动添加导入。为了避免中断您的工作流程,我们默认情况下决定粘贴只插入纯文本,并且在粘贴控件中提供 带导入粘贴 选项。但是,如果您希望 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 设置禁用。

覆盖模式

根据大众要求,我们添加了覆盖模式,以便在键入时覆盖编辑器中的文本,而不是插入文本。一个有用的场景是编辑 Markdown 表格,您希望保持表格单元格边界对齐。

可以使用命令 视图: 切换覆盖/插入模式 来切换此模式。当您处于覆盖模式时,状态栏会显示一个 OVR 指示器。此外,还有一个设置 editor.overtypeOnPaste,用于确定在覆盖模式下粘贴时应覆盖还是插入。默认行为是插入粘贴的文本。

可以使用设置 editor.overtypeCursorStyle 来更改处于覆盖模式时的光标样式。

源代码管理

Git 追溯信息 (实验性)

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

您可以使用 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 编辑中的差异。选择失败消息仍然会打开一个速览控件,以显示失败的完整详细信息。

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

远程开发

远程开发扩展允许您使用 Dev 容器、通过 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 增强功能

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

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

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

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

设置 轻量 (light) 默认 (default) 完整 (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: 选择 TypeScript 版本... 命令更改 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

快速选择上的建议值选择 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

跟踪这项工作的 issue 是 #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 的贡献