现已可用！阅读关于 11 月份的新功能和修复。

2021 年 2 月（版本 1.54）

更新 1.54.1：此更新解决了扩展依赖项的 问题。

更新 1.54.2：此更新解决了这些 问题。

更新 1.54.3：此更新解决了这个 问题。

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

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

如果您想在线阅读这些发行说明，请访问 更新，网址为 code.visualstudio.com。

加入我们的直播，参加 3 月 11 日星期四太平洋时间上午 8 点（伦敦时间下午 4 点）的 VS Code 团队直播，观看此版本新功能的演示，并现场向我们提问。

内部人员：想要尽快尝试新功能吗？您可以下载每晚的 内部人员 构建版本，并尽快尝试最新更新。

Apple Silicon

我们很高兴宣布在此迭代中首次发布稳定的 Apple Silicon 构建版本。使用 M1 芯片的 Mac 用户现在可以使用 VS Code，无需使用 Rosetta 进行模拟，并且在运行 VS Code 时会注意到更好的性能和更长的电池续航时间。感谢社区使用内部人员构建版本进行自托管，并在迭代早期报告问题。

macOS 的 VS Code 默认下载现在是通用构建版本，可以在所有 Mac 上本地运行。在下载页面上，您可以找到更多指向特定架构的构建版本的链接，适用于 Intel 或 Apple Silicon，与通用软件包相比，这些版本的下载量更小。

Website showing the new downloads view for Apple Silicon builds

Website showing the default download for macOS

辅助功能

工具栏和选项卡占用一个制表位

工作台中所有工具栏现在都遵循标准导航行为，因此工具栏在制表顺序中仅占用一个位置，并且可以使用箭头键导航。一旦焦点在工具栏上，应使用箭头键将焦点移动到工具栏中的特定项目。由于此更改，工作台的制表位大大减少，从而更容易在所有部件之间导航。

为了保持一致性，同样的更改也应用于选项卡区域。因此，整个选项卡区域只有一个制表位，选项卡之间的键盘导航应使用左右箭头键完成。

Windows 上的单词导航

我们改进了 Windows 上单词导航的方式，使其与 Windows 上屏幕阅读器对基于 Electron 的应用程序的期望保持一致。现在，当使用单词导航时，屏幕阅读器会正确读出每个单词。

由于此更改，我们将弃用以下命令。它们仍然可以工作，但我们可能会在将来删除它们。

  • cursorWordAccessibilityLeft
  • cursorWordAccessibilityLeftSelect
  • cursorWordAccessibilityRight
  • cursorWordAccessibilityRightSelect

非 Windows 平台已经按预期工作，因此我们没有在那里进行任何更改。

改进了视图和按钮的角色

根据用户反馈，我们改进了工作台中多个视图和按钮的角色。活动栏、侧边栏和面板现在具有 role:none，这将使屏幕阅读器不那么冗长。活动栏内的管理和帐户按钮现在正确地声明它们具有弹出窗口。

集成终端

在窗口重新加载时保留终端进程

本地终端进程现在在窗口重新加载时恢复，例如当扩展安装需要重新加载时。终端将重新连接，并且终端的 UI 状态将恢复，包括活动选项卡和拆分终端的相对尺寸。

In a local window, two split terminals are created and resized. On reload, the layout appears unchanged.

可以通过将 terminal.integrated.enablePersistentSessions 设置为 false 来禁用此功能。

Windows 性能改进

感谢新的终端进程布局，来自终端进程的频繁 pty 数据事件现在应该可以更快地处理。由于 Windows 上 conpty 提供的事件较小，因此预计这对 Windows 的影响比其他平台更大。

自动重新启动需要环境更改的终端

最近推出了一项新功能，使扩展能够影响终端的环境。各种语言扩展和内置的 Git 扩展都使用此功能来启用 VS Code 作为 Git 身份验证提供程序，从而无需登录。以前，此操作的 UX 是在右上角显示一个细微的 ⚠️ 图标，以指示终端的环境已过时。该指示器很细微，因为环境更改可能重要，也可能不重要。

我们对此进行了调整，以便在尚未与终端交互时自动重新启动具有过时环境的终端。这可能会导致一些闪烁，但扩展终端集成现在更加无缝。例如，在 WSL 窗口中的第一个终端应该不再显示 Git 身份验证错误，前提是重新启动发生在在终端中键入之前。

工作台

Emmet

使用缩写包装和使用缩写包装各个行命令已合并为一个使用缩写包装命令，以减少对使用哪个包装命令的任何困惑。此外，使用缩写包装命令现在可以正确显示预览空格。

emmet.extensionsPath 设置现在也可以接收路径数组，而不仅仅是字符串。因此，当与设置同步结合使用时，可以根据它们所在的机器指向不同的代码片段文件，而无需为每台机器更新设置。

产品图标主题

第一个产品图标主题已在扩展市场中提供。感谢主题作者的辛勤工作！

要选择或查找主题，请使用命令提示符或“设置”齿轮中的首选项：产品图标主题命令。

Product icon themes in the Extension Marketplace

上下文键的 IntelliSense

VS Code 使用 when 子句来启用和禁用键绑定。扩展还使用 when 子句来控制 菜单和视图贡献。编写这些 when 子句现在变得简单得多，因为编辑器为它们提供了补全。

keybindings.json 中上下文键的 IntelliSense 主题：GitHub Light Theme，字体：FiraCode

打开编辑器“新建未命名文件”操作

现在在打开的编辑器视图标题区域中有一个新建未命名文件操作。

New untitled file in Open Editors view

更新的应用程序菜单设置

应用程序菜单可见性的 window.menuBarVisibility 设置已更新，以更好地反映这些选项。已进行两项主要更改。

首先，该设置的 default 选项已重命名为 classic。

其次，应用程序菜单栏中的显示菜单栏条目现在在 classic 和 compact 选项之间切换。要完全隐藏它，您可以更新设置，或者在 compact 模式下使用活动栏的上下文菜单。

应用程序菜单中的“显示菜单栏”条目 主题：GitHub Light Theme

Webview 缓存改进

我们改进了 Webview 中本地文件的缓存。如果 Webview 从磁盘重新加载文件，那么如果文件没有更改，我们现在会使用 ETags 来避免再次读取文件。这可以消除数据传输，并提高响应时间，尤其是在远程工作区中。

此缓存当前仅适用于现有 Webview 重新加载资源时。它不适用于新创建的 Webview，即使该 Webview 属于之前创建类似 Webview 的扩展。

工作区搜索操作的更改

我们修改了现有的 workbench.view.search，使其不再将选定的文本放入搜索输入框，而是直接打开输入框。要使用选定的文本并遵守 search.mode 设置创建新的搜索，应使用 workbench.action.findInFiles。

仅修饰键的按键绑定

现在可以为重复的修饰键定义按键绑定，例如 shift shift、alt alt、ctrl ctrl 或 cmd cmd / meta meta / win win。这些按键绑定可以手动输入到 keybindings.json 中，例如

{ "key": "shift shift", "command": "workbench.action.quickOpen" }

更新的列表/树 UI

我们更新了列表/树样式，以匹配原生焦点和选择指示器：获得焦点的元素现在将以轮廓颜色渲染。

List/tree UI showing focused element

重大更改

建议主题发布者也采用此样式，只需将 list.focusBackground 颜色的自定义替换为 quickInput.list.focusBackground 颜色即可。要查看示例，请查看此提交。

表格小部件

我们引入了一个新的表格小部件，它建立在现有列表小部件之上，因此我们可以像渲染列表元素一样渲染表格数据，并且性能相同。目前，它在远程功能的“端口”视图中使用。

Table widget view of remote Ports

入门

我们正在试验一个新的编辑器，在启动时显示，称为“入门”编辑器。目的是让新用户更容易了解 VS Code 的一些功能。一些 Insiders 用户可能已经看到它，并且将在本次迭代过程中逐步推广到更多稳定版用户。您始终可以通过将 workbench.startupEditor 设置修改为或取消为 gettingStarted 来选择启用或禁用新行为。

Getting Started experience walkthrough

时间线视图

现在可以使用“选择进行比较”和“与所选内容比较”命令来比较 Git 历史时间线条目之间的更改，类似于在资源管理器视图中比较文件。此功能可让您快速查看 Git 文件历史记录中任意两次提交之间的所有更改。

Select for Compare command in context menu

默认的侧边栏悬停边框颜色

在 1.52 版本 中，我们引入了侧边栏的悬停边框颜色标记 (sash.hoverBorder)，但未设置默认值。我们现在在所有主题中默认显示此颜色。

Sash hover border color

调试

断点视图的改进

用于删除断点的新内联操作

我们在断点视图中添加了一个内联操作 X 来删除断点。此操作应该可以更轻松地删除断点。

Breakpoints view showing X next to selected breakpoint

异常筛选器的帮助文本支持

最近，我们增加了在断点视图中编辑异常筛选器条件的支持。

为了使这些条件更容易被发现，并且其语法具有自解释性，VS Code 现在会在异常筛选器上显示悬停提示，并在条件文本框中显示占位符文本。

由于这两个信息都由底层调试扩展提供，因此它可以比某些通用消息更具体（因此更有帮助）。

由于此新功能基于对调试适配器协议的添加（见下文），因此它需要调试扩展的参与。在此版本中，只有 VS Code 的内置 JavaScript 调试器支持此新功能。

Breakpoint placeholder

新设置和其他改进

在调试控制台中折叠相同的行

有一个新的设置 debug.console.collapseIdenticalLines，用于控制调试控制台是否应折叠相同的行并显示带有标记的多个出现次数。默认设置为折叠。

控制在调试之前要保存哪些编辑器

有一个新的设置 debug.saveBeforeStart，用于控制在调试开始之前要保存哪些编辑器。此设置具有以下值

  • allEditorsInActiveGroup：保存活动组中的所有编辑器。默认值。
  • nonUntitledEditorsInActiveGroup：保存活动组中的所有编辑器，但不保存未命名的编辑器。
  • none：不保存任何编辑器。

此设置对于 PowerShell 调试非常有用，因为 PowerShell 调试器支持调试未保存的文件。

改进了“重新启动帧”操作的启用

通过对调试适配器协议的新增功能，调试扩展现在能够向 VS Code UI 传达“重新启动帧”操作在选定的堆栈帧上是否可用。VS Code 现在会在调用堆栈视图中禁用无法重新启动的堆栈帧的重新启动帧内联操作。

例如，JS-Debug 扩展已经采用了此功能，现在异步堆栈跟踪会禁用重新启动帧操作。

语言

TypeScript 4.2

VS Code 现在随附 TypeScript 4.2.2。此主要更新包括许多 TypeScript 语言改进，以及许多针对 JavaScript 和 TypeScript 工具的改进和错误修复。

您可以在 TypeScript 博客上阅读有关 TypeScript 4.2 的更多信息。

快速修复以声明缺少的函数

新的添加缺少的函数声明快速修复会为缺少的函数存根。例如，如果我们调用一个缺少的函数 add

const x: number = add(1, 2);

在 add 上使用添加缺少的函数声明会产生

const x: number = add(1, 2);
function add(arg0: number, arg1: number): number {
  throw new Error('Function not implemented.');
}

您可以在编写代码时使用此快速修复，以根据调用签名快速存根函数。

要在 JavaScript 中使用此快速修复，您必须启用类型检查。

JS Doc 模板现在生成 @returns

如果被注释的函数包含 return 语句，JS Doc 模板现在会自动包含 @returns。例如，对于函数 getViz

function getViz(el) {
  return el?.viz;
}

生成的 JSDoc 模板是

/**
 *
 * @param {*} el
 * @returns
 */
function getViz(el) {
  return el?.viz;
}

您可以使用 javascript.suggest.jsdoc.generateReturns 和 typescript.suggest.jsdoc.generateReturns 在 JSDoc 注释中禁用 @returns。

已弃用的 DOM API 现在被标记

已弃用的 DOM 方法现在在建议和代码中标记为已弃用

document.clear being marked as deprecated in code

您可以通过设置 editor.showDeprecated: false 来禁用在编辑器中显示已弃用的属性和函数。

笔记本

自动重新加载笔记本

当笔记本的文件在磁盘上发生更改，并且没有未保存的更改时，笔记本现在会自动重新加载。这应该可以更轻松地处理在版本控制下的笔记本。

改进了大型单元格的焦点

当焦点位于大型笔记本单元格上时，您现在可以更好地分辨哪个单元格获得了焦点，即使单元格的顶部和底部不在视图中。我们现在会在获得焦点的单元格的左侧和右侧显示边框。

Notebook focus for a large cell

CSS/LESS/SCSS 和 HTML 中的悬停提示

您现在可以微调 HTML 和 CSS 中悬停提示的内容，以

  • 不显示来自 MDN 的文档
  • 不显示指向 MDN 页面的链接

使用 css.hover.documentation 和 css.hover.references 设置来更改 CSS 的悬停提示。将 css 替换为 html、css、scss 或 less 以更改这些语言的设置。

预览功能

用于笔记本的可扩展 Markdown 渲染器

在此迭代中，我们探索了使笔记本单元格的 Markdown 渲染器可扩展。例如，在下面的屏幕截图中，我们扩展了 VS Code 的 Markdown 渲染器，以支持在笔记本单元格中显示数学公式

A math formula being rendered in a notebook cell

为了使我们的 Markdown 渲染器可扩展，我们探索了使用 Markdown It 来渲染所有笔记本 Markdown。我们还探索了将渲染的 Markdown 移动到笔记本的底层 Webview 中。

虽然我们还没有准备好为此开放官方 API，但我们计划在 3 月继续进行此探索。您也可以使用未记录的 notebook.experimental.useMarkdownRenderer: true 设置来试用新的可扩展 Markdown 渲染器。

扩展的贡献

Brackets

来自 Brackets 源代码编辑器的开发人员可以使用 Brackets 键绑定扩展在 VS Code 中继续使用相同的键盘快捷键。还有一个 Brackets 扩展包，其中捆绑了用于使用 CSS 和创建实时预览的扩展。

Brackets Extension Pack in the Marketplace

GitHub Pull Requests and Issues

在 GitHub Pull Requests and Issues 扩展上的工作仍在继续，该扩展允许您处理、创建和管理拉取请求和问题。

要了解所有新功能和更新，您可以查看该扩展的 0.24.0 版本的完整变更日志。

远程开发

在 远程开发扩展上的工作仍在继续，该扩展允许您使用容器、远程计算机或 适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。

1.54 中的功能亮点包括

  • 端口视图表格布局
  • 远程 - SSH：X11 转发
  • WSL：改进的 WSL 2 支持

您可以在 远程开发发行说明中了解新的扩展功能和错误修复。

扩展编写

编辑器标题菜单和“运行”子菜单的限制

编辑器工具栏 (editor/title) 中的空间有限。因此，我们有

  • 实现了溢出行为。当主组（即使用图标渲染的操作组）超过 9 个命令时，所有其他命令都会溢出到 ... 菜单中。
  • 添加了 editor/title/run 子菜单。我们要求扩展作者将运行和调试命令贡献到此菜单中，而不是像我们在 先前版本中建议的那样贡献到 editor/title 菜单中。此外，不再需要在命令中使用神奇的组值 1_run@10 和 1_run@20 以使命令显示在正确的位置。

Run dropdown menu

还请注意，运行子菜单是动态的，当它是唯一的子菜单时，会将自身替换为它的第一个子菜单。

身份验证提供程序 API

您现在可以注册一个身份验证提供程序，其他扩展可以使用该提供程序对服务执行身份验证。

扩展市场的新反馈渠道

有一个新的公共存储库，用于解决与扩展市场相关的问题。如果您有技术问题、想提供反馈或有功能请求，请打开一个问题。

更新的 codicon

我们向我们的 codicon 库添加了以下新图标

  • debug-rerun
  • gather
  • git-pull-request-create
  • notebook-template
  • run-above
  • run-below
  • type-hierarchy
  • type-hierarchy-sub
  • type-hierarchy-super
  • variable-group

Codicons for tasks

我们还更新了以下图标以保持一致性

  • debug-alt-small
  • debug-alt
  • debug-rerun
  • play-circle
  • play
  • run-above
  • run-all
  • run-below

Consistent codicons

提议的扩展 API

每个里程碑都带有新的建议 API，扩展作者可以试用它们。一如既往，我们需要您的反馈。这是您试用建议的 API 所需的操作

  • 您必须使用 Insiders 版本，因为建议的 API 会频繁更改。
  • 你的扩展的 package.json 文件中必须包含此行："enableProposedApi": true。
  • 将最新版本的 vscode.proposed.d.ts 文件复制到你项目的源代码位置。

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

图标贡献点

图标贡献点允许扩展程序通过 ID 定义新的图标，以及默认图标。然后，该图标 ID 可以被扩展程序（或任何依赖该扩展程序的其他扩展程序）在可以使用 ThemeIcon 的地方使用：在 Markdown 字符串 中（例如，"$(distro-ubuntu)" Ubuntu 20.04"）和所有接受 ThemeIcon 的地方（例如，new ThemeIcon("distro-ubuntu")）。

产品图标主题可以重新定义图标（如果它们知道图标 ID）。

有关更多信息，请参阅 issue 114942，了解详细信息并提供反馈。

内联值提供程序 API

目前，VS Code 调试器的“显示内联值”功能基于 VS Code 核心中的通用实现，不提供通过设置进行自定义或通过扩展进行扩展的功能。因此，它并不完全适合所有语言，有时会显示不正确的值，因为它不理解底层源代码语言。因此，我们正在开发一个扩展 API，该 API 允许完全替换内置实现，或用自定义代码替换部分实现。

在这个里程碑中，我们首次实现了 建议 API。

以下是内联值提供程序 API 的简述

  • 必须为一种语言注册一个 InlineValuesProvider。
  • 对于给定的文档，InlineValuesProvider 必须找到所有应该显示内联值的语言元素。
  • 对于每个元素，必须返回一个 InlineValue 描述符对象，该对象指示 VS Code 要显示的信息。目前，支持三种类型的 InlineValue 对象
    • InlineValueText：要显示的完整文本，
    • InlineValueVariableLookup：变量的名称，VS Code 将尝试在“变量”视图中查找其值。然后，名称和值以“name = value”的形式显示，
    • InlineValueEvaluatableExpression：VS Code 将发送到调试器进行评估的表达式。然后，表达式和结果以“expression = result”的形式显示。

以下代码片段（来自 Mock Debug）显示了“markdown”文件的最小内联值提供程序，该提供程序使用正则表达式来查找“变量”，然后指示 VS Code 通过“变量”视图查找其值

vscode.languages.registerInlineValuesProvider('markdown', {
  provideInlineValues(
    document: TextDocument,
    viewport: Range,
    context: InlineValueContext
  ): ProviderResult<InlineValue[]> {
    const allValues: InlineValue[] = [];
    for (let l = 0; l <= context.stoppedLocation.end.line; l++) {
      const line = document.lineAt(l);
      var regExp = /local_[ifso]/gi; // match variables of the form local_i, local_f, Local_i, LOCAL_S...
      do {
        var match = regExp.exec(line.text);
        if (match) {
          const varName = match[0];
          const varRange = new Range(l, match.index, l, match.index + varName.length);
          allValues.push(new InlineValueVariableLookup(varRange, varName));
        }
      } while (match);
    }
    return allValues;
  }
});

现在是内联值提供程序在运行时的样子

Debugger shows inline values

如果您想为此建议的 API 提供反馈，请在此 issue 中添加评论。

测试

我们在 VS Code 中的测试方面继续取得进展。本月，我们专注于改进 VS Code 中的基本体验和扩展 API。我们还发布了一些关于测试的临时文档，随着 API 的不断稳定，这些文档将得到充实。

语言服务器协议

即将发布的 3.17 版本中实现了 诊断拉取模型的第一个提案。该提案可在下一版本的 VS Code LSP 库中找到。

调试适配器协议

ExceptionBreakpointsFilter 的更多帮助文本属性

两个可选的 UI 属性 description 和 conditionDescription 已添加到 ExceptionBreakpointsFilter 中。

使用这些属性，客户端可以显示有关异常断点的其他信息。description 属性可以显示在悬停时，而 conditionDescription 可以用作文本框的占位符文本，在文本框中可以编辑条件。

改进了 setExceptionBreakpoints 请求的描述

我们改进了 setExceptionBreakpoints 请求的描述，添加了有关如果用户输入无效的异常断点条件时适配器应执行的操作的指导。

堆栈帧的新 canRestart 属性

一个新的可选布尔属性 canRestart 已添加到堆栈帧中。它指示是否可以使用 restart 请求重新启动堆栈帧。根据此信息，客户端可以启用或禁用“重新启动帧”上下文菜单操作。

工程

Electron 沙箱的进展

在这个里程碑中，我们继续使 VS Code 窗口准备好启用 Electron 的 沙箱 和 上下文隔离 功能。

具体来说

  • 我们能够将渲染器中的一些本机模块要求移动到其他进程。
  • 当启用沙箱时，MessagePort 通信通道已实现。

新的终端进程布局

终端进程现在在新 “pty host” 进程下生成，而不是在窗口进程下生成。此更改不仅是 Electron 沙箱的一部分，还应提高终端的稳定性和性能。

Windows 安装程序发布到 Windows 包管理器

x86 和 x64 的 Windows 用户和系统安装程序现在发布到 Windows 包管理器。您可以使用 winget 工具搜索所有 Visual Studio Code 安装程序 - winget search vscode，并 安装 任何已发布的安装程序。

使用 TypeScript 4.3 构建 VS Code

VS Code 现在使用 TypeScript 4.3 的每日构建版本进行构建。这使我们能够验证 TypeScript 团队的最新工作，并提供关于新更改的反馈。

最新的 TypeScript 版本已经帮助我们捕获了一些我们在条件语句中遗漏 await 的情况。

防止 yarn.lock 更改

我们现在有了 CI，可以防止针对 yarn.lock 文件的 PR，以提高供应链安全性。

默认分支：main

我们已经开始将所有存储库的默认分支重命名为 main，包括 microsoft/vscode。我们已经完成了大约 60% 的工作。

文档

VS Code 和课堂中的 Python

阅读哈维穆德学院的一位计算机科学教授的 案例研究，他在他的 Python 入门 CS 课程中使用 VS Code。了解他为学生推荐的设置，以及有用的扩展程序和免费的自定进度的 Python 和数据科学课程。

扩展故障排除博客文章

每个人都喜欢安装和使用 VS Code 扩展。但是，当您安装了大量扩展时，有时编辑器可能会开始表现得“奇怪”，并且如果该行为是由特定扩展引起的，那就太好了。如果您错过了早期关于 扩展二分法实用工具的公告，您可以阅读这篇 “使用二分法解决扩展问题”博客文章，其中描述了如何快速排除“不良”扩展的故障，甚至帮助扩展作者提供反馈。

值得注意的修复

  • 100151：菜单键应用于资源管理器中的错误项
  • 112055：调试为每个 Python 会话打开一个新的集成终端
  • 114881：复制文件夹或文件时保留符号链接
  • 114933：“任务无法跟踪” 令人沮丧
  • 115922：光标键在文件资源管理器中筛选时不起作用
  • 116037：调试控制台中不显示输出的链接悬停
  • 116101：我无法在命令搜索中找到目标命令，因为英文描述已消失
  • 116932：从贡献的命令执行中抛出自定义异常会显示神秘的错误弹出窗口

感谢

最后但同样重要的是，非常感谢本月为 VS Code 做出贡献的以下人员

对我们的问题跟踪的贡献

对 vscode 的贡献

对 language-server-protocol 的贡献

对 vscode-languageserver-node 的贡献

对 vscode-emmet-helper 的贡献

对 vscode-html-languageservice 的贡献

对 vscode-js-debug 的贡献

对 vscode-textmate 的贡献

对 vscode-vsce 的贡献