🚀 在 VS Code 中！

2019 年 9 月（版本 1.39）

更新 1.39.1：此更新解决了这些 问题，包括修复了一个安全漏洞。

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

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

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

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

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

工作台

更新的源代码管理视图

源代码管理视图已更新为使用最新的树形控件。您现在可以使用源代码管理标题栏上的切换视图模式按钮在列表视图和树视图之间切换。

Source Control toggle view mode button

您可以使用 scm.defaultViewMode 设置更改默认视图，该设置接受 list 或 tree 值。

您还可以通过简单地在视图中开始键入，从更新的树形控件的自动键盘导航和筛选中获益。

Updated SCM view

在树视图模式下（显示文件夹），Git 扩展现在为文件夹贡献命令，例如暂存更改，这将应用于文件夹中的所有文件。

改进的受信任域设置

我们简化了 传出链接保护 功能（在 1.38 版本中引入）的受信任域管理。

您现在可以使用命令管理受信任域，以 JSON 文本文件的形式轻松添加、删除或修改受信任域。

Improved trusted domains management

可选择的完成详细信息

现在可以选择自动完成详细信息以进行复制和粘贴。

Selectable completion details

更新了 Windows 上的日语 UI 字体

在 Windows 上，我们将日语 UI 字体从 Meiryo 切换为 Yu Gothic UI 和 Meiryo UI。

UI 字体通过使用更窄的日语假名字符来节省水平空间。您可以通过安装 日语语言包 并使用配置显示语言命令将显示语言标识符设置为 ja 来使用日语 UI。

在下图中，您可以看到更窄的 UI 字体在预览体验版本（绿色图标）菜单栏中的外观。

Japanese typeface

改进了建议和悬停提示中等宽字体的显示

以前，建议和小部件悬停提示中的内联 <code> 段未指定 font-family。在 Windows/macOS 上，这些段使用 Chrome 为 font-family: monospace 选择的默认字体呈现。

在此迭代中，我们将它们与在整个 VS Code UI 中使用的系统无衬线字体对齐。

  • Windows：Courier New -> Consolas（与 Segoe UI 对齐）
  • macOS：Courier -> SF Mono、Monaco、Menlo（与 SF Text 和 Helvetica Neue 对齐）
  • Linux：无更改。内联代码段仍以 Liberation Mono 呈现，这是 Chrome 在 Linux 上为 font-family: monospace 选择的默认字体。

在下面您可以看到 SF Mono 为内联代码块提供了更一致的外观。

Suggest and Hover widgets monospace typeface

设置编辑器中 uniqueItems 的验证

字符串数组设置的验证（在 1.38 版本中引入）现在支持 uniqueItems。

如果使用 "uniqueItems": true，设置编辑器中的重复条目将显示警告。

扩展 README 中的代码块高亮显示

扩展 README 中的代码块（显示在“扩展”视图的“详细信息”窗格中）现在在 VS Code 中突出显示

A block of JSON being highlighted

高亮显示使用当前的颜色主题。

编辑器

切换折叠

您现在可以使用切换折叠（⌘K ⌘L（Windows、Linux Ctrl+K Ctrl+L））命令展开和折叠折叠区域。

迷你地图编辑器选择装饰

编辑器选择现在在迷你地图中突出显示

Minimap displays the editor selection

您可以通过修改 minimap.selectionHighlight 主题颜色来更改这些装饰的颜色。

迷你地图的触摸事件

现在可以使用触摸拖动迷你地图滑块。

多光标粘贴的新选项

过去，当从剪贴板粘贴多行文本时，VS Code 会检查剪贴板文本行数是否与光标数匹配，如果匹配，它会将每行“分发”或“展开”到光标。您现在可以使用 editor.multiCursorPaste 设置控制此行为，该设置可以具有以下值

  • spread - 每个光标粘贴一行文本（默认）。
  • full - 每个光标粘贴完整的剪贴板文本。

集成终端

使用自定义工作目录打开新终端

有一个新命令允许创建具有自定义当前工作目录 (cwd) 的终端

{
  "key": "cmd+shift+h",
  "command": "workbench.action.terminal.newWithCwd",
  "args": {
    "cwd": "${fileDirname}"
  }
}

您可以创建自己的键盘快捷键，以便在任意数量的方便工作目录中打开新终端。cwd 值可以是普通路径，也可以是变量。

更好的区域设置检测

terminal.integrated.setLocaleVariables 设置已被新的 terminal.integrated.detectLocale 设置取代。默认值为 auto，它会将终端会话中的 $LANG 变量设置为检测到的语言 UTF-8 值，但仅当用户未显式配置该变量时才会这样做。这种更好的默认值应减少与终端中的语言和编码相关的问题。

语言

HTML ARIA 属性参考

HTML ARIA 属性的自动完成和悬停信息现在包括对相应 WAI-ARIA 文档的引用。

HTML ARIA reference

CSS 属性完成带分号

CSS 属性完成现在会在行尾插入分号。

您可以将此功能与 Ctrl+Enter (Windows/Linux) 或 Cmd+Enter (macOS) 结合使用，以创建新行，而无需将结尾的 ; 推送到新行。

您可以使用 [css|scss|less].completion.completePropertyWithSemicolon 设置控制此功能。

CSS property completion semicolon

CSS 颜色变量预览

在完成 CSS 变量时，如果原始变量是颜色字符串，VS Code 现在会显示带有其颜色的完成项

CSS variable completion with color swatch

markdown.links.openLocation

新的 markdown.links.openLocation 设置控制 Markdown 文件中的链接在何处打开。

markdown.links.openLocation 有两个值

  • currentGroup - 在当前编辑器组中打开链接（默认）。
  • beside - 在当前 Markdown 编辑器的侧面打开链接。

当处理文档时，"markdown.links.openLocation": "beside" 可能很有用。

调试

改进的列断点 UI

在调试时，VS Code 现在以内联方式显示所有断点候选位置。这使得用户更容易在更准确的位置放置断点。为了不使 UI 杂乱，仅当一行上有多个可能的位置时，才会显示候选断点。

您可以直接与内联断点交互；单击以启用和禁用它们，并调用它们的上下文菜单以执行更多操作。

Inline breakpoints

请注意，此功能需要底层运行时或调试器的支持，我们预计将来只有少数调试扩展会使用此功能。对于此版本，Node Debug 和 Debugger for Chrome 支持此功能。作为扩展作者的示例，我们的 Mock Debug 示例“模拟”对此功能的支持。

调用堆栈视图中的内联调试操作

当调用堆栈视图中显示会话或线程时，我们现在会在悬停时内联显示调试操作。这将使在调试多个会话或线程时更容易控制调试流程。您不再需要先将焦点设置在会话或线程上才能对其执行操作。

如果会话只有一个线程，则所有操作都显示在会话上，因为不显示线程。否则，所有操作都显示在其上下文中（会话操作在会话上，线程操作在线程上）。

Inline debug actions from the Call Stack view

改进的调用堆栈视图行为

我们改进了调用堆栈视图的功能

  • 单击调试会话或线程不再展开它们。您必须直接单击 chevron (>) UI 元素。这可以防止在您只想移动焦点时意外展开会话或线程。
  • 如果新的调试会话未中断，VS Code 不再自动聚焦新的调试会话。

改进了调试控制台中的链接检测

VS Code 现在不仅在字符串输出中，还在调试控制台中的表达式中检测链接。链接检测算法也得到了改进。

PreLaunchTask 现在可以引用默认生成

随着新变量 ${defaultBuildTask} 的引入，现在可以拥有一个通用的 preLaunchTask，它始终引用默认生成任务

{
  "name": "Hello World",
  "type": "node",
  "request": "launch",
  "preLaunchTask": "${defaultBuildTask}"
}

当执行命令任务：运行生成任务时，${defaultBuildTask} 解析为运行的任务的名称。与使用运行生成任务命令类似，如果存在多个默认生成任务，或者没有默认生成任务，则会显示快速选择以选择生成任务。

preLaunchTask 错误时保存选择

现在，当 preLaunchTask 出现错误时，您可以使用在用户设置中记住我的选择复选框记住您的选择。您的选择存储在用户设置中，使用 debug.onTaskErrors，它可以具有三个值；prompt（默认）、debugAnyway 和 showErrors。

PreLaunchTask error choice dialog

扩展贡献

远程开发（预览）

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

1.39 中的功能亮点包括

  • 远程资源管理器现在支持 WSL 扩展，并允许您轻松连接到已安装的 Linux 发行版。
  • 新的 在容器卷中克隆存储库 命令，以便您可以在隔离的环境中处理源代码存储库。
  • 对 SSH 连接共享和使用 SSH 连接到 Windows 远程计算机的实验性支持。

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

您还可以阅读两篇最近的博客文章，描述了

预览功能

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

TypeScript 3.7-beta 支持

尽管 VS Code 在正式发布之前不会捆绑 TypeScript 3.7，但我们已经致力于支持所有 令人兴奋的新的 TypeScript 3.7-beta 功能。

这些包括

  • JavaScript 和 TypeScript 文件中可选链和空值合并的语法高亮显示。
  • 可选链的完成支持。
  • 通过新的 javascript.format.semicolons 和 typescript.format.semicolons 设置控制分号。

您可以通过安装 TypeScript Nightly 扩展 立即试用所有这些新的 TypeScript 3.7 功能。请分享反馈，并告知我们您是否遇到 TypeScript 3.7 beta 的任何错误！

扩展创作

扩展终端 API

扩展终端 API 已最终确定，允许扩展对终端输入做出反应并完全控制其输出。以下代码创建一个扩展终端并在启动时以红色打印“Hello world”

const writeEmitter = new vscode.EventEmitter<string>();
const pty: vscode.Pseudoterminal = {
  onDidWrite: writeEmitter.event,
  open: () => writeEmitter.fire('\x1b[31mHello world\x1b[0m'),
  close: () => {}
};
vscode.window.createTerminal({ name: 'My terminal', pty });

有关更多详细信息，请参阅 API 参考 和 extension-terminal-sample。

符号和完成项的弃用标记

允许将完成项和符号标记为已弃用的符号标记 API 已最终确定。在 1.38 发行说明 中了解更多信息。

在这里您可以看到 Java 扩展 正在使用 SymbolTag.Deprecated 来显示引用已弃用类型或成员的源代码，并带有删除线。

Java deprecated method

调试会话名称不再是只读的

可以更改 DebugSession 的名称。调试会话的名称最初取自 DebugConfiguration。任何更改都将正确反映在 UI 中。

如果 webview 未对本地资源使用 Webview.asWebviewUri，则发出警告

在开发使用 Webview API 的扩展时，当您创建使用 vscode-resource: URI 直接加载本地资源而不是使用新的 Webview.asWebviewUri API 的 webview 时，我们现在会记录警告。

Debug warning for a webview that uses vscode-resources

尽管旧的 vscode-resource: URI 将继续工作，但我们希望所有 webview 扩展都迁移到 Webview.asWebviewUri API，因为新的 API

  • 处理了从网络驱动器加载本地资源的一些棘手的边缘情况。
  • 使拥有可以加载本地和远程内容的 webview 成为可能。
  • 对于 VS Code 的 Web 版本，将更可靠地工作。

TreeView 消息 API

用于在树视图中设置消息的 API 已最终确定。您可以在 树视图扩展示例 中看到如何使用消息 API 的示例。

更新的 Octicons 样式

我们更新了 Octicons 以匹配我们的 新图标轮廓样式，以便我们所有的图标都保持一致。

Updated Octicons

SCM 文件夹菜单

更新的 SCM 视图现在支持将更改呈现为树。作为 SCM 提供程序，您可以使用 scm/resourceFolder/context 菜单 ID 为文件夹的菜单贡献命令。

语言服务器协议

3.15.0 版本的 语言服务器协议 的规范已发布。该版本尚未最终确定，因此仍然欢迎以问题或拉取请求的形式在 语言服务器协议存储库 中提供反馈。流式处理和进度报告支持已添加到语言服务器协议的下一个版本中。节点服务器和 VS Code 客户端的实现分别以 [email protected] 和 [email protected] 的形式提供。

调试适配器协议

取消支持

一个新的 cancel 请求已添加到调试适配器协议中，该请求可以提示调试适配器前端客户端不再对先前发出的特定请求生成的结果感兴趣。

此请求具有提示特征：只能期望调试适配器尽最大努力来遵守此请求，但不能保证。只有在定义了功能 supportsCancelRequest 并且值为 true 时，前端客户端才可以调用此请求。

已取消的请求仍需要发回响应。这可以是正常结果或错误响应。从已取消的请求返回部分结果是可能的，但请注意，前端客户端没有用于检测响应是否是部分的通用方法。

在 9 月的发行版中，VS Code 支持取消 stacktrace、scopes 和 variables 请求（在调用堆栈和变量视图中使用）以及 completions 请求（在调试控制台中使用）。

请注意，截至 9 月，只有 Mock Debug 扩展实现了取消。

在源范围中查找可能的断点

DAP 客户端可以使用新的 breakpointLocations 请求来查找给定源范围内的所有可能的断点位置。这可以在 UI 中使用，以提高“内联”（“列”）断点的可发现性。

只有在定义了 supportsBreakpointLocationsRequest 功能并且值为 true 时，客户端才可以调用 breakpointLocations 请求。

提议的扩展 API

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

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

请注意，您不能发布使用提议 API 的扩展。我们可能会在下一个版本中进行重大更改，我们永远不想破坏现有扩展。

vscode.env.uiKind

添加了一个新的提议 API vscode.env.uiKind，允许扩展程序确定扩展程序是从哪种 UI 使用的。为了准备支持在浏览器中运行 VS Code，可能的值为 UIKind.Desktop 和 UIKind.Web。

vscode.env.asExternalUri

提议的 vscode.env.asExternalUri API 允许扩展程序从扩展程序运行的位置解析外部 URI（例如 http: 或 https: URI）到客户端计算机上相同资源的 URI。这是 vscode.env.openExternal API 的补充，除了不使用外部程序打开解析的 URI 外，它还会将结果返回给扩展程序。

import * as vscode from 'vscode';
import * as http from 'http';

const PORT = 3000;

export function activate(context: vscode.ExtensionContext) {
  startLocalServer(PORT);

  context.subscriptions.push(
    vscode.commands.registerCommand('example.command', async () => {
      const resolved = vscode.env.asExternalUri(
        vscode.Uri.parse(`https://127.0.0.1:${PORT}`)
      );
      vscode.window.showInformationMessage(
        `Resolved to: ${resolved} on client and copied to clipboard`
      );
      vscode.env.clipboard.writeText(resolved.toString());
    })
  );
}

function startLocalServer(port: number) {
  const server = http.createServer((req, res) => {
    res.end('Hello world!');
  });
  server.on('clientError', (err, socket) => {
    socket.end('HTTP/1.1 400 Bad Request\r\n\r\n');
  });
  server.listen(port);
  vscode.window.showInformationMessage(`Started local server on port: ${port}`);
}

vscode.env.asExternalUri 目前仅支持 http: 和 https: URI。如果扩展程序在客户端计算机上运行，则它是空操作。但是，如果扩展程序远程运行，vscode.env.asExternalUri 会自动建立从本地计算机到远程计算机上 target 的端口转发隧道，并返回隧道的本地 URI。

资源的只读 webview 编辑器

您可以找到用于预览从着色器到 Excel 文件到 3D 模型的所有内容的 VS Code 扩展。一些大胆的扩展甚至为可视化编辑二进制或 XML 文件构建了复杂的编辑器样式体验。虽然使用 VS Code 现有的扩展 API 已经可以实现所有这些功能，但构建预览或自定义编辑器目前需要以非直观的方式拼凑一堆 API。这也给扩展本身留下了很多东西，通常会导致用户体验与 VS Code 的其余部分不一致。自定义编辑器 API 提案旨在改进这一点。

自定义编辑器 API 将为扩展提供一个框架，用于创建完全可自定义的读/写编辑器，这些编辑器将代替 VS Code 的标准文本编辑器用于特定资源。例如，XAML 自定义编辑器可以为您的 .xaml 文件显示 WYSIWYG 样式的编辑器。我们的最终目标是在保持 VS Code 快速、精简和一致的同时，为扩展提供最大的灵活性。

在此迭代中，我们分享了自定义编辑器 API 提案的第一个部分：只读的、基于 webview 的自定义编辑器。您可以在此处找到自定义编辑器提案的概述。自定义编辑器已用于为 VS Code 的内置图像预览提供支持。

当前的提案只是第一步，很可能会进行重大修订。在接下来的几个月中，我们将继续迭代自定义编辑器 API。

TreeView 标题

树视图标题始终取自扩展的 package.json 文件。现在，树视图标题最初取自 package.json，但稍后可以更改。对 title 属性的更改将正确反映在视图标题的 UI 中。

startDebugging consoleMode 选项以合并调试控制台

为了更好地支持分层调试会话，我们在 vscode.debug.startDebugging API 中添加了一个可选参数 consoleMode。此参数控制 VS Code 是否应合并父调试会话和子调试会话的调试控制台。例如，这对于集群调试特别有用，在集群调试中，存在许多子会话，如果所有调试会话都进入同一调试控制台，则会更加简洁。

删除了已弃用的 Terminal.onDidWriteData API

已删除 Terminal.onDidWriteData 提议的 API，取而代之的是全局事件 window.onDidWriteTerminalData。

工程

网站刷新

我们更新了 Visual Studio Code 网站 图标和颜色，以更好地匹配我们的品牌。这反映在整个网站和 文档 页面中。

Website colors updated

通过 terser 进行 JavaScript 最小化

我们更改了用于产品构建的 JavaScript 最小化的最小化器，使其为 terser。以前我们一直使用旧版本的 uglify-es。terser 开发人员在采用过程中为我们提供了非常有益的帮助。

文件监视器更新 (Chokidar)

在此里程碑中，我们将 macOS 和 Linux 的文件监视器更新到 3.x 版本，这带来了改进的性能、降低的内存消耗和更小的软件包大小。您可以从 Chokidar 存储库 和 Chokidar 3 博客文章 中了解更多信息。

针对真实构建运行集成测试

我们的产品构建运行大型集成测试套件作为构建的一部分。以前，这些测试是针对从源代码运行的 VS Code 执行的。现在，这些测试使用 VS Code 的构建版本来验证构建是否已准备好发布。

使用 TypeScript 3.6 构建 VS Code

VS Code 核心和内置扩展现在使用 TypeScript 3.6 构建。

图像预览已移至内置扩展

VS Code 的图像预览功能已从核心代码库移出并移至内置的 图像预览 扩展。图像预览的功能应与以前几乎完全相同。

The built-in Image Preview extension

将图像预览提取到内置扩展中，可以更轻松地修复错误和添加功能，并最终允许扩展更轻松地覆盖 VS Code 的内置图像预览。

此更改由我们在此迭代中完成的 自定义编辑器 API 工作启用。

新文档

Node.js 部署教程

Node.js 部署教程 已移至 learn.microsoft.com 上的 Azure JavaScript 开发人员中心。

在那里您可以找到使用 Visual Studio Code 的教程，以

值得注意的修复

  • 78984：触摸在建议小部件中不起作用
  • 79196：调试控制台以错误的顺序显示 REPL 结果和 console.log 输出
  • 80003：常规断点没有标题工具提示
  • 55106：如果断点至少由一个会话验证，则显示为已验证
  • 80435：请允许我隐藏资源管理器侧边栏中的空文件夹部分
  • 80464：未显示来自 SetVariable 请求的失败消息
  • 80402：调试 UI 未在调试会话结束时清理微调器
  • 82047：指示远程名称的新标题变量

感谢

最后但同样重要的是，非常感谢以下人员帮助使 VS Code 变得更好

对我们的问题跟踪的贡献

如果您想帮助我们管理传入的问题，请参阅我们的 社区问题跟踪 页面。

对 vscode 的贡献

对 vscode-eslint 的贡献

对 vscode-languageserver-node 的贡献

对 language-server-protocol 的贡献

对 debug-adapter-protocol 的贡献

对 vscode-debugadapter-node 的贡献

对 vscode-css-languageservice 的贡献

对 vscode-vsce 的贡献

对 localization 的贡献

有超过 800 名 云 + AI 本地化 社区成员正在使用 Microsoft 本地化社区平台 (MLCP)，其中约有 100 多名活跃贡献者参与 Visual Studio Code。我们感谢您的贡献，无论是提供新的翻译、对翻译进行投票，还是建议流程改进。

以下是 贡献者 的快照。有关项目的详细信息，包括贡献者姓名列表，请访问项目站点 https://aka.ms/vscodeloc。

  • 丹麦语: Mark Drastrup, Lasse Stilvang。
  • 荷兰语: Niels ter Haar, Laurens Kwanten。
  • 英语 (英国): Martin Littlecott, s.benson, sonali Dixit。
  • 芬兰语: Kiti Suupohja, Tommi Finnilä。
  • 法语: Thierry DEMAN-BARCELÒ, Maxime Coquerel, Antoine Griffard, Rodolphe NOEL, DJ Dakta。
  • 德语: Christof Opresnik。
  • 希腊语: Θοδωρής Τσιρπάνης。
  • 希伯来语: Yonatan Bachar, Snir Broshi。
  • 印地语: mtar05, निरव आडतिया, Amit Gusain, Degant Puri。
  • 简体中文: Justin Liu, Yizhi Gu, paul cheung, yungkei fan, 斌 项, Yiting Zhu, 一斤瓜子, Tianzhi Zeng, cool yang, Peng Zeng, Y!an, Joel Yang, 楠 姜, 建 周。
  • 繁体中文: Winnie Lin, 蔡牧村, 謝政廷, Yi-Jyun Pan, Poy Chang。
  • 印尼语: Eriawan Kusumawardhono, Riwut Libinuko, William Surya Permana, Septian Adi, Laurensius Dede Suhardiman。
  • 意大利语: Luigi Bruno, Alessandro Alpi, Claudio Mezzasalma, Marco Dal Pino。
  • 日语: Michihito Kumamoto, Hiroyuki Mori, Aya Tokura, 井上 圭司, Yuzo Konishi, Yoshihisa Ozaki, Kogesaka, Yuta Ojima, TENMYO Masakazu, Koichi Makino, Takayuki Fuwa。
  • 韩语: Hongju, Sungjin Jeong, Seikwang Chung。
  • 拉脱维亚语: Andris Vilde。
  • 立陶宛语: Renatas Laužadis。
  • 波兰语: Kacper Łakomski。
  • 葡萄牙语 (巴西): Marcelo Fernandes, Marcondes Alexandre, Felipe Oliveira, Alan Bueno。
  • 葡萄牙语(葡萄牙): Pedro G..
  • 罗马尼亚语: Mihail-Gabriel Alexe。
  • 俄语: konpl。
  • 西班牙语: José María Aguilar, Abdón Rodríguez P., Ricardo Estrada Rdez, Anix Cormak, Carlos Mendible。
  • 泰米尔语: Rajeshkumar Ramasamy。
  • 土耳其语: Safa Selim。
  • 乌克兰语: Oleksandr Krasnokutskyi, Arthur Murauskas。
  • 越南语: Vương, Van-Tien Hoang, Hai Nguyen, Tuan Duong。