在 VS Code 中试试 ！

2021 年 6 月 (版本 1.58)

更新 1.58.1：此更新修复了这些安全问题。

更新 1.58.2：此更新修复了这些问题。

下载：Windows：x64 Arm64 | Mac：Universal Intel silicon | Linux：deb rpm tarball Arm snap

欢迎来到 Visual Studio Code 2021 年 6 月版本。此版本中有许多更新，希望您会喜欢，其中包括一些主要亮点：

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

加入我们的直播：请于 7 月 13 日星期二太平洋时间上午 8 点（伦敦时间下午 4 点）观看 VS Code 团队的直播，了解此版本中的新功能演示，并向我们提问。

Insiders 版本： 想尽快试用新功能吗？您可以下载每夜构建的 Insiders 版本，并尽快试用最新的更新。

工作台

工作区信任

工作区信任功能是 1.57 版本中的一项重大变化，我们认为即使开发人员不熟悉源代码，也能安全地浏览代码，这非常重要。在本里程碑中，我们一直在吸收客户反馈，并专注于修复问题和采纳建议。

为了帮助人们发现可以自定义工作区信任的用户设置，工作区信任编辑器的标题中新增了配置您的设置操作。此操作将弹出按 @tag:workspaceTrust 筛选的设置编辑器。

Configure your settings action in the Workspace Trust editor

说到设置，有一个新设置可以配置何时出现指示当前窗口处于受限模式的横幅。与 security.workspace.trust.startupPrompt 设置类似，新的 security.workspace.trust.banner 允许您在熟悉工作区信任功能后禁用该横幅，无需提醒您正在受限模式下工作。默认情况下，此横幅每个工作区显示一次，直到被关闭 ("untilDismissed")。显示受限模式横幅的其他选项包括 "always" 和 "never"。

您可以在最近的工作区信任博客文章中了解有关工作区信任的基本原理和开发的更多信息。该文章解释了受限模式如何帮助保护您免受非预期和潜在恶意代码执行的侵害，并提供了设置开发计算机以便快速安全地工作的技巧。

设置编辑器

本次迭代为设置编辑器增加了对具有固定数量布尔属性的设置对象的支持，方法是将属性渲染为复选框列表。

Settings editor Boolean object renderer demo

本次迭代还增加了对枚举数组的额外支持，在编辑模式下使用下拉列表代替纯文本框。

Settings editor enum array renderer demo

瞬时工作区

现在有一种新的工作区类型，称为“瞬时”工作区，其行为与普通工作区不同，具体表现为：

  • 重启或重新加载 VS Code 不会尝试再次打开此工作区。
  • 设置为瞬时的工作区不会出现在最近打开的工作区列表中。

通过在工作区 .code-workspace 文件中添加设置为 true 的 transient 属性来指定瞬时工作区：

{
  "folders": [],
  "transient": true
}

设置同步

设置同步现在有一个故障排除视图，其中包含所有日志和上次同步状态。您可以通过运行命令 Settings Sync: Show Synced Data（设置同步：显示同步数据）来访问此视图，并通过打开视图子菜单并勾选故障排除来启用它。

Settings Sync Troubleshoot command in the Settings Sync view menu

主题：GitHub Light Theme

搜索最大结果设置

新增了一个设置 search.maxResults，它允许您设置文本搜索结果的最大数量。默认值为 20,000，高于之前的 10,000。加载大量搜索结果时可能会出现一些缓慢。

集成终端

编辑器区域中的终端

现在可以在编辑器区域中创建或移动终端，从而实现多维网格布局，该布局会持久存在并且无论面板状态如何都可见。

在编辑器区域中使用终端有多种选项：

  • 通过 Create Terminal in Editor Area（在编辑器区域创建终端）命令创建。
  • 将终端从选项卡列表拖放到编辑器中。
  • 在终端获得焦点时运行 Move Terminal into Editor Area（将终端移动到编辑器区域）。
  • 在终端选项卡上下文菜单中选择 Move into Editor Area（移动到编辑器区域）。

4 terminals in the editor area are laid out in a 2 by 2 grid

新的 terminal.integrated.defaultLocation 设置可以设置为 editor，以默认将新创建的终端定向到编辑器区域。

显式设置 Canvas 渲染器

在之前的迭代中，我们默认启用了 WebGL 终端渲染器，并用更简单的 terminal.integrated.gpuAcceleration 替换了 terminal.integrated.rendererType 设置。不幸的是，某些机器在使用 WebGL 时体验会下降，而唯一可用的选项是完全禁用 GPU 加速并转向慢得多的基于 DOM 的渲染器。现在可以将 terminal.integrated.gpuAcceleration 显式设置为 canvas，这可能对这些环境更佳。

隐藏链接悬停

新的 terminal.integrated.showLinkHover 设置允许您禁用终端中的链接悬停。如果您觉得终端链接上的悬停提示令人分心，这会很有用。

编辑器

编辑器滚动条自定义

新增了自定义编辑器滚动条的设置：

  • 使用 editor.scrollbar.horizontal 和 editor.scrollbar.vertical 控制滚动条可见性。
  • 使用 editor.scrollbar.horizontalScrollbarSize 和 editor.scrollbar.verticalScrollbarSize 更改其厚度。
  • 使用 editor.scrollbar.scrollByPage 确定单击是按页滚动还是跳转到单击位置（默认行为）。

下图是编辑器垂直滚动条宽度设置为 30 像素的效果。

Vertical editor scroll bar width set to 30 pixels

语言

Markdown 预览中的数学公式渲染

VS Code 内置的 Markdown 预览现在可以使用 KaTeX 渲染数学公式。

Math rendering in the built-in Markdown preview

行内数学公式用单美元符号括起来

Inline math: $x^2$

您可以使用双美元符号创建数学公式块

Math block:

$$
\displaystyle
\left( \sum_{k=1}^n a_k b_k \right)^2
\leq
\left( \sum_{k=1}^n a_k^2 \right)
\left( \sum_{k=1}^n b_k^2 \right)
$$

您可以设置 "markdown.math.enabled": false 来禁用此功能。

Markdown 数学公式语法高亮

VS Code 现在还支持在 Markdown 源代码中高亮显示数学公式

Syntax highlighting of a math equation in a Markdown file

这在普通 Markdown 文件和 notebook 中的 Markdown 单元格中均有效。

TypeScript 4.3.5

我们现在捆绑了 TS 4.3.5。此小版本更新修复了一些重要错误，包括JSX 中自动导入无法工作的问题。

调试

记住每个文件选择的环境

当没有 launch.json 文件启动调试时，VS Code 会查看当前活动的编辑器，并根据编辑器的语言模式决定使用哪个调试扩展。但是，对于某些语言，可能有多个调试扩展可用，在这种情况下，VS Code 会提示您选择其中一个。为了使调试更顺畅，VS Code 现在会记住每个文件选择的调试器，以便下次启动调试时，会话无需任何提示即可开始。

在下面的短视频中，用户选择 Node.js 调试环境来调试单个 JavaScript 文件，并且当为该文件启动新的调试会话时，该选择会被记住。

Debug is started first time and the environment prompt is presented. The next time there is no prompt when the debug session starts

调试控制台建议不再通过回车键接受

调试控制台建议不再通过 Enter 键接受，而只能通过 Shift+Enter 和 Tab 键接受。以前，当您只想评估调试控制台输入中已输入的内容时，很容易意外接受建议。

为了使 Tab 键作为接受建议的方式更易于发现，VS Code 现在在调试控制台输入中提供了一个提示状态栏（“插入 (Tab)”）。

Debug console input box showing a Status bar rendered in the bottom that says "Insert (Tab)"

对扩展的贡献

Jupyter 交互式窗口

我们已开始致力于在 notebook 生态系统的基础上提供内置的交互式窗口体验，Jupyter 扩展已在一个设置 jupyter.enableNativeInteractiveWindow 后面采用了它。如果此功能已启用，Jupyter 扩展将在从 Python 文件运行代码或直接从命令面板启动时，打开内置编辑器而不是 webview 实现。内置编辑器与您的自定义键绑定/键映射或语言扩展兼容，因为它与工作台深度集成。

Jupyter built-in interactive window demo

Jupyter notebook 调试

我们一直在努力支持在 Jupyter notebook 中进行调试，以便您可以在 notebook 单元格中设置断点，逐步执行单元格，并使用所有其他 VS Code 调试器功能。这是实验性功能，但您可以通过设置 "jupyter.experimental.debugging": true，在您选择的 kernel 中安装 ipykernel 的版本 6，然后单击 notebook 工具栏中的调试按钮来试用。

Jupyter debugging

远程仓库

在本次迭代中，我们主要专注于修复错误和提升 Remote Repositories 扩展的性能，并改进了与 GitHub Pull Requests and Issues 扩展的集成。此外，您现在可以在远程资源管理器中的远程仓库视图中移除远程仓库，并且更好地支持打开带有行范围的 \blob URL。

GitHub Pull Requests and Issues

本次迭代 GitHub Pull Requests and Issues 扩展的重点是修复错误。查看更新日志了解亮点。

远程开发

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

1.58 版本中的功能亮点包括：

  • 转发端口时仅打开一次浏览器的选项。
  • devcontainer.json 支持缓存镜像。
  • Dev Containers 现在检查 "hostRequirements"。

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

Live Preview

我们开发了一个 Live Preview 扩展，它托管一个本地服务器用于网页开发预览！🎉

它具有编辑器内置浏览器预览、实时预览刷新（文件更改或保存时）、多根目录支持等功能！

Live Preview Quick Walkthrough

该扩展还有一个 Live Preview 任务，它运行一个持久服务器，并允许您查看服务器流量及其关联文件。

Live Preview Tasks

要了解其更多功能，您可以在市场中找到详细信息或查看其仓库。

预览功能

支持 TypeScript 4.4

本版本包含对即将发布的 TypeScript 4.4 版本的初步支持。您可以在TypeScript 博客上阅读更多关于 TypeScript 4.4 中新增语言特性和改进的内容。

要开始使用 TypeScript 4.4 每夜构建版本，请安装 TypeScript Nightly 扩展。

请分享您的反馈，如果您在使用 TypeScript 4.4 时遇到任何错误，请告诉我们。

在窗口之间移动终端

现在可以在窗口之间移动终端，方法是在一个窗口中通过 Terminal: Detach Session（终端：分离会话）分离，然后在另一个窗口中通过 Terminal: Attach to Session（终端：附加到会话）附加。将来，这应该有助于实现跨窗口拖放功能！

扩展创作

详细的补全项标签

我们新增了 API，用于更详细、结构化的补全项标签。您现在可以使用 vscode.CompletionItemLabel 类型来定义项的标签，它允许您指定标签、详细信息和描述。

这些新属性允许语言扩展显示签名或限定符，其他补全提供程序也可以利用这一点。例如，GitHub Pull Request and Issues 扩展现在可以在别名旁边显示全名。

Completion for Github aliases with full names

模态消息的详细信息

用于显示模态信息、警告和错误消息的 API 现在支持提供详细信息。详细信息文本显示在下方，且不如实际消息突出。

A modal dialog with details

上方的对话框是通过以下代码片段生成的。请注意，详细信息文本仅支持模态消息 (modal: true)。

vscode.window.showInformationMessage('This is the message', {
  modal: true,
  detail:
    'This is the detail. Rendered less prominent, but with more space for, well, details.'
});

贡献终端配置文件

终端配置文件现在可以由扩展贡献，并会显示在配置文件选择器中：

A contributed profile will show up along side detected and configured terminal profiles

要贡献终端配置文件，您需要做三件事：

首先，将贡献添加到您的 package.json 中：

"contributes": {
  "terminal": {
    "profiles": [
      {
        "title": "Custom Profile",
        "id": "custom_profile"
      }
    ]
  },
}

接下来，添加激活事件，以便用户请求配置文件时激活扩展：

"activationEvents": [
  "onTerminalProfile:custom_profile"
]

最后，注册终端配置文件提供程序，该提供程序将返回用于创建终端的选项集。选项可以是标准的基于进程的 TerminalOptions 或自定义的 ExtensionTerminalOptions：

vscode.window.registerTerminalProfileProvider('custom_profile', {
  provideTerminalProfile() {
    return {
      options: {
        name: 'Profile from extension',
        shellPath: 'cmd.exe'
      }
    };
  }
});

更改基于 ExtensionTerminalOptions 的终端名称

新的 Pseudoterminal.onDidChangeName 事件允许更改使用 ExtensionTerminalOptions 创建的终端的名称。

const writeEmitter = new vscode.EventEmitter<string>();
const nameEmitter = new vscode.EventEmitter<string>();
const pty = {
  onDidWrite: writeEmitter.event,
  onDidChangeName: nameEmitter.event,
  open: () => writeEmitter.fire('Press and key to set the terminal title'),
  close: () => {
    /* noop*/
  },
  handleInput: (data: string) => {
    writeEmitter.fire(`Set title to "${data}"`);
    nameEmitter.fire(data);
  }
};
const terminal = (<any>vscode.window).createTerminal({ name: `My Extension REPL`, pty });
terminal.show();

设置通过扩展 API 创建的终端图标

window.createTerminal 现在接受 iconPath，从而将图标与终端在选项卡中关联起来。

const term = vscode.window.createTerminal({
  name: `Serve`,
  iconPath: new vscode.ThemeIcon('server-process')
});
term.show();

The iconPath will show up next to the terminal's name

枚举已保存的 Memento 键

有一个新的 Memento.keys() API，用于枚举已保存的 Memento 键集。此 API 可以更轻松地处理以前保存的数据，并在需要迁移保存的数据时有所帮助。

语言服务器协议

新版本的语言服务器协议及其相应的 npm 模块已发布。此版本包含诊断拉取模型规范的最终提案。

调试适配器协议

“内存写入”请求和“内存更改”事件的进展

我们计划在未来版本的 VS Code 调试体验中集成一个内存查看器。为此，调试适配器协议中已经存在 ReadMemory 请求一段时间了。我们现在正在研究相应的 WriteMemory 请求和 Memory 事件。WriteMemory 请求有一个最终提案，将在下一个里程碑添加到 DAP 中。Memory 事件提案仍在讨论中。如果您是调试扩展作者并对这些 DAP 协议新增内容感兴趣，我们非常感谢您的反馈。

建议的扩展 API

每个里程碑都会带来新的建议 API，扩展作者可以试用它们。一如既往，我们希望获得您的反馈。要试用建议的 API，您需要做以下几件事：

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

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

富状态栏悬停

新增了一个建议的 API，用于支持状态栏项的富悬停。要试用它，请在 StatusBarItem.tooltip2 中提供一个 MarkdownString。

Rich Status bar hover

  • 如果 MarkdownString.supportThemeIcons 为 true，您可以使用 $(iconName) 语法使用图标。
  • 如果 MarkdownString 受信任，您还可以添加命令链接。语法：([测试](command:vscode.newWindow))

测试

测试 API 的定稿工作仍在继续。本次迭代，我们重构了一些测试 API，使其更好地与扩展主机中其他 API 的风格匹配。要跟踪定稿过程并了解 API 的更改，请关注议题 #122208。

我们预见的主要变化在于如何提供“运行配置”。要跟踪或参与这些 runner API 的进展，请关注议题 #127096。

最后，我们开始研究和初步实现测试覆盖率，这将在未来几周内在用户界面中有所体现。

行内建议

行内建议 API 允许扩展提供与建议小部件分离的行内建议。行内建议会像已被接受一样渲染，但颜色为灰色。用户可以通过 Tab 键循环切换建议并接受它们。

vscode.languages.registerInlineCompletionItemProvider(
  { pattern: '**' },
  {
    provideInlineCompletionItems: async (document, position) => {
      return [{ text: '< 2) {\n\treturn 1;\n\t}' }];
    }
  }
);

Inline suggestions in the editor

工程

ES2020

我们已更新 TypeScript 项目，允许使用最新的 JavaScript API，例如 Promise.allSettled 或 String.replaceAll。我们还输出更现代的 JavaScript，即 ES2020，这稍微减小了我们主 bundle 的总大小。

Electron 沙盒支持的进展

在本里程碑中，我们继续为启用 Electron 的沙盒和上下文隔离功能做好 VS Code 窗口的准备。

具体来说：

  • 我们移除了加载打开 VS Code 窗口所需资源的 Node.js 依赖。
  • 我们为 iframe 元素增加了搜索功能，使其行为更接近已弃用的 webview 组件，从而使我们能够在未来放弃 webview。此功能可以通过在 settings.json 文件中设置 "webview.experimental.useIframes": true 来启用。

文档

数据科学教程和专题

数据科学教程和专题现在在 https://vscode.js.cn 目录中拥有自己的部分。您可以找到关于使用 Jupyter Notebook、Python 交互式窗口 的教程，甚至还有一个分析泰坦尼克号乘客数据的数据科学教程。

Data Science table of contents on code.visualstudio.com

显著修复

  • 120956：iPad：无法在编辑器外部触发上下文菜单
  • 122448：如果扩展的依赖项被禁用，则自动禁用扩展
  • 124169：尝试不对活动调试行进行缩进
  • 125144：当线程不再停止时，焦点不会自动传递给其他线程
  • 125528：当不再停止在断点上时，在断点视图中取消选择断点
  • 126211：通过调试器启动的 Node 进程在退出 VS Code 时未被杀死
  • 126702：macOS：命令行 code . 不起作用
  • 127716：调试悬停：允许使用键盘搜索属性

致谢

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

对我们的议题跟踪的贡献

对 vscode 的贡献

对 vscode-extension-samples 的贡献

对 vscode-html-languageservice 的贡献

对 vscode-js-debug 的贡献

对 vscode-languageserver-node 的贡献

对 language-server-protocol 的贡献

对 monaco-editor 的贡献

对 monaco-languages 的贡献

对 monaco-typescript 的贡献