🚀 在 VS Code 中！

2024 年 6 月（版本 1.91）

更新 1.91.1：此更新解决了以下问题。

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

欢迎使用 Visual Studio Code 2024 年 6 月版。此版本包含许多更新，我们希望您会喜欢，其中一些主要亮点包括

如果您想在线阅读这些发行说明，请访问 code.visualstudio.com 上的更新。Insiders： 想要尽快尝试新功能吗？您可以下载 nightly Insiders 构建版本，并在最新更新可用时立即试用。

辅助功能

编辑器悬停的可访问视图

为了提高编码时的辅助功能，可访问视图和 辅助功能帮助菜单现在可以呈现编辑器悬停信息的内容。根据悬停的焦点部分，它们显示有关焦点部分或整个悬停内容的信息。

Accessible View showing the contents of the editor hover information.

链接下划线

为了使工作台中的链接更容易与常规文本区分开来，您可以启用设置 accessibility.underlineLinks 以在链接下添加下划线。

The run and debug view showing a mix of regular text and underlined links.

工作台

搜索

我们添加了一个新设置 search.ripgrep.maxThreads，使您能够限制 ripgrep 搜索引擎使用的线程数。此设置适用于核心产品使用搜索还是通过扩展 API 使用搜索。

将 search.ripgrep.maxThreads 设置为非零值以配置线程数。请谨慎，因为将此设置固定为特定值可能会减慢 ripgrep 的速度。

调整猜测允许的编码

使用新设置 files.candidateGuessEncodings，您可以配置一组在启用 files.autoGuessEncoding 时应考虑的编码。配置顺序决定优先级。此功能使您能够将可以检测到的可能编码限制为较小的集合，并将一种编码优先于另一种编码。

配置文件编辑器预览

在此里程碑中，我们引入了一个新的配置文件编辑器，使您能够从单个位置管理配置文件。此体验包括创建新配置文件、编辑和删除现有配置文件，以及导入和导出配置文件以与他人共享。创建新配置文件时，您可以预览配置文件并在保存之前根据需要进行自定义。配置文件编辑器还使您能够使用特定配置文件打开新窗口，或将配置文件设置为新窗口的默认配置文件。

Profiles Editor showing all user profiles and their settings.

配置文件编辑器作为实验性功能提供，位于 workbench.experimental.enableNewProfilesUI 设置之后。启用后，您可以从窗口左下角的设置齿轮图标访问配置文件编辑器。

Settings menu showing the Profiles menu item to open the Profiles Editor.

试用一下，并向我们提供关于如何进一步改进此体验的反馈。

带有配置文件的新窗口菜单项

除了配置文件编辑器之外，我们还在“文件”菜单中添加了使用特定配置文件打开新窗口的操作。使用文件 > 带有配置文件的新窗口菜单以使用特定配置文件打开新窗口。

Screenshot of the File menu showing the New Window with Profile menu items.

扩展安装选项

我们添加了更多选项，以便在安装扩展时为您提供更大的灵活性

  • 安装扩展而不进行同步。
  • 安装扩展的特定版本。以前，您必须先安装扩展的最新版本，然后才能选择特定版本。

这些操作在扩展视图中扩展的上下文菜单中可用

Context menu for the Extensions view, showing the additional install actions.

在自定义标签中访问文件扩展名

当您定义自定义标签时，您现在可以通过使用 ${extname(N)} 语法来更灵活地访问单个文件扩展名。此外，${extname(N)} 还支持负索引以按相反顺序捕获文件扩展名。要获取整个文件扩展名，请使用 ${extname}。

例如，对于文件 tests/editor.test.ts

  • ${filename} => editor
  • ${extname} => test.ts
  • ${extname(0)} => ts
  • ${extname(1)} => test
  • ${extname(-1)} => test
  • ${extname(-2)} => ts

合并来自多个扩展的自定义标签模式

当两个扩展在其 configurationDefaults 中为设置 workbench.editor.customLabels.patterns 贡献默认配置时，贡献的模式将合并在一起。

"workbench.editor.customLabels.patterns" : {
  "**/app/**/page.tsx": "${dirname} - Page",
  "**/app/**/layout.tsx": "${dirname} - Layout"
}
 
"workbench.editor.customLabels.patterns" : {
  "**/components/**/index.tsx": "${dirname} - Component"
}
扩展 1 的默认贡献 扩展 2 的默认贡献 
"workbench.editor.customLabels.patterns" : {
  "**/app/**/page.tsx": "${dirname} - Page",
  "**/app/**/layout.tsx": "${dirname} - Layout",
  "**/components/**/index.tsx": "${dirname} - Component"
}
生成的自定义标签模式

取消设置主题颜色

如果主题设置了您不喜欢的颜色或边框，您现在可以使用 default 将其设置回原始值

  "workbench.colorCustomizations": {
      "diffEditor.removedTextBorder": "default"
  }

更改折叠占位符颜色

现在可以使用颜色 editor.foldPlaceholderForeground 为折叠占位符（省略号）设置主题。

编辑器

保存时代码操作

使用 editor.codeActionsOnSave 设置，您可以配置一组在保存文件时自动应用的代码操作，例如组织导入。我们改进了配置此设置的 IntelliSense，方法是根据您的工作区文件和活动扩展提供可用代码操作的列表。

注意：请注意，尽管 true 和 false 目前仍然是有效的配置，但它们将被弃用，转而使用 explicit、always 和 never。有关示例，请参阅 保存时代码操作文档。

快速关闭只读文件状态

如果您已通过 files.readonlyInclude 设置将文件配置为只读，您现在可以从只读编辑器消息中快速关闭文件的只读状态。

Read-only editor message enabling you to toggle the read-only status.

源代码管理

传入/传出更改图预览

我们一直在探索使用传入和传出更改的替代可视化方式。此里程碑包括一个实验性功能，该功能使用图形来可视化传入和传出更改。该图包含当前分支、当前分支的上游分支以及可选的基础分支。该图的根是这些分支的共同祖先。

您可以使用 scm.experimental.showHistoryGraph 设置启用此新可视化。试用一下并告诉我们您的想法，因为我们将继续改进和扩展此可视化中可用的功能。

Source control view showing a graph visualization of the incoming and outgoing changes.

笔记本

在文本选择中查找

笔记本查找控件现在具有用于文本选择和单元格选择的“在选定内容中查找”。默认情况下启用此行为，并且可以通过控件中的按钮进行控制。根据您的选择上下文，切换此按钮会将您的查找查询范围限定为一个或多个选定单元格，或单元格内的行。

从上下文菜单复制或打开文本输出

在笔记本中使用文本输出时，您现在可以使用文本输出的上下文菜单来复制输出值或在新编辑器中打开输出。此功能使查看大型流式输出变得更加容易。

终端

支持复制和粘贴转义序列 (OSC 52)

现在支持操作系统命令 (OSC) 52 转义序列。这可以被终端中运行的任何内容使用，但主要用例是 tmux 的剪贴板访问。

新的自定义字形

终端现在支持分支、行号和锁定 Powerline 符号的自定义字形。与我们支持的其他自定义字形一样，当启用 GPU 加速时，这些符号无需配置字体即可工作。

Characters 0xe0a0, 0xe0a1 and 0xe0a2 render with their Powerline symbols.

当调整字体大小、行高或字母间距时，这些符号还可以与单元格完美缩放。

The new symbols scale vertically and horizontally when a custom font size, line height or letter spacing is used.

调试

JavaScript 调试器

JavaScript 调试器现在根据程序的范围，在悬停在阴影变量上时以及在内联值中（通过 debug.inlineValues 设置启用）显示阴影变量的正确值。

JavaScript code snippet that shows an overlay with the value of shadowed variables.

主题：Codesong（在 vscode.dev 上预览）

语言

TypeScript 5.5

我们现在包含 TypeScript 5.5。此主要更新带来了许多新的语言功能和工具改进。查看 TypeScript 5.5 博客文章，了解有关此版本的详细信息。

正则表达式的语法检查

由于 TypeScript 5.5，我们现在报告 JavaScript 和 TypeScript 正则表达式文字中的许多语法错误。这包括未闭合的组、不正确的反向引用或无效的转义符等错误

Editor showing a regex error for an invalid group caused by an extra parenthesis.

Editor showing a regex error for an invalid escape sequence

查看 TypeScript 5.5 博客文章，了解更多详细信息。

扩展贡献

GitHub Copilot

紧凑型内联聊天

内联聊天渲染现在更加紧凑，这使得阅读和理解建议变得更容易。我们还在试验按钮文本的更叙事风格，您可以通过 inlineChat.experimental.textButtons 启用。

Sample of more compact inline chat in the editor.

终端初始提示

终端中显示了一个新提示，以帮助发现内联聊天。

The terminal will say "Press Ctrl+I to ask GitHub Copilot to do something. Start typing to dismiss"

此提示仅在安装 Copilot 扩展并且存在尚未进行任何交互的单个终端时显示。通过右键单击消息，可以轻松永久关闭该消息。首次使用终端内联聊天后，消息也会关闭。

应用代码块

聊天视图中代码块上的在编辑器中应用命令使用语言模型来确定将更改应用于当前编辑器的最佳方法。

Chat view showing the Apply In Editor command for a code block in a chat response.

Python

使用 python-environment-tools 的 Python 环境发现

我们很高兴推出一个新工具 python-environment-tools，旨在显着提高检测全局 Python 安装和 Python 虚拟环境的速度。此工具使用 Rust 来确保快速准确的发现过程。

我们目前正在测试此新功能，使其与现有支持并行运行，以评估 Python 扩展中的新发现性能。因此，您将看到一个名为 Python Locator 的新日志记录通道，其中显示了使用此新工具的发现时间。

此增强是我们不断努力优化 VS Code 中 Python 支持的性能和效率的一部分。访问 python-environment-tools 存储库，了解有关此功能、正在进行的工作并提供反馈的更多信息。

在原生 REPL 中智能发送

Python 扩展现在在 智能发送中启用了 VS Code 原生 REPL。

以前，当您将光标放在一行 Python 代码上并按下 Shift+Enter 时，Python 扩展会将完全相同的行内容发送到原生 REPL，即使这样做会失败，例如因为它是一个多行命令的一部分。

现在，Shift+Enter 在非嵌套场景中发送最小可执行代码，或者在嵌套场景中发送最高级别的代码块。这使用户能够快速地在整个文件中 Shift+Enter，以最少的努力运行最大量的可执行代码。

支持 reStructuredText 文档字符串

Pylance 现在支持在悬停时渲染 reStructuredText 文档字符串 (docstring)！

此功能尚处于早期阶段，目前位于标志之后，因为我们正在努力确保它有效地处理各种 Sphinx、GoogleDoc 和 Epytext 场景。要试用它，您可以启用实验性设置 python.analysis.supportRestructuredText。

Docstring displayed when hovering over the panel module.

试用此更改，并在 Pylance GitHub 存储库 中报告任何问题或反馈。

注意：此设置是实验性的，将来可能会删除，因为我们将稳定此新功能并默认启用它。

GitHub Pull Requests 和 Issues

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

  • 提交日期显示在已检出 PR 的提交子树中。
  • 许多错误修复。

查看扩展的 0.92.0 版本变更日志，了解其他亮点。

ESLint

ESLint 扩展现在支持 平面配置文件格式。该扩展仍然支持 eslintrc 文件，您可以使用 eslint.useFlatConfig 设置来控制使用哪种配置文件格式。

请查阅 ESLint 平面配置推出计划，以了解 ESLint 关于弃用和删除对 eslintrc 文件格式支持的计划。

扩展编写

Chat 和 Language Model API

上个月，我们最终确定了使扩展能够参与聊天和访问语言模型的 API，但它们仅在 VS Code Insiders 中可用。在此版本中，这些 API 现在在 VS Code Stable 中完全可用。

查看我们的 公告博客文章，了解有关这些 API 的更多信息，并了解一些早期采用者如何使用它们。

要开始使用，请转到我们的 扩展示例和 Chat 可扩展性文档。

处理对象设置的默认值

当多个扩展为同一对象设置贡献默认值时，这些默认值现在会合并。这可以防止扩展之间的冲突。

最终确定的 DebugSessionOptions.testRun API

从测试运行启动调试会话的扩展现在可以在调用 vscode.debug.startDebugging 时将该运行传递到 DebugSessionOptions 中。传递后，生命周期操作（例如重新启动调试会话）也会创建一个新的测试运行。

调试适配器协议

对 调试适配器协议 进行了一些值得注意的更改

  • 通过新的 Scope.presentationHint = returnValue 选项表示返回值。
  • 向 evaluate 请求添加源位置。VS Code 实现了这一点，并在评估悬停和内联值时传递位置。

建议的 API

语言模型的工具和函数

我们添加了一个 API 提案，该提案支持工具或函数调用。该 API 包含两个主要部分

  1. 扩展注册“工具”的能力。“工具”是指旨在供语言模型使用的一段功能。例如，读取文件的 Git 历史记录。

  2. 语言模型支持工具的机制，例如：扩展在发出请求时传递工具，语言模型请求工具调用，以及扩展将工具调用的结果传回。

该提案可以在 vscode.proposed.lmTools.d.ts 中找到。

注意：API 仍在积极开发中，内容将会更改。还希望 VS Code 附带合理的默认工具。

身份验证 getSessions 现在是 getAccounts

虽然我们支持多帐户身份验证提供程序，但一直缺少的是获取所有会话并对特定会话执行操作的能力。以前，我们有一个 getSessions API 提案试图解决此问题，但在经过实验并借鉴流行的身份验证库的灵感后，我们正在采取不同的方法来解决该问题。

我们放弃了之前提出的 getSessions API，转而采用区分“帐户”和“会话”概念的方法。

希望使用身份验证会话的扩展作者可以运行以下代码来获取用户登录的帐户的 AuthenticationSessionAccountInformation

const accounts = vscode.authentication.getAccounts('microsoft');

从那里，您可以使用这些帐户专门为这些帐户生成会话

const session = vscode.authentication.getSession('microsoft', scopes, {
  account: accounts[0]
});

注意：为了使此功能正常工作，身份验证提供程序需要处理一个新参数，您可以在下面的 API 提案中阅读有关该参数的信息

我们相信，这是处理多个身份验证会话的更清晰方法，并且能够处理我们以前无法支持的各种场景。

该提案可以在 vscode.proposed.authGetSessions.d.ts 中找到，该提案使用了此提案的先前名称，而不是破坏依赖此提案的现有代码。

评论线程显示

我们添加了一个 API 提案，该提案使提供评论的扩展能够在编辑器中显示其自己的评论线程。此 API 提供了在显示线程时是否保留焦点或聚焦到线程的回复框的选项。

该提案可在 vscode.proposed.commentReveal.d.ts 中找到。

可归因的测试覆盖率

我们正在开发一个 API，该 API 允许在每个测试的基础上归因测试覆盖率。这使用户能够查看哪些测试运行了哪些代码，从而过滤编辑器中显示的覆盖率以及测试覆盖率视图中的覆盖率。

查看 vscode#212196 以获取更多信息和更新。

工程

将 NLS 与 AMD 加载器解耦

在此里程碑中，我们开始删除 VS Code 中核心本机语言支持 (NLS) 对我们提供的异步模块定义 (AMD) 加载器的依赖性。我们未来的目标是使用 ECMAScript 模块 (ESM) 加载并完全放弃 AMD。为了朝着这个方向取得进展，我们删除了 AMD 加载器插件依赖项。您不应注意到任何行为差异，并且我们过去支持的所有翻译在 Web 和桌面中仍然受支持。

值得注意的修复

感谢

最后但同样重要的是，衷心感谢 VS Code 的贡献者。

问题跟踪

对我们的问题跟踪的贡献

拉取请求

对 vscode 的贡献

贡献到 vscode-css-languageservice

贡献到 vscode-extension-samples

贡献到 vscode-html-languageservice

贡献到 vscode-languageserver-node

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

贡献到 node-jsonc-parser