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

2021 年 8 月(版本 1.60)

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

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

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


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

如果您想在线阅读这些发行说明,请访问 code.visualstudio.com 上的更新页面。

加入我们的直播:太平洋时间 9 月 2 日星期四上午 8 点(伦敦时间下午 4 点),在VS Code 团队直播中观看此版本的新功能演示,并向我们提问。

内测版:想尽快尝试新功能?您可以下载每晚的内测版构建,并尽快尝试最新的更新。

工作台

自动语言检测

上一个版本中,我们为未命名文件引入了一个实验性功能,它会根据文件内容自动设置文件的语言模式。自动语言检测功能使用机器学习来猜测语言,并且机器学习模型完全在您的本地机器上运行。该模型由开源机器学习库 Tensorflow.js 提供支持,并使用 GitHub 用户 @yoeoGuesslang 机器学习模型。

此版本中,我们默认启用自动语言检测功能,并将其扩展到包含没有文件扩展名的文件。在笔记本中,我们提供了一种使用语言选择器进行语言检测的简便方法。

我们添加此功能是因为我们发现一些 VS Code 新用户不知道如何设置语言模式,也不知道这对于获取 VS Code 丰富的特性集(语言着色和扩展推荐)是必需的。让新用户快速查看 VS Code 可用的语言特性和扩展,有助于他们快速熟悉编辑器。

此外,将未命名文本编辑器用作草稿本的高级用户不再需要明确设置语言模式,我们希望这将简化他们的工作流程。

以下是自动语言检测实现的一些有趣场景。

从网上获取一个示例并粘贴到未命名编辑器中

主题:Panda Theme

“管道到代码”语言检测(展示无扩展名文件的检测)

主题:Panda Theme

笔记本语言选择器中的自动检测选项

主题:Panda Theme

终端编辑器确认对话框

现在,关闭带有运行中子进程的终端编辑器时出现的对话框是专门针对终端编辑器的,并且不再提供“保存”终端的选项。

Terminal editor confirmation dialog

编辑器在恢复失败时保持打开状态,而不是关闭

以前,当编辑器在窗口重新加载或应用程序重启后未能恢复时,编辑器会自动关闭,直到找到一个成功加载的编辑器。这种行为导致令人沮丧的结果,即精心创建的编辑器布局会因编辑器关闭而消失。

在此版本中,曾经成功打开的编辑器将不会关闭,即使它未能恢复。编辑器会指示问题并提供重试操作。

Keep editors open and offer to Try Again

设置编辑器中代码块的语法高亮

设置说明中的围栏代码块现在支持语法高亮。

Syntax highlighting of TypeScript code in the Settings editor

在侧面打开设置编辑器

现在可以通过使用 openToSide 参数配置键绑定来在侧面组中打开设置编辑器。

{
  "key": "cmd+,",
  "command": "workbench.action.openSettings",
  "args": {
    "openToSide": true
  }
}

这也适用于 workbench.action.openSettingsJson 命令。

编辑器

高性能括号对着色

编辑器现在支持原生括号对着色。

Side by side comparison with bracket pair colorization on and off

通过设置 "editor.bracketPairColorization.enabled": true 可以启用括号对着色。所有颜色都是可主题化的,并且最多可以配置六种颜色。

我们实现此功能是为了解决 CoenraadS 著名的 Bracket Pair Colorizer 扩展的性能问题。

现在,即使是大型文档中的更改也能立即反映出来。

自动补全中的内联建议

当自动补全小部件显示时,内联建议现在可以扩展建议预览。如果自动补全小部件中选择的建议可以通过内联补全提供程序扩展,则扩展会以斜体显示。第一次按 Tab 键仍只会接受自动补全建议。第二次按 Tab 键将接受内联建议。

此功能要求启用建议预览("editor.suggest.preview": true)。

更新的 Peek 视图

我们对 Peek 视图进行了视觉刷新,以使其与编辑器的其他视图保持一致。

Peek view for informational items

Peek view for warning items

Peek view for error items

Peek view for References view

终端

框线和块元素字符的自定义渲染

当 GPU 加速打开时(terminal.integrated.gpuAcceleration),框线和块元素字符现在使用像素完美的自定义字形而不是字体。这意味着,例如,即使您在终端中设置了行高或字间距,框线也会无缝绘制。

Terminal glyph rendering before with gaps Terminal glyph rendering after without gaps

以下是终端应用程序 Zenith 的示例,它显示了围绕部分的框线字符以及图表的块元素。

Terminal rendering box characters and block elements

可以通过设置 "terminal.integrated.customGlyphs": false 来禁用此功能。

改进了某些字体的下划线渲染

历史上,下划线在终端中的渲染方式存在一些问题,其中大部分通过切换到 WebGL 渲染器(默认)得到了修复。但有一个例外,即在 Linux 上,字体的下划线字符意外地绘制在单元格边界之外。

请注意,下排的下划线是如何渲染在单元格下方的。

The underscore was previously rendered 1 pixel below the cell's bounds

虽然这在大多数情况下都正常工作,但在最下面一行则失败,因为它绘制在画布边界之外。

我们现在通过检测此类字体并向上移动下划线纹理直到它在单元格边界内来解决此问题。此解决方案也适用于画布渲染器,它以前不会显示任何行的下划线,因为它会剪辑行以避免重叠。

The underscore is now at the bottom of the cell's bounds

重新加载窗口后更快地重新连接

以前,当重新加载窗口时,解析终端缓冲区状态可能需要长达 300 毫秒,并且还可能发生损坏。对于几个繁忙的终端,这会迅速累积!为了解决这个问题,恢复缓冲区的方法已从在 pty 主机上记录大量最近的原始终端事件更改为在 pty 主机上维护一个无头终端前端并将所有数据写入其中。

这种方法带来了几个好处:

  • 可以微调要恢复的回滚量。默认现在是 100,这是速度和数据量之间的良好平衡。回滚量可以使用 terminal.integrated.persistentSessionScrollback 设置进行更改。
  • 由于 xterm.js 的快速解析器,这应该对 CPU 使用率产生最小影响,并减少 pty 主机上的总体内存使用率。
  • 现在明确恢复终端模式,这些模式以前可能会被遗漏并导致缓冲区损坏。
  • 由于终端缓冲区始终与其大小同步,因此不再需要重放耗时的调整大小事件。
  • 由于恢复速度相对较快,因此都在一个帧中处理。这意味着宝贵的 CPU 时间不会浪费在渲染部分恢复的终端并进一步减慢速度。

这种新实现的速度提升取决于许多因素,例如终端数量、硬件、终端缓冲区大小以及终端中正在发生的事情。粗略估计,恢复完整的终端缓冲区应带来大约 5-10 倍的速度提升。

我们还在 npm 上发布了新的 xterm-headless 包,因此您可以在自己的项目中使用此工作。

调试

在 WATCH 视图中设置值

现在可以使用上下文菜单中的“设置值”操作在 WATCH 视图中设置监视表达式的值。

Shows WATCH view with the Set Value action selected in the context menu

调试扩展必须选择此功能才能使“设置值”可用。目前,JS-debug、C# 和 C++ 扩展支持此功能,但我们预计其他调试扩展也将很快支持。

次要 UI 改进

  • VS Code 现在还会检测 VARIABLES 视图、WATCH 视图和调试悬停中的值链接。当变量的值是链接时,这将使其更容易通过单击该链接来跟踪。

  • 当启动已经运行的调试会话的另一个实例时,现在会显示一个模式确认对话框,以防止意外启动两个会话。

  • 现在,单击编辑器断点槽中禁用的断点将启用断点,而不是将其删除。

  • 当调试会话处于活动状态时,“运行到行”操作现在可在编辑器的断点槽上下文菜单中找到。

新设置

  • 如果您想避免在调试会话期间意外关闭窗口,可以启用新设置 debug.confirmOnExit。如果将其设置为 always,则在关闭窗口时会提示您确认是否要停止调试会话。

    Confirm quit while debugging

  • 新设置 debug.console.acceptSuggestionOnEnter 控制调试控制台中是否应在 Enter 键上接受建议。Enter 键也用于评估调试控制台中输入的内容,因此此选项让用户更好地控制按下 Enter 键时发生的情况。

JavaScript 调试

旧版节点调试器已移除

VS Code 长期以来一直包含一个内置的 Node.js 调试器,并发布了一个单独的 Chrome 调试器。去年我们为 Node.js 和 Chrome 引入了一个新的调试器,自 VS Code 1.47(2020 年 7 月)以来,它一直是默认调试器,并带有“选择退出”选项。

在此版本中,旧版调试器已从产品中移除,并在 Marketplace 上标记为已弃用。如果您是大多数未选择退出新 JavaScript 调试器的 VS Code 用户,那么对您来说没有任何变化。

如果您需要旧版调试器——例如,调试 Node.js 6 程序——您可以安装 [已弃用] Node Debug[已弃用] Debugger for Chrome 扩展,并分别使用 legacy-nodelegacy-chrome 启动类型。

改进了异步函数和 Node.js 内部的单步执行

您可以设置调试器的 skipFiles 以避免单步执行某些代码,包括 Node.js 内部代码,这些代码在单步执行异步函数时经常会遇到。

但是,Node.js 在处理 “黑盒化”脚本时并不总是表现出正确的行为,因此在此迭代中,我们在调试器中引入了“合成黑盒化”。这应该会显著提高在使用 Node.js 程序时的可靠性,尤其是在单步执行异步函数时。

在下一个版本中,我们计划默认让调试器跳过 Node.js 内部。

安装程序

默认将 VS Code 注册为支持的文件类型

Windows 11 引入了新的文件资源管理器上下文菜单,它将“打开方式”置于菜单顶部,与“打开”分组。此更新使得更容易找到所有可用的编辑器并更改默认值。

遵循新的最佳实践,VS Code 的“注册 VS Code 作为关联文件类型的编辑器”复选框在 Windows 安装期间现在将默认勾选。我们还审查了关联文件类型的列表,并将其扩展以包含更多常用打开的文件类型。

Windows 11 上的 Microsoft Store

随着即将推出的 Windows 11,新的 Microsoft Store 可以支持更多传统的应用程序类型和安装程序。如果您已经通过 Windows Insider 计划测试 Windows 11,您现在可以通过在商店中搜索来安装最新版本的 VS Code。安装后,您将拥有与我们网站上的用户安装版本相同的 VS Code,并且更新将像现在一样在应用程序内处理。

Notebook

笔记本现在支持 Markdown 单元格之间的链接。

您可以使用以下方式创建指向 Markdown 单元格中标题的链接:

[Link text](#_header-slug)

header-slug 是标题的小写文本,其中所有空格或特殊字符都替换为 -。上面示例中的链接将指向标题 # Header Slug

处理大型输出时的性能改进

我们优化了处理笔记本中大型输出的方式,以显著提高性能。

在幕后,VS Code 使用 Uint8Arrays 将笔记本输出存储为二进制数据。以前,在扩展主机进程和渲染器进程之间传输输出数据时,数据首先被转换为数字值数组,然后序列化为 JSON。

要理解为什么这不利于性能,请考虑一个输出文本 Hello Code! 的笔记本。它在内部存储为 Uint8Array

new Uint8Array([72, 101, 108, 108, 111, 32, 67, 111, 100, 101, 33]);

该数据长 11 字节。旧的实现会将二进制数据转换为 JSON 字符串:

'[72,101,108,108,111,32,67,111,100,101,33]';

此字符串长 41 字节,是原始数据大小的 3.5 倍以上!需要传输的额外字节太多,并且接收方现在必须将该字符串解析为 JSON,才能将其转换回 Uint8Array。对于大小为几十 MB 的笔记本输出,此解析可能成为一个显著的瓶颈。

使用新实现,笔记本输出在传输过程中保持为二进制数据。您可以在拉取请求中阅读有关此实现细节的更多信息。

此修复显著改进了加载包含大型输出的笔记本以及在执行期间生成大型输出时笔记本的性能。

onNotebook 激活事件改进

当笔记本在工作区中打开时,VS Code 将发出 onNotebook:{type}onNotebook:* 事件,以便笔记本扩展在侦听这些事件时可以被激活。以前,VS Code 会等待所有侦听这两个事件的扩展,然后才打开文件,但现在它只会等待特定笔记本的序列化程序注册。例如,当用户在新的工作区中打开 ipynb 文件时,内置的 ipynb 序列化程序扩展将被激活,并且文件将立即打开。同时,VS Code 会向所有其他扩展(例如 Jupyter、.NET Interactive 或 Julia 扩展)发出激活事件。其他扩展的激活不会减慢文件操作,以确保快速打开笔记本。

笔记本布局自定义

您现在可以直接通过编辑器工具栏自定义笔记本布局设置。

Notebook layout customization actions available in the editor toolbar

语言特性

TypeScript 4.4

VS Code 现在包含 TypeScript 4.4。此更新带来了对许多新语言特性和改进的支持,包括静态块新的严格选项。它还增加了新的工具改进并修复了一些重要的错误。

您可以在 TypeScript 博客上阅读有关 TypeScript 4.4 的所有信息。

JavaScript 和 TypeScript 的内联提示

TypeScript 4.4 中最重要的新的工具功能是内联提示支持。内联提示向源代码添加额外的内联信息,以帮助您理解代码的作用。

例如,参数名内联提示显示函数调用中参数的名称。

Parameter name inlay hints

这可以帮助您一目了然地理解每个参数的含义,这对于接受布尔标志或参数容易混淆的函数特别有用。

要启用参数名提示,请设置 javascript.inlayHints.parameterNames.enabledtypescript.inlayHints.parameterNames.enabled。有三个可能的值:

  • none - 禁用参数内联提示。
  • literals - 仅显示字面量(字符串、数字、布尔值)的内联提示。
  • all - 显示所有参数的内联提示。

此外,VS Code 还提供内联提示,显示 JavaScript 和 TypeScript 代码中的隐式类型信息。

变量类型内联提示显示没有显式类型注释的变量的类型。

设置 - javascript.inlayHints.variableTypes.enabledtypescript.inlayHints.variableTypes.enabled

Variable type inlay hints

属性类型内联提示显示没有显式类型注释的类属性的类型。

设置 - javascript.inlayHints.propertyDeclarationTypes.enabledtypescript.inlayHints.propertyDeclarationTypes.enabled

Property type inlay hints

参数类型提示显示隐式类型参数的类型。

设置 - javascript.inlayHints.parameterTypes.enabledtypescript.inlayHints.parameterTypes.enabled

Parameter type inlay hints

返回类型内联提示显示没有显式类型注释的函数的返回类型。

设置 - javascript.inlayHints.functionLikeReturnTypes.enabledtypescript.inlayHints.functionLikeReturnTypes.enabled

Return type inlay hints

我们计划在未来继续改进内联提示,因此请务必分享您对新功能的任何反馈

JavaScript 文件中的拼写建议

VS Code 现在帮助您捕获 JavaScript 文件中简单的拼写错误。

Spelling suggestions in a plain JS files

拼写建议仅在有相当高的信心它们是实际错误而不是 IntelliSense 引擎不理解的代码模式时显示。您可以在添加此功能的 PR 中阅读有关此功能的更多详细信息。

您还可以通过设置以下内容来禁用这些建议:

"javascript.suggestionActions.enabled": false

要进行更全面的检查,请尝试在 JavaScript 代码中启用完整的语义检查。这不仅有助于捕获更多错误,还启用了几个有用的快速修复。

typescript.tsserver.useSyntaxServer

新的 typescript.tsserver.useSyntaxServer 设置允许您控制 TypeScript 是否启动专用服务器以快速处理与语法相关的操作,例如计算代码折叠。它替换了现在已弃用的 typescript.tsserver.useSeparateSyntaxServer 设置。

可能的值有:

  • auto - 启动一个完整的服务器和一个用于语法操作的轻量级服务器。语法服务器用于加快代码折叠等语法操作,并在项目加载时提供 IntelliSense。(默认)
  • always - 使用轻量级语法服务器处理所有 IntelliSense 操作。此语法服务器只能为已打开的文件提供 IntelliSense。
  • never - 不使用专用语法服务器。使用单个服务器处理所有 IntelliSense 操作。

预览功能

锁定编辑器组

随着编辑器区域中的终端的引入,我们收到了用户报告,他们对终端编辑器太容易或意外地被文件编辑器替换感到沮丧。默认情况下,文件将始终在活动编辑器组中打开,因此,即使终端处于活动状态,文件也会打开并隐藏终端。

锁定编辑器组提供了一种处理此问题的新方法,不仅适用于终端,也适用于任何编辑器。如果您打开了多个编辑器组,您现在可以锁定它,无论是使用新的命令之一还是通过“...”溢出菜单:

Lock Group action on the editor context menu

锁定组与未锁定组的行为不同:

  • 新编辑器不会在锁定组中打开,除非用户明确将其移动到那里(例如,通过拖放)。
  • 如果编辑器跳过锁定组进行打开,它将要么在最近使用的未锁定组中打开,要么在锁定组的旁边创建一个新组。
  • 编辑器组的锁定状态在重启后会持久保存和恢复。
  • 您也可以锁定空组,从而实现更稳定的编辑器布局。
  • 锁定组通过操作工具栏(右上角)中的锁定图标表示。

Locked editor group layout with lock icon

请参见以下演示,了解锁定编辑器组在实际操作中的行为。即使 Markdown 预览处于活动状态,新文件也会在左侧编辑器组中打开:

为此功能添加的命令是:

  • workbench.action.experimentalLockEditorGroup
  • workbench.action.experimentalUnlockEditorGroup
  • workbench.action.experimentalToggleEditorGroupLock

一个新的上下文键 activeEditorGroupLocked 可用于根据组的锁定状态有条件地绑定命令。

注意:相关设置和命令是实验性的,直到我们完成锁定编辑器组的设计。我们希望您对此新功能提供反馈,因此请不要犹豫报告问题

自动锁定编辑器组

在新的锁定编辑器组概念的基础上,新的 workbench.editor.experimentalAutoLockGroups 设置允许您选择在打开时应自动锁定组的编辑器。这仅适用于编辑器是第一个在空组或新组中打开的情况。

终端默认配置为导致新组自动锁定。在下面的短视频中,即使终端处于活动状态,从终端中选择的文件也会在左侧编辑器组中打开:

如果您希望 Markdown 预览自动锁定组,您可以将 mainThreadWebview-markdown.preview: true 添加到 experimentalAutoLockGroups 设置中。

在接下来的里程碑中,我们将致力于改进设置用户体验,以便能够选择编辑器而无需知道其标识符。相关设置和命令是实验性的,直到我们完成锁定编辑器组的设计。我们再次希望您提供反馈

“按文件名搜索”快速选择中的引号支持

本次迭代中,我们增加了在“按文件名搜索”快速选择(⌘P (Windows, Linux Ctrl+P))中通过将搜索字符串放在引号中来排除模糊搜索结果的功能。

此功能闪光的场景:

当查询只有几个字符时。

如果您想减少结果的“混乱”。

我们喜欢这种引用体验,它感觉很直观,因为大多数搜索引擎都使用类似的机制,但我们希望得到您的反馈。我们还在考虑在问题 #131431 中讨论的其他方法。

对扩展的贡献

Jupyter

逐行运行

VS Code 现在支持 Jupyter 笔记本中的“逐行运行”功能。这是一种简单的调试模式,允许您逐行执行单元格的代码。要尝试此功能,请确保已安装 ipykernel v6+ 作为您选择的内核,然后选择“逐行运行”按钮。

调试

还实验性地支持使用 VS Code 的完整调试功能调试 Jupyter 笔记本。要尝试此功能,请确保已安装 ipykernel v6+ 作为您选择的内核,设置 "jupyter.experimental.debugging": true,设置断点,然后选择“调试单元格”命令。

Jupyter 键映射

我们已将 Jupyter 经典键绑定提取到一个单独的Jupyter Keymap 扩展中,如果您喜欢使用 Marketplace 中的另一组笔记本键绑定,则可以禁用它。

Python

重新设计的测试界面

得益于新的测试 APIPython 扩展对其测试功能进行了改进。您现在可以享受更稳定的测试发现、导航和状态渲染体验,以及搜索测试、运行选定测试、重新运行上次执行的测试等新功能!

Running tests with the new Python Test Explorer

从编辑器在终端中运行和调试 Python 文件

您现在可以使用 Python 扩展直接从编辑器在终端中运行和调试您的 Python 文件。

GitHub 拉取请求和议题

GitHub Pull Requests and Issues 扩展中现在提供了备受期待的展开和折叠所有评论的功能。所有评论都可以通过命令“GitHub Pull Requests: Expand All Comments”和“GitHub Pull Requests: Collapse All Comments”进行展开和折叠。还有一个设置 githubPullRequests.commentExpandState 来控制展开折叠状态。最后,您还可以从评论 UI 中折叠所有评论:

Collapse all pull request comments button

要了解所有新功能和更新,您可以查看扩展 0.30.0 版本的完整更新日志

扩展创作

Web 扩展

当 VS Code 在浏览器中运行时,扩展会加载到也在浏览器中运行的扩展主机中。“Web 扩展主机”受到浏览器的限制,扩展无法访问本地文件系统或平台功能。为了帮助扩展作者更新其扩展以支持在 Web 版 VS Code 中运行,现在提供了Web 扩展创作指南。在这里,您将了解哪种类型的扩展在 Web 上最有效,如何访问 VS Code API,以及如何使用虚拟文件系统。

除了 Web 扩展指南之外,yo code 扩展生成器现在有一个选项可以搭建Web 扩展,并且还支持 @vscode/test-web 模块,用于从命令行测试 Web 扩展。

如果您还没有看到 Web 版 Visual Studio Code 的实际运行,您可以在 GitHub 仓库的“<> Code”选项卡中按“.”(句点键),您将启动基于 Web 的 VS Code 版本来浏览和编辑源代码。

命令的短标题

commands 贡献点允许扩展为命令定义 UI 属性,例如标题、类别或图标。另一方面,菜单是显示命令的“位置”,菜单可能会呈现命令的部分或全部 UI 属性。例如,某些菜单只渲染图标,而另一些则渲染标题或类别加标题。作为扩展作者,很难想出一个在全球和本地菜单中同样有效的命令标题。例如,命令面板可以显示比上下文菜单更多的单词。

为了允许不同的标题,有一个新的 shortTitle 属性。它允许命令提供一个较短的标题,根据 UI 的不同而效果良好,例如命令面板中的“笔记本:清除所有单元格输出”和笔记本工具栏中较短的“清除所有”。

应用程序主机已添加到环境命名空间

.env 命名空间现在包含应用程序主机 appHost 属性。appHost 允许扩展开发人员确定 VS Code 托管的环境。示例包括桌面、GitHub Codespaces、github.dev 和 vscode.dev。

RendererContext.workspace.isTrusted 用于笔记本渲染器

传递给笔记本渲染器的上下文对象上的新 workspace.isTrusted 属性允许扩展作者检查当前工作区是否受信任:

import type { ActivationFunction } from 'vscode-notebook-renderer';

export const activate: ActivationFunction<void> = (ctx) => {
  return {
    renderOutputItem: (outputInfo, element) => {
      if (ctx.workspace.isTrusted) {
        // Render normally. Still take precautions to avoid script injection and
        // only enable as much functionality as your renderer needs.
      } else {
        // Only render safe content. Always make sure it has been properly sanitized.
      }
    }
  }
};

特定于平台的扩展

我们在特定于平台的扩展方面取得了进展,该功能允许扩展作者为不同平台(Windows、macOS、Linux)创建单独的扩展版本。我们一直与 Marketplace 团队合作开发此功能,并已最终确定解决方案。在此里程碑中,我们开始实施并计划尽快将其提供给扩展作者。您可以关注问题 #23251 以获取更新并提供反馈。

更新的 codicons

以下新图标已添加到我们的codicon 库中:

An example of updated codicons

  • folder-library
  • run-errors

导览贡献更新

使用可主题化的 SVG 作为导览步骤媒体

导览步骤现在可以在其 media 对象中指定一个 svg 属性。除了更好的缩放支持外,SVG 还提供对主题令牌的访问,这可以使媒体在视觉上与工作台的其余部分融合。有关更多信息,请参阅我们的主题化 Webview 内容指南

声明导览感兴趣的文件

导览现在支持可选的 featuredFor 参数,该参数列出了给定导览适用的文件类型。当在工作区文件夹中找到这些文件时,导览将以更高的视觉优先级呈现。

任务默认组 API

TaskGroupisDefault 属性已最终确定。扩展现在可以获取任务,然后读取任务 groupisDefault 属性,以确定任务是否是该组的默认任务。

调试器扩展创作

“DebugSessionOptions”上的新“managedByParent”属性

新的标志 managedByParent 已添加到 DebugSessionOptions 类型。当传递给 startDebugging API 时,它控制断开连接和重新启动等生命周期请求是发送到新创建的会话还是其父会话。

调试适配器协议的“showUser”属性

launch 请求失败时,VS Code 现在将尊重调试适配器响应中发送的 showUser 属性。如果提供了 showUser 属性且其值为 false,则 VS Code 将显示带有错误的模式对话框。如果 showUser 属性缺失或为 true,则 VS Code 将像以前一样显示错误对话框。

对于其他调试适配器协议 (DAP) 请求,没有变化。如果 showUsertrue,则错误将以通知形式显示。否则,不会向用户显示任何内容。

VS Code 不再为“noDebug”调试会话注册断点

当 DAP 的 launch 请求的 noDebug 属性设置为 true 时,VS Code 将不再调用任何断点注册 DAP 请求(setBreakpointssetExceptionBreakpointssetDataBreakpointssetFunctionBreakpointssetInstructionBreakpoints)。

VS Code 现在支持 DAP“setExpression”请求

如果调试适配器实现了 setExpression 请求(supportsSetExpression 功能为 true),VS Code 将在两种情况下使用 setExpression

  • 在 VARIABLES 和 WATCH 视图中,用于更改变量的值,如果调试适配器不支持 setVariable 请求(supportsSetVariable 功能缺失或为 false)并且变量具有 evaluateName 属性且可编辑(VariablePresentationHint 中的 readOnly 属性不为 true)。
  • 在 WATCH 视图中,用于更改可赋值表达式的值,如果监视表达式可编辑(VariablePresentationHint 中的 readOnly 属性不为 true)。

抑制 DAP 错误消息中的“打开 launch.json”按钮

调试适配器协议允许 MessageErrorResponse 返回一个 url,其中可以找到有关消息的额外信息,以及一个 urlLabel,它作为打开 URL 的 UI 呈现给用户。当 VS Code 在模式对话框中向用户显示消息时,会显示一个带有 urlLabel 标题的按钮。在此版本之前,VS Code 还会添加一个标题为“打开 launch.json”的按钮。如果消息的 url 使用“command”方案(例如 command:myExtension.fixError),则不再添加该按钮。

调试适配器协议

发布新的“memory”事件

memory 事件已完成,现在可在 调试适配器协议 1.49 版和相应的 npm 模块中使用。如果调试适配器已收到 initialize 请求的 supportsMemoryEvent 功能为 true 的值,则调试适配器可以发出 memory 事件,以指示某些内存范围已更新。

建议的扩展 API

每个里程碑都会带来新的提议 API,扩展作者可以尝试使用它们。一如既往,我们希望得到您的反馈。要尝试提议的 API,您需要执行以下操作:

  • 您必须使用 Insiders 版本,因为提议的 API 经常更改。
  • 您的扩展的 package.json 文件中必须包含以下行:"enableProposedApi": true
  • 将最新版本的 vscode.proposed.d.ts 文件复制到您项目的源位置。

您不能发布使用提议 API 的扩展。下个版本中可能会有破坏性更改,我们绝不希望破坏现有扩展。

支持类型层次结构

有一个关于TypeHierarchyProvider的 API 提案,允许扩展为符号提供超类型和子类型。该 API 已准备好试用,如果您发现问题或有建议,可以在 VS Code 仓库中提出。

随处创建终端

提议的终端位置 API 允许在面板和编辑器区域中创建终端拆分。

查询和事件,用于判断终端是否已“交互”过

一个新的提议 API Terminal.state 和 window.onDidChangeTerminalState 允许查询终端是否已“交互”。交互意味着已向进程发送数据,可能出于各种原因,主要原因是键盘输入。

QuickPickItem 中的按钮

有一个在 QuickPickItem 中添加和处理按钮的提议 API。我们希望这将使扩展能够为 Quick Pick 提供更丰富的用户交互。

Buttons in QuickPickItems

请尝试一下,并告诉我们您的想法。需要注意的是,目前存在一个关于 Quick Pick 滚动位置的已知问题,我们认为新的提议 API 会放大此问题。我们正在研究解决此问题的正确 API 集。请通过参与该问题告诉我们您的想法。

测试标签

测试标签是一个提议的 API,它提供了一种组织测试的方法,并指示哪些测试是可运行的。

非错误测试输出

测试 API 支持测试失败消息,但以前没有办法将非错误输出与某个测试用例关联起来。我们正在评估一种方法,通过将可选的 TestItemlocation 传递给 TestRun.appendOutput 方法来实现这一点。如果您有任何意见,请在问题 #129201 上留下反馈!

内联补全提供程序:与自动补全小部件的交互

InlineCompletionContext 有一个新字段 selectedCompletionInfo,其中包含自动补全小部件中当前选定建议的详细信息。此外,当用户更改自动补全小部件中选定的项目时,会要求 InlineCompletionItemProvider 提供内联建议。如果内联建议扩展了选定的建议项目,则该扩展会以斜体显示。

工程

修复对 RHEL7 和 Centos7 发行版的支持

在 VS Code 1.53 版中,我们更新了构建镜像以使用较新的 Electron 版本,这导致了原生模块的 CXXABI 要求发生变化,从而在某些发行版中破坏了我们的 rpm 包(问题 #115784)。随着 Electron v13 的更新,我们现在能够使用与运行时相同的编译器工具链构建我们的原生模块,特别是我们现在使用 Clang 并静态链接运行时的 libcxx。这使我们能够绕过 CXXABI 要求,二进制文件大小仅增加约 10 MB,并重新支持这些发行版。感谢您的耐心等待和在 Insiders 上进行测试的帮助。

文档

VS Code 中的 Julia

新增了VS Code 中的 Julia 主题,描述了 VS Code 对Julia 编程语言的支持,通过Julia 扩展。Julia 扩展包括丰富的语言特性,如代码补全、代码导航和调试,以及集成 REPL 和绘图导航器。

Julia extension

Azure 机器学习

您可以阅读VS Code 中的 Azure 机器学习概述,了解Azure 机器学习扩展如何让您直接从 VS Code 使用基于 Azure 机器学习云的机器学习模型

值得注意的修复

  • 82489:使用“AltGr”键时键盘输入不正确
  • 115945:调试工具栏贡献命令在工具栏停靠时缺失
  • 118196:重新启动调试会话时,args-list 中的元素不更新
  • 121201:iPad 上菜单选择渲染不正确
  • 124128:调试停止时,扩展开发窗口未关闭
  • 125259:调试在启动前不保存 launch.json
  • 126102:SkipFiles 仍然临时打开要跳过的文件,导致速度变慢
  • 126911:扩展调试:停止调试会话不关闭窗口
  • 128484:调试:启动失败时禁用模式对话框的选项
  • 129019:开始时关闭的树视图需要另一次刷新(或重新打开)才能显示内容
  • 129469:设置编辑器输入框可以更大
  • 129645:在设置 UI 中启用代码块语法高亮
  • 129844:markdownEnumDescriptions 不删除设置 UI 中的 markdown ``##`` 也不删除 settings.json 中的 ##
  • 130265:Node 调试器不会在未处理的 Promise 拒绝上中断

感谢

最后但同样重要的是,衷心感谢以下本月为 VS Code 做出贡献的人们:

对我们问题跟踪的贡献

vscode 的贡献

vscode-generator-code 的贡献

vscode-js-debug 的贡献

vscode-pull-request-github 的贡献

debug-adapter-protocol 的贡献

language-server-protocol 的贡献

monaco-editor 的贡献

monaco-html 的贡献

monaco-languages 的贡献