🚀 在 VS Code 中！

2020 年 6 月（版本 1.47）

更新 1.47.1：此更新解决了此安全问题。

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

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

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

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

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

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

Insiders： 想尽快试用新功能吗？您可以下载每晚构建的 Insiders 版本，并在最新更新可用时立即试用。有关最新的 Visual Studio Code 新闻、更新和内容，请在 Twitter 上关注我们 @code！

辅助功能

在这个里程碑中，我们再次收到了来自社区的宝贵反馈，这帮助我们识别并解决了许多辅助功能问题。亮点

  • 文件资源管理器中的紧凑型文件夹现在可以正确叙述展开/折叠状态和 ARIA 级别。
  • 屏幕阅读器现在可以更新编辑器中的光标偏移量。因此，屏幕阅读器的“朗读全部”命令在停止和恢复时应该效果更好。
  • 相同的 ARIA 实时消息现在将被屏幕阅读器正确地重新读取。

工作台

从设置编辑器编辑对象设置

以前，设置编辑器只能用于编辑原始类型（如字符串和布尔值）的设置，对于更复杂的设置类型，您需要直接编辑 settings.json。现在，您可以从设置编辑器编辑非嵌套对象设置。扩展作者可以使用此功能来提高这些类型设置的可见性。

之前

在设置编辑器中

Object setting in the old Settings editor

在 settings.json 中

Object setting in the JSON editor

之后

在设置编辑器中

Object setting in the new Settings editor

在列表视图中选择并保持焦点

有一个新的命令 list.selectAndPreserveFocus，它允许您从列表中选择一个项目，同时保持焦点在该列表中。如果您想从列表中选择多个文件（例如文件资源管理器），而不想让焦点转移到文件编辑器，这将很有帮助。

该命令默认未绑定到任何键盘快捷键，但您可以添加自己的按键绑定

{
  "key": "ctrl+o",
  "command": "list.selectAndPreserveFocus"
}

Windows ARM 稳定版本

适用于 Windows on ARM 的 VS Code 现在稳定版可用了！🎉

通过拖放安装 VSIX

VS Code 现在支持通过将扩展 VSIX 文件拖放到扩展视图上来安装扩展。

新的搜索编辑器命令参数

在搜索编辑器命令（search.action.openNewEditor，search.action.openNewEditorToSide）中添加了两个新参数，以允许按键绑定配置新搜索编辑器的行为方式

  • triggerSearch - 是否在打开搜索编辑器时自动运行搜索。默认为 true。
  • focusResults - 是将焦点放在搜索结果中还是查询输入中。默认为 true。

例如，以下按键绑定在打开搜索编辑器时运行搜索，但将焦点留在搜索查询控件中。

{
  "key": "ctrl+o",
  "command": "search.action.openNewEditor",
  "args": { "query": "VS Code", "triggerSearch": true, "focusResults": false }
}

新的搜索编辑器上下文默认值

search.searchEditor.defaultNumberOfContextLines 设置已更新为默认值为 1 而不是 0，这意味着在搜索编辑器中的每个结果行之前和之后将显示一个上下文行。要恢复到旧的行为，请将值设置回 0。

列表/树：动态水平滚动

以前存在的 workbench.list.horizontalScrolling 设置现在可以在运行时切换，而无需强制您重新加载工作台。

编辑器

正则表达式替换中的大小写更改

VS Code 现在支持在编辑器中进行查找/替换时更改正则表达式匹配组的大小写。这通过修饰符 \u\U\l\L 完成，其中 \u 和 \l 将分别将单个字符转换为大写/小写，而 \U 和 \L 将分别将匹配组的其余部分转换为大写/小写。

示例

Changing case while doing find and replace

修饰符也可以堆叠 - 例如，\u\u\u$1 将把组的前三个字符转换为大写，或者 \l\U$1 将把第一个字符转换为小写，其余部分转换为大写。

目前，这些仅在编辑器的“查找”控件中受支持，而不在全局在文件中查找中受支持。

调试

新的 JavaScript 调试器

我们的新 JavaScript 调试器在上个月成为 Insiders 上的默认调试器之后，现在已成为 VS Code 中 JavaScript（Node.js 和 Chrome）的默认调试器。如果您跳过了过去几个 VS Code 更改日志的“预览功能”部分，您可以查看调试器 README 的新增功能部分。

您应该不需要更改任何设置或启动配置即可利用新的调试器。如果您遇到任何问题，请打开一个 issue！

单文件调试

直到今天，VS Code 调试器还没有标准方法来显示编辑器中的文件可以通过单击按钮轻松调试。一些调试扩展允许您这样做，通常使用调试配置，提示您“调试编辑器中的文件”。但是，用户仍然必须在调试配置下拉菜单中选择正确的配置，然后才能使用 F5。其他调试扩展为 F5 实现了回退策略：如果不存在 launch.json，F5 将尝试调试当前在活动编辑器中打开的文件。

由于这两种方法都不容易被发现，因此一些调试扩展（例如 Python）已开始在编辑器的标题区域添加运行按钮。

由于我们没有找到更好的方法，并且此方法可以在不需要任何新 API 的情况下实现，因此我们编写了一些关于如何在标准方式中实现它的指南。扩展作者可以在下面的“扩展创作”部分中找到这些指南。

用户只需要记住这些图标

Run and debug action in editor title

如果其中一个或两个都出现在编辑器标题区域的左侧，则只需单击一下即可运行或调试编辑器中的文件。

更简洁的调用堆栈视图

我们已开始使调用堆栈在常见情况下不那么拥挤：调用堆栈视图现在支持隐藏出于技术原因而存在的调试会话节点，但这些节点对用户没有太大价值。

第一个选择加入此功能的调试扩展是新的 JavaScript 调试器，只要只有一个子会话，它就可以消除父调试会话。

Screenshot of two "Call Stack" views. Without compaction, there is an extra child session between the parent session and each attached worker processes.

我们希望其他调试扩展也会效仿。请参阅下面新的建议 API。

跳转到光标的新命令别名 设置下一条语句

为了使来自 Visual Studio 的用户更容易发现 跳转到光标 命令，我们添加了命令别名 设置下一条语句。

如果您不知道 跳转到光标 的作用：它允许您将程序执行移动到新位置，而无需执行任何中间的源代码。

断点路径悬停

当鼠标悬停在断点视图中的源代码断点上时，VS Code 现在会显示断点的绝对路径。

任务

pnpm 包管理器支持

pnpm 现在是 npm.packageManager 设置的有效选择，以及 npm 和 yarn，用于运行您的脚本。

源代码管理

单视图

源代码管理视图已整合为单个视图

Source Control with a single view

所有存储库都呈现在单个视图中，因此您可以更好地了解整个工作区状态。此外，源代码管理视图现在可以移动到面板，其他视图可以移动到源代码管理视图容器。

查看和排序

我们添加了对源代码管理视图中更改进行排序的支持，在使用列表视图选项时，可以按名称、路径（默认）和状态排序。我们将视图选项（列表与树）和排序选项整合到上下文菜单中的新 查看和排序 菜单项中。

View & Sort in Source Control

Git：恢复暂存消息

与通常的 git merge 命令类似，如果用户正在执行 git merge --squash 命令，SCM 视图现在将使用默认消息恢复 SCM 输入。

语言

TypeScript 3.9.6

VS Code 现在捆绑了 TypeScript 3.9.6。这个小更新修复了一些错误，包括一个可能导致 TypeScript 服务器在某些源代码模式下崩溃的错误。

浏览器支持

大文件上传支持

您现在可以将大文件和文件夹上传到 VS Code 的 Web 版本，并且将准确报告进度，以便您可以跟踪已上传的字节数以及上传速度。

Web upload indicator in bottom Status bar

迈向文本文件编码支持

在这个里程碑中，我们为浏览器中对文本编码的完全支持投入了大量工作，以便读取和写入文件。我们依赖于两个现在在浏览器中通过利用 webpack 支持的库

这项工作将在 7 月继续进行，并应很快普遍可用。

预览功能

预览功能尚未准备好发布，但功能已足够使用。我们欢迎您在它们开发过程中提供早期反馈。

设置同步

在过去的几个月中，我们一直在努力支持跨机器同步 VS Code 首选项，此功能在 Insiders 版本上可用于预览。

您现在可以使用 已同步的机器 视图中机器条目上的 关闭首选项同步 上下文菜单操作来禁用其他机器上的同步。

Turn off preferences sync for a machine

我们还改进了打开同步时的进度信息。

TypeScript 4.0 支持

在此迭代中，我们继续改进对 TypeScript 4.0 的支持。一些亮点包括

  • 在编辑器中使用删除线突出显示对已弃用符号的调用

    Call to a deprecated function rendered in the editor

  • 解释为什么无法应用给定重构的原因

    Displaying the reason a refactoring cannot be applied

  • 改进的自动导入 - 在 TypeScript 4.0 博客文章中阅读更多内容。

您可以通过安装 TypeScript nightly 扩展立即试用这些功能。

在加载大型 JavaScript 或 TypeScript 项目时提供部分 IntelliSense 支持

TypeScript 4.0 beta 还带来了一个新功能，该功能应有助于减少您在加载大型 JavaScript 或 TypeScript 项目时等待的时间。为了解释其工作原理，我们首先需要介绍一些关于当前版本的 TypeScript 如何工作的背景知识。

当您在 VS Code 中打开 JavaScript 或 TypeScript 文件时，TypeScript 语言服务会确定该文件所属的项目，然后为其加载关联的项目。有时这个项目可能非常大，例如核心 VS Code 代码库，它由数千个 TypeScript 文件组成。在加载项目时，VS Code 能够处理基本语法操作，例如获取文档大纲和启用代码折叠，但它目前无法提供 IntelliSense 或其他更高级的语言功能，因为这些功能依赖于理解整个项目。例如，为了提供自动导入，TypeScript 语言服务需要知道项目中的所有导出符号。

TypeScript 4.0 中的更改使 VS Code 可以在大型项目仍在加载时提供 IntelliSense 和其他更高级的语言功能。需要注意的是，我们可以提供的 IntelliSense 仅限于查阅当前文件，而不是整个项目。这意味着诸如建议和 转到定义 之类的功能将起作用，但是我们只会显示来自当前文件的建议，并且您只能运行 转到定义 以跳转到当前文件中的另一个符号。

如果您使用大型 JavaScript 和 TypeScript 项目，我们有兴趣听取您对这项新功能的反馈。您可以使用 TypeScript nightly 扩展立即试用它。我们希望它可以让您几乎立即开始使用您的代码，直到更完整的项目范围 IntelliSense 可用。

代码操作的撤消/重做

我们正在努力实现能够撤消和重做代码操作和重构。一个突出的例子是 Java 类重命名重构，它会进行文本更改以及重命名磁盘上的文件。现在可以撤消此操作，但仍需要触发两次撤消。请继续关注我们进一步改进此功能，并请提供早期反馈。

扩展贡献

Notebooks

VS Code 团队正在继续进行对 Notebooks 的原生支持。为了帮助开发，我们创建了一个 GitHub Issue Notebooks 扩展，它允许您搜索 GitHub issue 和 pull request。此扩展仍处于预览阶段，需要使用 VS Code Insiders，但它可以让您亲身体验 Notebooks，我们欢迎您的反馈。

更新的用户体验

我们更新了 Notebook 单元格的视觉外观，使其设计更紧凑。我们还为选定的单元格添加了阴影轮廓，以使选择状态更加明显。

Updated Notebook UX

Notebook 热退出支持

我们在 Notebooks 中添加了热退出支持，以允许扩展处理备份和恢复。您的未保存本地更改现在可以由扩展序列化，并在重新打开工作区时恢复。

撤消/重做增强

我们添加了对扩展程序贡献撤消/重做堆栈的支持。扩展程序现在可以控制哪些操作是可撤消的。例如，在 GitHub Issue Notebook 中，您可以选择 锁定 按钮使单元格内容只读，也可以通过正常的撤消/重做命令来撤消/重做此操作。

Undo/Redo in GitHub Issue Notebook

主题：GitHub 主题

创建未命名 Notebook

我们扩展了 新建文件 命令 (⌘N (Windows, Linux Ctrl+N)) 以支持创建新的未命名 Notebook 文件。例如，您可以使用下面的按键绑定快速创建 GitHub Issue Notebook 并运行查询。

{
  "key": "cmd+i",
  "command": "workbench.action.files.newUntitledFile",
  "args": { "viewType": "github-issues" }
}

Create Untitled GitHub Issue Notebook

主题：GitHub 主题

Notebook 颜色标记

我们还为 Notebooks 添加了以下颜色标记

  • notebook.cellBorderColor：Notebook 单元格的边框颜色
  • notebook.cellHoverBackground：单元格悬停时的背景颜色
  • notebook.cellInsertionIndicator：Notebook 单元格插入指示器的颜色
  • notebook.focusedCellBackground：单元格聚焦时的背景颜色
  • notebook.focusedCellBorder：单元格聚焦时单元格顶部和底部边框的颜色
  • notebook.focusedCellShadow：单元格聚焦时单元格阴影的颜色
  • notebook.focusedEditorBorder：Notebook 单元格编辑器边框的颜色

两个新示例展示了如何在 Notebooks 中支持调试

Notebook 扩展指南

如果您有兴趣为 VS Code 创建 Notebook 扩展，则有一个新的指南详细介绍了 Notebook API。您将了解 API 以及 VS Code Notebook 基础结构和 Notebook 扩展开发最佳实践的详细信息。

远程开发

在 远程开发扩展 上继续进行工作，这些扩展允许您使用容器、远程计算机或 Windows Subsystem for Linux (WSL) 作为功能齐全的开发环境。

1.47 中的功能亮点包括

  • Remote - SSH：远程服务器可以监听套接字而不是端口。
  • 开发容器：提示在卷中打开存储库。
  • 开发容器和 WSL：查看最近的 在 WSL 2 中使用开发容器 博客文章。

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

如果您是 VS Code 远程开发的新手，您可以从这些入门教程开始

Azure 帐户

最新版本的 Azure 帐户扩展现在公开了一个凭据对象，该对象可以与最新的 Azure SDK 一起使用。

GitHub Pull Requests and Issues

在 GitHub Pull Requests and Issues 扩展上继续进行工作，该扩展允许您处理、创建和管理 pull request 和 issue。此版本的一些更新包括

  • Issues 视图中的 Markdown 悬停。
  • 新 issue 编辑器中的标签建议。
  • 对格式为 GH-123 的 issue 的悬停支持。

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

Hex Editor

HexEditor 扩展仍在不断改进，以在 VS Code 中提供原生的十六进制编辑体验。此版本对扩展的主要更新包括简单的编辑支持（允许用户撤消、重做、编辑现有的十六进制单元格以及向文档末尾添加新单元格）和大文件优化，允许用户打开超过 18 兆字节的文件，这在以前是不可能的。

Editing in the HexEditor extension

可在 更改日志 中找到值得注意的更改的完整列表。任何反馈或遇到的问题都可以针对 vscode-hexeditor 存储库提交。

扩展创作

AccessibilityInformation

我们最终确定了 TreeItem、StatusBarItem 和 TimelineItem 元素中的 AccessibilityInformation，以支持屏幕阅读器。AccessibilityInformation 包含 label 和 role。一旦项目获得焦点，屏幕阅读器就会读出 label。项目的 role 定义了屏幕阅读器与其交互的方式。role 应在特殊情况下设置，例如，当类似树的元素表现得像复选框时。如果未指定 role，VS Code 将自动选择适当的 role。

“转到位置”的后备消息

当找不到任何位置时，editor.action.goToLocations 命令现在可以显示后备消息。这允许扩展程序实现诸如 转到超类型 之类的功能，这些功能的行为与内置功能（例如 转到定义）完全相同。下面的代码片段是一个完整的示例，说明了扩展程序如何调用此命令

vscode.commands.executeCommand(
  'editor.action.goToLocations',
  vscode.window.activeTextEditor.document.uri, //anchor uri and position
  vscode.window.activeTextEditor.selection.start,
  [], // results (vscode.Location[])
  'goto', // mode
  'No Super Types Found' // <- message
);

改进单文件调试体验的指南

对于希望通过在编辑器中添加“运行”和/或“调试”按钮来改进单文件调试体验的调试扩展，我们建议遵循以下指南以获得一致的外观和感觉

  • 在 package.json 中贡献运行和/或调试命令（请参阅 Mock Debug）
    • 使用命令标题“运行文件”/“调试文件”或“运行 Python 文件”/“调试 Python 文件”。
    • 对“运行”使用 $(play) 图标，对“调试”使用 $(debug-alt-small) 图标。
  • 将命令添加到编辑器标题区域（请参阅 Mock Debug）
    • 要使命令仅对特定语言可见，请使用“when”子句，例如 "resourceLangId == python"。
    • 将“运行”命令放在 1_run@10 组中，将“调试”命令放在 1_run@20 组中。

CodeActionProviderMetadata.documentation

CodeActionProviderMetadata 上的新 documentation 属性允许扩展程序为其返回的代码操作提供静态文档。当提供程序返回代码操作时，此文档会显示在代码操作列表的底部

A documentation entry in the Code Actions menu

当用户选择文档条目时，将执行命令。此命令可以在编辑器中显示文档或在浏览器中打开文档。

打开和保存对话框标题

用于通过 OpenDialogOptions 和 SaveDialogOptions 为打开和保存文件对话框提供 title 的 API 已最终确定。请注意，并非所有操作系统都允许设置此标题，因此行为可能会因扩展程序的运行位置而异。

新的扩展类别

您现在可以使用以下新添加的类别来对您的扩展进行分类。

  • 数据科学
  • 机器学习
  • 可视化
  • 测试
  • Notebooks

辅助按钮样式

我们引入了一种辅助按钮样式，用于在需要使按钮不那么突出时使用

  • button.secondaryForeground
  • button.secondaryBackground
  • button.secondaryHoverBackground

GitHub Workflow 徽章

您现在可以将 GitHub Workflow 徽章 添加到已发布扩展的徽章列表中，因为 github.com 已添加到批准的徽章来源列表中。

GitHub Workflow badge

通过 argv.json 启用建议的 API

argv.json 中现在支持字段 enable-proposed-api。这允许扩展作者在已发布的版本中运行其建议的 API 扩展以进行长期试用，而无需通过命令行打开 VS Code 并传递 --enable-proposed-api CLI 标志。

新的 codicon 图标

我们在 codicon 库中添加了以下新图标

  • debug-alt-small
  • vm-connect

Codicons icons

语言服务器协议

对 语义标记 和 完成项中附加文本编辑的延迟解析的支持已添加到即将发布的 3.16 规范中。

建议的扩展 API

每个里程碑都带有新的建议 API，扩展作者可以试用它们。与往常一样，我们需要您的反馈。这是您试用建议的 API 必须执行的操作

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

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

终端链接提供程序

基于 上一个版本中添加的终端新链接系统，这个新的建议 window.registerLinkProvider 允许扩展将链接附加到终端，包括悬停时显示的工具提示标签。

Terminal Link Provider

这与之前建议的（现在已弃用的）“链接处理程序”API 形成对比，该 API 允许您的扩展程序可能处理有问题的链接，如果它不处理，则会有一个回退链。这种链接肯定会被处理的新模型更符合我们心中的愿景，即链接可能有一系列可能的操作。

用于无调试运行的新 API

VS Code 的“无调试运行”功能是调试的一种变体，其中重用现有的调试配置来运行程序而不是调试程序。这种运行模式的一个结果是程序不会中断到调试器中，既不会因为命中断点，也不会因为任何其他原因。

在这个里程碑中，我们为“无调试运行”提供了官方扩展 API：在 debug.startDebugging 函数的 DebugSessionOptions 中添加了一个新的属性 noDebug。noDebug 控制即将启动的会话应该在调试还是不调试的情况下运行。当缺少 noDebug 属性时，将使用父会话（如果存在）中的值。如果不存在父会话，则对于缺少的 noDebug 属性，假定值为“false”。

请注意：以前可以在启动配置中添加 noDebug 标志以达到相同的效果。此非官方 API 现在已弃用（但仍受支持），我们建议扩展程序过渡到新的 API。

用于减少调用堆栈视图中混乱的新 API

随着复杂的调试扩展和调试设置的出现，CALL STACK 树视图中显示的调试会话越来越多，导致视图看起来很拥挤。在大多数情况下，调试会话对用户很有用，他们需要完全控制这些会话。在其他情况下，一些调试会话只是实现工件，或者是一组子会话的分组机制。

为了在常见情况下使 CALL STACK 视图不那么拥挤，我们引入了一个功能，如果父调试会话节点只有一个子会话，则隐藏该节点。此功能称为“紧凑模式”，可通过 debug.startDebugging 函数的 DebugSessionOptions 上的一个新的可选属性 compact 来使用。

如果 compact 为 true，则新创建的调试会话的父节点将在 CALL STACK 视图中隐藏，只要它只有一个子节点。如果 compact 为 false 或缺失，父节点将保持可见（这是当前的行为）。

树视图中的 Markdown 悬停提示

有一个新的提议 API，允许 TreeItem 的 tooltip 属性为一个 MarkdownString。除了允许 Markdown 作为工具提示之外，TreeDataProvider 上还有一个新的 resolveTreeItem。resolveTreeItem 背后的想法是，可能需要更长时间计算的属性（目前只有 tooltip）可以稍后解析，而不是预先为每个树项计算。您可以在GitHub Pull Requests and Issues 扩展中看到 resolveTreeItem 和 Markdown tooltip 的使用。

工程

使用 TypeScript 4.0 构建 VS Code

VS Code 现在使用 TypeScript 4.0 的每夜构建版本构建。

这个新的 TypeScript 版本帮助我们捕获了一些关于访问器的潜在错误，并且还帮助我们测试即将发布的 TypeScript 版本。

文档和扩展

C++ 的 CMake 工具

关于使用 CMake 和 CMake Tools 扩展开发 C++ 应用程序的新教程。

CMake Tools extension

macOS 的 Java Pack 安装程序

Visual Studio Code for Java Pack 安装程序下载在 macOS 上的 Visual Studio Code 中进行 Java 开发所需的依赖项和扩展。

Java Pack installer for macOS

值得注意的修复

  • 71291: 水平滚动条破坏树视图中的渲染
  • 93230: 局部变量以令人讨厌的方式折叠
  • 98309: 在工作副本文件服务中支持多个文件
  • 99061: 允许重新打开已关闭的差异编辑器
  • 99290: Git：在重新加载时恢复差异编辑器
  • 99704: 顶部调试会话行在未暂停时显示“已暂停”
  • 99786: 当调试工具栏位置停靠时，无法启动额外的会话
  • 100524: SCM 装饰器丢失
  • 101132: 离线尝试打开发行说明后，发行说明永远无法打开

感谢

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

对我们的问题跟踪的贡献

对 vscode 的贡献

对 vscode-extension-samples 的贡献

对 vscode-eslint 的贡献

对 debug-adapter-protocol 的贡献

对 language-server-protocol 的贡献

对 vscode-languageserver-node 的贡献

对 vscode-css-languageservice 的贡献

对 node-jsonc-parser 的贡献

对 vscode-generator-code 的贡献

对 vscode-vsce 的贡献