🚀 在 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 上的默认标题栏样式

在听取用户反馈后,我们已决定恢复将默认设置 window.titleBarStylecustom 更改为 Linux 上的 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 代码操作类型来实现“修复所有”和保存时自动修复。

expandLineSelection 的默认键绑定更改

命令 expandLineSelection 现在默认绑定到 Ctrl+L (macOS 上为 Cmd+L),而不是 Ctrl+I (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,这是一个小型更新,修复了一些重要的错误

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

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

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

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

改进了 ARIA 属性的 HTML IntelliSense

感谢从 W3CMDN 检索的数据,VS Code 现在显示 ARIA(Accessible Rich Internet Applications)属性和 DOM 事件的描述。

HTML IntelliSense for ARIA and Event attributes

在 HTML 扩展中删除了 Razor 支持

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

调试

调试控制台的字体配置

现在可以使用以下设置在调试控制台中配置字体大小、字体系列和行高:debug.console.fontSizedebug.console.fontFamilydebug.console.lineHeight

Debug Console font

调试控制台文本换行

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

Debug Console wrap

集成终端

在发送序列命令中支持变量

现在可以将 变量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 连接。端口在调试控制台中公布,通常开发人员现在会在浏览器应用程序中键入 https://127.0.0.1:3000

新功能使得可以将结构化属性 serverReadyAction 添加到任何启动配置,并选择要执行的“操作”

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

  "serverReadyAction": {
    "pattern": "listening on port ([0-9]+)",
    "uriFormat": "https://127.0.0.1:%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://127.0.0.1:5001”。
  • uriFormat: "https://127.0.0.1:%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 的 相关博客文章,以获取更多信息。

严格的 null 检查进展

我们继续朝着 对主 VS Code 代码库进行严格的 null 检查 取得了良好进展。在此迭代中,我们将剩余的严格 null 错误数量减少了一半,修复了 2000 多个错误。我们仍然剩下大约 1800 个严格 null 错误,并且许多剩余的错误都很棘手,但终点就在眼前。

编译到 ES6

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

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

对扩展的贡献

GitHub Pull Requests

在此里程碑中,我们继续改进 GitHub Pull Requests 扩展。

以下是一些新功能

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

Vetur

Vetur 扩展现在为 Vue.js 插值 提供 IntelliSense(智能完成)。

完成项来源于 Vue.js propsdatacomputedmethods API 调用。源代码以及任何 JSDoc 文档都用作完成项描述。

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

Vetur IntelliSense for Vue templates

其他值得注意的功能包括

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

您可以在 Vetur 的 Changelog 中了解有关这些功能的更多信息。

新文档

使用 webpack 捆绑扩展

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

webpack logo

使用 JavaScript

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

值得注意的修复

  • 55084: 允许创建/打开包含反斜杠的文件名
  • 68204: 从类似“folder/subfolder/file.txt”的路径创建后,新文件未在资源管理器中显示
  • 68316: 新的工作台资源管理器树视图无法正确更新
  • 68616: 调试 NodeJS (mocha 测试) 时,断点被命中但没有视觉指示
  • 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 名 Cloud + 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。
  • Indonesian: 印度尼西亚语:Laurensius Dede Suhardiman, Afnizar Nur Ghifari, Pradipta Hendri, Azhe Kun, Italian (Italy), Bruni Luca, Alessandro Alpi, Andrea Dottor, Riccardo Cappello, Aldo Donetti, Michael Longo。
  • Japanese: 日语:nh, EbXpJ6bp -, Masakazu TENMYO, Takayuki Fuwa, Makoto Sakaguchi, 裕子 知念, Rie Moriguchi, Koichi Makino, Fujio Kojima, Kazuya Ujihara。
  • Korean: 韩语:Jong Heun Shin, Kyunghee Ko, Jae Yong Kum, SeungJin Jeong。
  • Norwegian: 挪威语:Cookius Monsterius, Stephan Eriksen。
  • Polish: 波兰语:Grzegorz Miros, Tomasz Świstak, Michal Szulc, Bartek PL, Szymon Seliga, Tomasz Chojnacki, Marcin Weksznejder, Artur Pelczar, Marcin Floryan, Jakub Jedryszek。
  • Portuguese (Brazil): 葡萄牙语(巴西):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。
  • Portuguese(Portugal): 葡萄牙语(葡萄牙):João Carvalho, Vitor Barbosa。
  • Russian: 俄语:michael v, Иван Лещенко。
  • Spanish: 西班牙语: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。
  • Tamil: 泰米尔语:Mani M, Krishna Pravin, Vetri。
  • Turkish: 土耳其语:Hüseyin Fahri Uzun, Okan Çetin, Muhammed Emin TİFTİKÇİ。
  • Ukrainian: 乌克兰语:Did Kokos。
  • Vietnamese: 越南语:Việt Anh Nguyễn, Belikhun。