在 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 上的更新页面。
您还可以观看云开发倡导者 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.titleBarStylecustom 恢复为 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(可访问富互联网应用程序)属性和 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 连接。端口会在调试控制台中宣布,通常开发人员现在会在他们的浏览器应用程序中输入 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 的 propsdatacomputedmethods 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: 调试 Node.js (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 的贡献

本地化的贡献

有超过 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。