在 VS Code 中尝试 ！

2019 年 2 月 (版本 1.32)

更新： 每次更新解决的问题 - 1.32.3 - 1.32.2 - 1.32.1

下载：Windows: x64 | Mac: Intel | Linux 64 位: deb rpm tarball | 32 位: deb rpm tarball

欢迎阅读 Visual Studio Code 2019 年 2 月版本。此版本包含一些重要的更新，我们希望您会喜欢，主要亮点包括：

如果您想在线阅读这些发行说明，请访问 code.visualstudio.com 上的 更新。
您还可以观看 Cloud Developer Advocate Brian Clark 制作的 1.32 版本 亮点视频。

发行说明按与 VS Code 关注领域相关的以下部分排列。以下是一些进一步的更新：

  • 工作台 - 键盘导航控制、大纲视图和面包屑使用新的树形控件。
  • 编辑器 - “全部修复”源代码操作允许您在保存时修复，改进了列选择。
  • 语言 - 安装 TypeScript 和 Markdown 扩展后无需重新加载。
  • 扩展创作 - 向调试工具栏添加命令，跟踪上次方法签名选择。

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

工作台

预览和应用新的主题

现在，在安装了贡献颜色和文件图标主题的扩展后，您可以立即预览和应用它们。

Applying Theme

键盘快捷方式编辑器

现在您可以在键盘快捷方式编辑器中编辑键绑定的 when 子句。

Changing When expression

我们已从键盘快捷方式编辑器中移除了打开 keybindings.json 文件的链接，转而使用编辑器标题栏右侧的 {} 按钮。

直接编辑 keybindings.json 文件时，左侧不再显示默认键绑定。如果您更喜欢查看默认键绑定，可以检查 工作台 > 设置：打开默认键绑定 设置 (workbench.settings.openDefaultKeybindings 设置为 true)。

自动键盘导航设置

新增设置 列表：自动键盘导航 控制列表和树是否捕获按键进行导航和过滤元素。如果禁用此设置，键盘导航将变为模态，并使用 list.toggleKeyboardNavigation 命令来切换其状态。您可以为此命令指定特定的键盘快捷方式。例如，您可以将其设置为 /，只有在按下 / 后，后续的按键才会过滤列表/树中的项目。此设置默认为启用。

以下是使用 / 切换文件资源管理器键盘导航的键绑定：

{
  "key": "/",
  "command": "list.toggleKeyboardNavigation",
  "when": "filesExplorerFocus"
}

Linux 上的默认标题栏样式

在听取用户反馈后，我们决定撤销将 Linux 上 window.titleBarStyle 默认设置从 custom 改回 native 的更改。对于需要更好可访问性支持的用户，我们仍然推荐使用自定义标题栏。此更改的更多信息已记录在我们的 Linux 设置 页面中。

大纲和面包屑的新树形控件

大纲文档符号视图和面包屑选择器已采用新的树形控件。新实现使其速度更快，并提供更好的过滤支持，以及其他新的树形控件增强功能。

编辑器

悬停和问题预览改进

在此版本中，问题悬停中添加了一个命令栏，包含快速修复和预览问题操作。快速修复操作从悬停中应用快速修复，预览问题操作将在编辑器中打开预览视图。

Problem Hover

从问题预览视图中，您现在可以导航到上一个和下一个错误/警告。

Problem Peek

我们还改进了悬停和问题预览视图的外观。带有问题和代码块的悬停有足够的空间显示其内容。

Hover

自动修复和首选代码操作

代码操作 API 支持 VS Code 的快速修复（您在编辑器中看到的灯泡）。虽然针对给定错误可能有很多快速修复，但通常有一个是最合理的修复方案。例如，修复拼写错误通常比生成新字段更可能是合理的修复。

扩展现在可以将代码操作标记为“首选”，以指示它是底层问题最合理的修复方案。当存在首选修复时，灯泡上会添加一个蓝色徽章。可以使用自动修复命令自动应用首选修复 (⌥⌘. (Windows, Linux Shift+Alt+.))。

Preferred fixes are indicated with a blue badge on the lightbulb

首选快速修复通常应该：

  • 正确修复底层错误（而不是抑制它）。
  • 是针对错误的合理修复方案。
  • 不会意外地执行广泛的操作。

重构代码操作也可以标记为首选，以指示它们是最合理的重构。例如，虽然可能有多个提取常量重构可用，但用户通常希望提取到最近的局部变量。如果该重构代码操作标记为 isPreferred，用户可以为其设置单个键绑定：

{
  "key": "ctrl+shift+r ctrl+e",
  "command": "editor.action.codeAction",
  "args": {
    "kind": "refactor.extract.constant",
    "preferred": true
  }
}

全部修复源代码操作

新的 source.fixAll CodeActionKind 为可以在文件中自动修复错误的扩展建立了一个约定。这种新的源代码操作类型类似于整理导入，并使得为全部修复操作配置键绑定或在保存时启用自动修复变得容易：

// On save, run both fixAll and organizeImports source actions
"editor.codeActionsOnSave": {
    "source.fixAll": true,
    "source.organizeImports": true,
}

TSLint 扩展 已使用 source.fixAll Code Action kind 来实现全部修复和保存时自动修复。

expandLineSelection 的默认键绑定更改

命令 expandLineSelection 现在默认绑定到 Ctrl+L (macOS 上为 Cmd+L)，而不是 Ctrl+I (macOS 上为 Cmd+I)。

改进的列选择

当多光标修改器设置配置为使用 Ctrl (macOS 上为 Cmd)，即 "editor.multiCursorModifier": "ctrlCmd"，并且因此 Alt 修改器仅用于转到定义时，现在可以在编辑器中拖动选择时按下 Alt 修改器，以在常规选择或列选择之间切换。

在下面的视频中，选择开始时是常规选择，然后按下并按住 Alt 直到释放鼠标按钮：

Column Selection with the Alt key

语言

TypeScript 3.3.3

此版本包含 TypeScript 3.3.3，这是一个小的更新，修复了一些重要的 bug。

安装 TypeScript 扩展时无需重新加载

上一次迭代，VS Code 已更改为在安装绝大多数扩展后不再需要重新加载。VS Code 现在也支持动态加载 TypeScript 插件扩展。当您安装新的 TypeScript 扩展（例如 TSLint）时，无需重新加载即可自动启用该扩展。

安装 Markdown 扩展时无需重新加载

此外，安装 GitHub Markdown Preview 等扩展后，您不再需要重新加载 VS Code。一旦安装了 Markdown 扩展，任何活动的 Markdown 预览都将自动更新。

改进的 HTML ARIA 属性 IntelliSense

得益于从 W3C 和 MDN 获取的数据，VS Code 现在显示 ARIA（无障碍富互联网应用）属性和 DOM 事件的描述。

HTML IntelliSense for ARIA and Event attributes

HTML 扩展中移除了 Razor 支持

已移除旧的 ASP.NET Razor 支持。现在，我们建议使用 C# 扩展 来编辑 Razor 文件。

调试

调试控制台字体配置

现在可以使用以下设置配置调试控制台的字体大小、字体族和行高：debug.console.fontSize、debug.console.fontFamily 和 debug.console.lineHeight。

Debug Console font

调试控制台文本换行

得益于采用了新的树形控件，调试控制台现在支持对其所有元素（甚至对象内部的属性）进行自动文本换行。

Debug Console wrap

集成终端

send sequence 命令中的变量支持

现在可以在 workbench.action.terminal.sendSequence 命令中使用 变量，例如：

{
  "key": "ctrl+shift+t",
  "command": "workbench.action.terminal.sendSequence",
  "args": { "text": ". ${file}" }
}

预览功能

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

调试服务器程序时自动打开 URI

开发 Web 程序通常需要在 Web 浏览器中打开特定 URL，以便在调试器中命中服务器代码。在此里程碑中，我们添加了一个新的 VS Code 功能的初步版本，它尝试以灵活的方式自动化此过程。

以下是一个简单的 Node.js Express 应用程序示例：

var express = require('express');
var app = express();

app.get('/', function(req, res) {
  res.send('Hello World!');
});

app.listen(3000, function() {
  console.log('Example app listening on port 3000!');
});

此应用程序首先为 "/" URL 安装一个“Hello World”处理程序，然后开始监听端口 3000 上的 HTTP 连接。端口会在调试控制台中宣布，通常开发人员会将其浏览器应用程序中输入 http://localhost:3000。

新功能允许向任何启动配置添加结构化属性 serverReadyAction 并选择要执行的“操作”：

{
  "type": "node",
  "request": "launch",
  "name": "Launch Program",
  "program": "${workspaceFolder}/app.js",

  "serverReadyAction": {
    "pattern": "listening on port ([0-9]+)",
    "uriFormat": "http://localhost:%s",
    "action": "openExternally"
  }
}

这里的 pattern 属性描述了用于匹配程序输出字符串中宣布端口的正则表达式。端口号的模式被放在括号中，以便它可用作正则表达式捕获组。在此示例中，我们仅提取端口号，但也可以提取完整 URI。

uriFormat 属性描述了如何将端口号转换为 URI。第一个 %s 由匹配模式的第一个捕获组替换。

然后，生成的 URI 会在 VS Code 外部（“外部”）使用为 URI 方案配置的标准应用程序打开。

或者，可以将 action 设置为 debugWithChrome。在这种情况下，VS Code 会为 URI 启动一个 Chrome 调试会话（这需要安装 Debugger for Chrome 扩展）。在此模式下，可以添加一个 webRoot 属性，该属性会传递给 Chrome 调试会话。

为了稍微简化，大多数属性都是可选的，我们使用以下回退值：

  • pattern: "listening on.* (https?://\\S+|[0-9]+)"，它匹配常用的消息“listening on port 3000”或“Now listening on: https://localhost:5001”。
  • uriFormat: "http://localhost:%s"
  • webRoot: "${workspaceFolder}"

以下是该功能的实际效果：

Server ready feature in action

请注意，在此功能的预览版本中：

  • 模式仅在调试控制台中匹配。如果调试目标在集成终端中启动，则尚不起作用（并且在外部终端中永远不起作用）。
  • 如果配置了 debugWithChrome 但未安装 Debugger for Chrome 扩展，则该功能不会发出警告。
  • 尚不能使用其他基于浏览器的调试器。

扩展创作

向调试工具栏贡献命令

现在扩展可以向调试工具栏贡献命令。

以下是一个扩展 package.json 中的示例：

"contributes": {
  "commands": [
    {
      "command": "dart.hotReload",
      "title": "Hot Reload",
      "icon": {
        "dark": "./media/hot_reload_inverse.svg",
        "light": "./media/hot_reload.svg"
      }
    }
  ],
  "menus": {
    "debug/toolbar": [
      {
        "command": "dart.hotReload",
        "when": "debugType == dart",
        "group": "dart"
      }
    ]
  }
}

该扩展在调试工具栏右侧添加了一个“热重载”按钮。

Add to debug toolbar

SignatureHelpContext.activeSignatureHelp

SignatureHelpContext 对象现在有一个 activeSignatureHelp 字段，用于跟踪先前活动的签名：

import * as vscode from 'vscode';

class MySignatureHelpProvider implements vscode.SignatureHelpProvider {
    provideSignatureHelp(
        document: vscode.TextDocument,
        position: vscode.Position,
        token: vscode.CancellationToken,
        context: vscode.SignatureHelpContext
    ): vscode.ProviderResult<vscode.SignatureHelp> {
        // The active signature help when this provider was triggered or undefined if
        // no signature help was active.
        console.log(context.activeSignatureHelp);

        ...
    }
}

提供者可以使用它来跟踪在重新触发签名帮助提供者之前用户选择了哪个重载。

建议的扩展 API

每个里程碑都会带来新的建议 API，扩展作者可以尝试使用它们。一如既往，我们期待您的反馈。以下是尝试使用建议 API 的方法：

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

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

workspace.registerResourceLabelFormatter

export interface ResourceLabelFormatter {
  scheme: string;
  authority?: string;
  formatting: ResourceLabelFormatting;
}

export interface ResourceLabelFormatting {
  label: string; // myLabel:/${path}
  separator: '/' | '\\' | '';
  tildify?: boolean;
  normalizeDriveLetter?: boolean;
  workspaceSuffix?: string;
  authorityPrefix?: string;
}

export namespace workspace {
  export function registerResourceLabelFormatter(
    formatter: ResourceLabelFormatter
  ): Disposable;
}

扩展可以使用 registerResourceLabelFormatter 贡献动态资源标签格式化程序，用于指定如何在工作台的任何地方显示 URI。

工程

Linux 32 位支持即将结束

VS Code 使用 Electron 作为跨平台运行的框架。我们目前使用 Electron 版本 3.x，这将是最后一个支持 Linux 32 位架构的版本。由于我们计划很快（1-2 个月）迁移到 Electron 4.x，这意味着 VS Code 将不再在 Linux 32 位上运行。请将您的 VS Code 版本更新到 64 位版本。您的所有设置和扩展将像以前一样工作，无需进行任何迁移。您可以阅读 Electron 的相关博客文章以获取更多信息。

严格空检查进度

我们继续在 对主要的 VS Code 代码库进行严格空检查 方面取得了良好进展。本次迭代，我们将剩余的严格空错误数量减少了一半，修复了 2000 多个错误。我们仍有大约 1800 个严格空错误需要解决，其中许多是棘手的错误，但终点已在望。

编译到 ES6

VS Code 用 TypeScript 编写，TypeScript 被编译为 JavaScript。TypeScript 可以针对不同的 JavaScript 版本，在此版本中，我们针对 ES6 JavaScript。ES6 更接近 TypeScript 并生成更少的代码，这意味着加载时间更快。

注意： 这意味着我们的 JavaScript 输出使用 JavaScript 中定义的 类。我们有一个实用的工具，仍然允许函数“继承”这些类，并且我们已创建了一个 跟踪项，供扩展作者现在也发出 ES6。一切应该仍然像以前一样工作，但我们鼓励所有人加入 ES6 的行列。

对扩展的贡献

GitHub 拉取请求

在此里程碑中，我们继续致力于改进 GitHub 拉取请求 扩展。

以下是一些新功能：

  • 在拉取请求描述页面查看和分配审阅者和标签。
  • GitHub 拉取请求树视图现在显示在其自己的视图容器中。您也可以通过修改 githubPullRequests.showInSCM 选择在源代码管理视图中显示它们。
  • 查看和修改评论的反应。

Vetur

Vetur 扩展现在为 Vue.js 插值 提供 IntelliSense（智能补全）。

补全项来自 Vue.js props、data、computed 和 methods API 调用。源代码以及任何 JSDoc 文档均用作补全项描述。

当在父组件中使用子组件时，Vetur 还会在子组件的 props 上提供 IntelliSense。

Vetur IntelliSense for Vue templates

其他值得注意的功能包括：

  • 使用 Prettier 作为 <template> 格式化程序的选项。
  • GraphQL 自定义块语法高亮。
  • Pug 插值语法高亮。

您可以在 Vetur 的更新日志中了解更多关于这些功能的信息。

新文档

使用 webpack 捆绑扩展

对于扩展作者，有一个新的捆绑扩展主题，介绍如何使用 webpack 捆绑扩展文件以减少扩展加载时间。

webpack logo

使用 JavaScript

一篇新的使用 JavaScript文章介绍了 VS Code 支持的高级 JavaScript 功能。您将了解将 JavaScript 项目文件 (jsconfig.json) 添加到代码中的好处，以及如何启用类型检查。

重要修复

  • 55084: 允许创建/打开包含反斜杠的文件名
  • 68204: 从 'folder/subfolder/file.txt' 这样的路径创建的新文件在资源管理器中不显示
  • 68316: 新工作台资源管理器树视图未能正确更新
  • 68616: 调试点被命中但调试 nodejs (mocha tests) 时没有视觉指示
  • 68691: 在资源管理器中没有输入框来创建新文件
  • 68627: '在侧边栏中显示' 无效
  • 67970: 新资源管理器：切换编辑器时应清除焦点

此版本还包括针对 Microsoft 安全响应中心 CVE-2019-5786 的安全更新，您可以在这篇Electron 博客文章中阅读相关内容。

感谢

最后但同样重要，向以下帮助改进 VS Code 的各位表示诚挚的感谢！

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

对 vscode 的贡献

对 vscode-languageserver-node 的贡献

对 node-jsonc-parser 的贡献

对 vscode-generator-code 的贡献

对 vscode-vsce 的贡献

对 vscode-recipes 的贡献

对 localization 的贡献

目前，有超过 700 位云 + AI 本地化社区成员正在使用 Microsoft 本地化社区平台 (MLCP)，其中有约 100 位活跃的 Visual Studio Code 贡献者。

我们感谢您的贡献，无论是提供新的翻译、对翻译进行投票还是改进流程建议。

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

  • 波斯尼亚语： Ismar Bašanović。
  • 保加利亚语： Любомир Василев。
  • 捷克语： Jakub Stibůrek, Samuel Tulach, Jan Brudný。
  • 丹麦语： Lasse Stilvang,Alexander Matzen,Johan Fagerberg。
  • 荷兰语： Jos Verlinde, Eric Algera。
  • 英语（英国）： Mohammad Idrees。
  • 芬兰语： Petri Niinimäki, Riku Riikonen, Valtteri Vatanen。
  • 法语： Mohamed Sahbi, Antoine Griffard, Maxime COQUEREL, franto。
  • 德语： Frank Lindecke, Jakob von der Haar, Hans Meiser, Carsten Kneip, Sebastian Seidl。
  • 希腊语： Jim Spentzos, John D, Δημήτρης Παπαϊωάννου。
  • 希伯来语： Snir Broshi, Kyle Orin。
  • 印地语： Satish Yadav, Ashok Kumar Rathore, nirav adatiya, Amit Gusain, shaswat rungta, Jagjeet Singh, Pratishek PII, Chethana S, Dhanvi Kapila。
  • 简体中文： Tingting Yi, 斌 项, feiyun0112 feiyun0112, 建东 薛, 刘瑞恒 刘瑞恒, Junzhe Liu, Dave Young, 昊宇 周, Joel Yang, Tony Xia, XIANG ZUO, Edi Wang, Zhiqiang Li, 福永 叶, G.Y. Z,Hao Hu, Pluwen, meng shao, YITING ZHU, Xiangrui Kong, Liam Kennedy, 松阳 樊, Young Bige, Justin Liu, Jessica Zhang, Licheng Ren, 驰 雷, 彦佐 刘, xiong Fu, Fan Su, Lynne Dong, 吉姆 舒, 游 尤, 剑秋, 陶, Hanlin Yang, bh wu, Y F, WangCG duoduobear, ziqiang sun, 越 郑, Jiang LI, 正元 刘, peng wei, 瑜 周, 仁松 陈, 翼 张, Ludi Fang, 九鼎 谭。 繁体中文： 奕濬 潘, Winnie Lin。
  • 匈牙利语： Péter Nagy, Dániel Tar。
  • 印度尼西亚语： Laurensius Dede Suhardiman, Afnizar Nur Ghifari, Pradipta Hendri, Azhe Kun, 意大利语 (意大利), Bruni Luca, Alessandro Alpi, Andrea Dottor, Riccardo Cappello, Aldo Donetti, Michael Longo。
  • 日语： nh, EbXpJ6bp -, Masakazu TENMYO, Takayuki Fuwa, Makoto Sakaguchi, 裕子 知念, Rie Moriguchi, Koichi Makino, Fujio Kojima, Kazuya Ujihara。
  • 韩语： Jong Heun Shin, Kyunghee Ko, Jae Yong Kum, SeungJin Jeong。
  • 挪威语： Cookius Monsterius, Stephan Eriksen。
  • 波兰语： Grzegorz Miros, Tomasz Świstak, Michal Szulc, Bartek PL, Szymon Seliga, Tomasz Chojnacki, Marcin Weksznejder, Artur Pelczar, Marcin Floryan, Jakub Jedryszek。
  • 葡萄牙语（巴西）： Marcondes Alexandre, Albert Tanure, Marcelo Fernandes, Junior Galvão - MVP, Ray Carneiro, Eduardo Moura, Bruno Talanski, Bruno Sonnino, Jucinei Pereira dos Santos, Emmanuel Gomes Brandão, Flávio Albuquerque Camilo, Pablo Garcia, Lucas Miranda, Giuliano Reginatto, Alan William, Lucas Nunes, Gabriel Schade, arthurdenner., Mauricio Lima, Roberto Fonseca, Letticia Nicoli, Milton Camara, Alessandro Fragnani, Marcelo Guerra, Cynthia Zanoni, Jhonathan Soares, Rafael Laranja, Swellington Soares。
  • 葡萄牙语（葡萄牙）： João Carvalho, Vitor Barbosa。
  • 俄语： michael v, Иван Лещенко。
  • 西班牙语： Andy Gonzalez, Alvaro Enrique Ruano, Engel Aguilar, Carlos Mendible, José María Aguilar, julian3xl, Ing. Sergio Uziel Tovar Lemus, Mario Mendieta, Jorge Serrano Pérez。
  • 泰米尔语： Mani M, Krishna Pravin, Vetri。
  • 土耳其语： Hüseyin Fahri Uzun, Okan Çetin, Muhammed Emin TİFTİKÇİ。
  • 乌克兰语： Did Kokos。
  • 越南语： Việt Anh Nguyễn, Belikhun。