尝试以扩展 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 扩展时无需重新加载。
  • 扩展创作 - 向调试工具栏添加命令,跟踪上次方法签名选择。

Insider 版本:想尽快看到新功能?您可以下载每晚的 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+ICmd+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 预览等扩展后,您不再需要重新加载 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 连接。端口在调试控制台中公布,通常开发人员现在会在其浏览器应用程序中键入 https://:3000

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

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

  "serverReadyAction": {
    "pattern": "listening on port ([0-9]+)",
    "uriFormat": "https://:%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://:5001”。
  • uriFormat: "https://:%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 版本,这将是最后一个支持 32 位架构 Linux 的版本。由于我们计划很快(1-2 个月内)迁移到 Electron 4.x,这意味着 VS Code 将不再在 32 位 Linux 上运行。请将您的 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 Pull Requests 扩展。

以下是一些新功能

  • 在拉取请求描述页面查看并分配审阅者和标签。
  • 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: 从“文件夹/子文件夹/文件.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 名云 + 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.
  • 简体中文: 易婷婷, 项斌, feiyun0112 feiyun0112, 薛建东, 刘瑞恒 刘瑞恒, Junzhe Liu, Dave Young, 周昊宇, Joel Yang, Tony Xia, 左翔, Edi Wang, 李志强, 叶福永, G.Y. Z, Hao Hu, Pluwen, 邵猛, 朱亦婷, 孔祥瑞, Liam Kennedy, 樊松阳, Young Bige, Justin Liu, Jessica Zhang, Licheng Ren, 雷驰, 刘彦佐, 付雄, 苏帆, Lynne Dong, 舒吉姆, 尤游, 剑秋, 陶, 杨翰林, bh wu, Y F, WangCG duoduobear, 孙自强, 郑越, 李江, 刘正元, 魏鹏, 周瑜, 陈仁松, 张翼, 方璐迪, 谭九鼎. 繁体中文: 潘奕濬, 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.