在 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 上的更新页面。

Insiders 版本：想尽快看到新功能？您可以下载每夜构建的 Insiders 版本，并在最新更新可用时立即试用。要获取最新的 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 字体在 Insiders（绿色图标）菜单栏中的样子。

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

改进的调用堆栈视图行为

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

  • 点击调试会话或线程不再展开它们。您必须直接点击折叠图标（>）UI 元素。这可以防止在您只是想移动焦点时意外展开会话或线程。
  • 如果新的调试会话没有断点，VS Code 不再自动聚焦它们。

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

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

PreLaunchTask 现在可以引用默认构建任务

随着新变量 ${defaultBuildTask} 的引入，现在可以拥有一个总是引用默认构建任务的通用 preLaunchTask。

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

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

preLaunchTask 错误时保存选择

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

PreLaunchTask error choice dialog

对扩展的贡献

远程开发 (预览)

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

1.39 版本的功能亮点包括：

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

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

您还可以阅读最近的两篇博客文章，介绍：

预览功能

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

支持 TypeScript 3.7-beta

虽然 VS Code 在 TypeScript 3.7 正式发布之前不会捆绑它，但我们已经开始努力支持所有令人兴奋的新 TypeScript 3.7-beta 功能。

这些包括：

  • JavaScript 和 TypeScript 文件中可选链和 nullish coalescing 的语法高亮显示。
  • 可选链的完成支持。
  • 使用新的 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 中。

如果 webviews 不使用 Webview.asWebviewUri 处理本地资源，则会发出警告

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

Debug warning for a webview that uses vscode-resources

虽然旧的 vscode-resource: URI 仍然有效，但我们希望所有 webview 扩展迁移到 Webview.asWebviewUri API，因为新 API：

  • 处理从网络驱动器加载本地资源的一些棘手边缘情况。
  • 使得 webview 可以加载本地和远程内容的混合。
  • 对于 VS Code 的 Web 版本将更可靠。

树状视图消息 API

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

更新的 Octicons 样式

我们更新了Octicons，使其与我们的新图标轮廓样式匹配，从而使我们所有的图标保持一致。

Updated Octicons

SCM 文件夹菜单

更新的 SCM 视图现在支持以树状结构渲染更改。作为 SCM 提供者，您可以使用 scm/resourceFolder/context 菜单 id 为文件夹的菜单贡献命令。

Language Server Protocol

Language Server Protocol 的 3.15.0 版本规范已可用。该版本尚未最终确定，因此欢迎通过在 Language Server Protocol 仓库中提交 issue 或 pull request 来提供反馈。下一版本的 Language Server Protocol 已添加了流式传输和进度报告支持。node 服务器和 VS Code 客户端的实现分别以 vscode-languageserver@6.0.0-next.1 和 vscode-languageclient@6.0.0-next.1 提供。

Debug Adapter Protocol

取消支持

Debug Adapter Protocol 中添加了一个新的 cancel 请求，可以向调试适配器发出提示，表明前端客户端不再对之前发出的特定请求产生的结果感兴趣。

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

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

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

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

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

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

客户端仅当定义了 supportsBreakpointLocationsRequest 能力且其值为 true 时才能调用 breakpointLocations 请求。

建议的扩展 API

每个里程碑都会带来新的建议 API，扩展作者可以试用它们。一如既往，我们渴望收到您的反馈。要试用建议的 API，您需要这样做：

  • 您必须使用 Insiders 版本，因为建议的 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(`http://localhost:${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 编辑器

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

自定义编辑器 API 将为扩展提供一个框架，用于创建完全可定制的读/写编辑器，这些编辑器将用于替代 VS Code 的标准文本编辑器来处理特定资源。例如，一个 XAML 自定义编辑器可以为您的 .xaml 文件显示一个所见即所得 (WYSIWYG) 风格的编辑器。我们的最终目标是在保持 VS Code 快速、轻量和一致的同时，为扩展提供尽可能多的灵活性。

在本次迭代中，我们正在分享自定义编辑器 API 提案的第一部分：基于 webview 的只读自定义编辑器。您可以在这里找到自定义编辑器提案的概述。自定义编辑器已被用于驱动 VS Code 的内置图像预览功能。

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

树状视图标题

树状视图标题一直取自扩展的 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: 触控在 Suggest widget 中不起作用
  • 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 名 Cloud + 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.