Visual Studio Code

2019年3月（版本1.33）

更新 1.33.1: 本次更新解决了这些问题。

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

欢迎来到2019年3月发布的Visual Studio Code。此版本中有许多更新，我们希望您会喜欢，一些关键亮点包括：

如果您想在线阅读这些发布说明，请访问更新在code.visualstudio.com上。
您还可以查看这个1.33版本的亮点视频，由开发者倡导者Brian Clark提供。

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

  • Workbench - 改进了源代码控制视图，使用屏幕阅读器更容易进行列表导航。
  • 集成终端 - 在Windows上默认启用ConPTY，渲染性能有所提升。
  • 语言 - 禁用CSS属性值补全，TS改进的推断和常量断言。
  • 扩展开发 - 最终确定的智能选择API，安装扩展命令。
  • Engineering - 官方的Linux snap包，通过NPM包缓存加速OSS构建。

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

工作台

更简单的显示语言配置

运行配置显示语言命令现在将打开一个快速选择列表，列出基于您已安装的语言包的可用区域设置，而不是仅打开locale.json文件。当您做出选择时，区域设置将自动更新，并且系统会提示您重新启动VS Code以使更改生效。

配置显示语言快速选择

改进的源代码控制视图

源代码管理视图已调整为与其他视图（如文件资源管理器、调试视图等）行为一致。现在可以使用上下文菜单操作使存储库可见或隐藏。它们的顺序和大小现在也会被保留。您还可以使用上下文菜单操作显示或隐藏源代码管理提供程序视图。

源代码控制视图上下文菜单

检测到屏幕阅读器时的简单键盘导航列表

当VS Code检测到正在使用屏幕阅读器时，它会自动为列表启用简单的键盘导航。这使得使用屏幕阅读器的用户更容易进行列表键盘导航，因为每次按键都会导航到相应的项目。此行为适用于工作台中的所有列表和树，例如文件资源管理器、打开的编辑器和调试视图。

编辑器

IntelliSense 自定义

有一些新的设置可以控制IntelliSense的显示：

  • editor.suggest.filteredTypes - 从IntelliSense中过滤特定类型，例如关键字通过以下方式过滤：{ "keyword": false }。
  • editor.suggest.maxVisibleSuggestions - 控制 IntelliSense 一次显示的项目数量。
  • editor.suggest.showIcons - 启用或禁用 IntelliSense 中图标的显示。

以下是 TypeScript IntelliSense 的示例，其中关键字被过滤掉，没有图标，并且建议数量限制为八个：

智能感知：没有关键词，没有图标，只有八个条目

默认格式化程序选择

我们的许多用户在不同的项目上工作，通常不同的项目使用不同的文档格式化工具。这在配置上一直很困难，我们添加了一个新的设置来帮助解决这个问题，editor.defaultFormatter。现在，当有多个格式化工具可用时，你可以定义一个作为默认。事实上，VS Code 会鼓励你选择一个默认的格式化工具。

选择默认格式化程序

这将更新您的配置（如下所示），以便在后续的保存操作中，VS Code知道选择哪种格式化程序。我们还鼓励您在项目的配置中设置此值。例如，如果您的项目团队同意使用某种格式化程序，那么应在项目设置文件中明确说明。

"[javascript]": {
  "editor.defaultFormatter": "HookyQR.beautify"
}

定义默认格式化程序不会移除其他格式化程序。我们添加了使用...格式化文档命令，该命令仍然允许您在格式化文档之前选择格式化程序。如果需要，您还可以从下拉菜单中重新配置默认格式化程序。

转到定义自定义

一些编程语言允许你在多个位置定义一个符号。这意味着像转到定义这样的功能必须同时转到多个位置。VS Code通过显示一个包含所有位置的Peek视图来支持这一点。现在可以通过一个新的设置editor.gotoLocation.multiple来微调这种行为。

它可以设置为以下值：

  • peek - 在当前位置打开Peek视图。这是默认设置。
  • gotoAndPeek - 打开主要位置（由扩展定义）并显示一个Peek视图。
  • goto - 仅打开主要位置。

代码片段变量 $WORKSPACE_NAME

有一个新的片段变量，它解析为打开的工作区/文件夹的名称：$WORKSPACE_NAME。

如下面的代码片段所示使用它：

"header": {
  "scope": "javascript,typescript",
  "prefix": "workspace",
  "body": ["// the ${WORKSPACE_NAME}-project"],
  "description": "Log output to console"
}

集成终端

ConPTY 在 Windows 版本 18309+ 上默认开启

对于支持的Windows 10 Insider版本，新的终端后端ConPTY将默认启用。这应该会带来更接近原生终端的更稳定体验，并增加256色支持。如果您遇到问题，请告知我们或Windows控制台团队。您始终可以使用此设置选择退出：

{
  "terminal.integrated.windowsEnableConpty": false
}

数据解析上限为12毫秒

之前，终端解析的数据量没有被适当地限制。这意味着在性能较低的硬件上，解析数据和渲染所需的时间远远超过理想的一帧渲染时间，导致UI卡顿或生成大量输出的命令完全锁定。现在有了一个限制，防止这个时间超过大约12毫秒，这应该可以避免这些问题。

语言

TypeScript 3.4

VS Code 现在随附了 TypeScript 3.4.1。此更新增加了对一些新的 TypeScript 语言特性的支持——例如改进的推断和新的 const 断言——同时也带来了工具改进和错误修复。

转换为解构参数重构

新的转换为命名参数重构功能适用于TypeScript，它允许你通过将函数转换为接受单个命名参数对象来快速组织冗长的函数参数列表。

清理一个长参数列表

禁用CSS属性值完成的选项

一个新的设置，css.completion.triggerPropertyValueCompletion，允许你禁用属性值补全。例如，如果你从p中选择position并将此设置设为false，VS Code 将不会触发属性值的static | absolute | sticky | ...补全。

如果您想使用Tab/Shift + Tab来选择上一个和下一个完成项，这将非常有用。

调试

支持子会话

在这个里程碑中，我们增加了在调试器UI中以树形结构显示调试会话的支持。之前调试会话是以平面列表的形式显示的，这使得很难理解会话之间的关系。

由于此功能通过新的扩展API提供，因此需要调试器扩展的采用。在这个里程碑中，唯一使用分层调试会话的调试器是VS Code的Node.js调试器。

在Node.js集群调试中，集群的所有子进程都注册在主调试会话下：

Node.js 子进程在主调试会话下

在“服务器就绪功能”（见下文）中，自动启动的Chrome浏览器会话被注册为服务器调试会话的子会话。

自动打开一个URI

上一个里程碑有一个“服务器就绪”功能的预览版本，它允许你在检测到特定程序输出消息时自动在网页浏览器中打开一个URL。这个功能对于调试网页服务器源代码非常有用，因为浏览器中打开的URL可以在服务器准备就绪时立即让服务器命中断点（这一切只需按一次F5键）。

在这个里程碑中，我们已经将该功能从预览版中移出。VS Code 不仅在调试控制台中查找触发消息，还在集成终端中查找。此外，我们还改进了错误处理。

请注意，由于技术原因，无法在外部终端中支持“服务器就绪”功能。

扩展

安装缺失的依赖项

我们已经改进了当VS Code检测到缺少扩展依赖时的扩展激活失败通知，现在提供了安装缺失依赖的操作。

扩展缺少依赖警告

你也可以使用新的扩展：安装缺失的依赖项命令来安装所有缺失的依赖项。

扩展的网络代理支持

我们现在从操作系统中加载SSL/TLS证书，并在验证由扩展程序发起的https请求时包含这些证书。这支持使用自己的SSL/TLS证书的代理以及其他使用自定义证书的设置。

此外，扩展程序中的http/https请求现在会遵循NO_PROXY环境变量，该变量列出了以逗号分隔的域名，这些域名的所有代理设置应被忽略。

预览功能

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

调用层次结构

调用层次结构视图显示从一个函数发出或接收的所有调用，并允许您深入查看调用者的调用者和调用的调用。下图显示函数foo被bar和bang调用，然后bar被bang和fib调用。

调用层次结构视图

这是一个预览功能，目前没有任何扩展为其提供真实数据。但是，如果您是扩展作者，我们邀请您验证我们提出的API。如果您感兴趣，这里有一个用于测试的示例扩展：https://github.com/jrieken/demo-callhierarchy。

扩展开发

智能选择 API

我们已经确定了与扩展选择 (⌃⇧⌘→ (Windows, Linux Shift+Alt+Right)) 和 缩小选择 (⌃⇧⌘← (Windows, Linux Shift+Alt+Left)) 命令一起使用的智能选择API。通过这个API，扩展可以定义在编辑器中选择的范围。

安装扩展命令

引入了一个新命令 workbench.extensions.installExtension，用于从市场或VSIX安装扩展。

要从市场安装扩展，您需要提供其标识符。

vscode.commands.executeCommand('workbench.extensions.installExtension', 'ms-python.python');

要通过VSIX安装，您需要提供其位置URI。

vscode.commands.executeCommand(
  'workbench.extensions.installExtension',
  vscode.Uri.file('path-to-vsix')
);

调试工具栏贡献支持定位

现在可以在调试工具栏中以任何顺序放置贡献的调试命令。默认的调试命令使用navigation组，因此如果您希望您的贡献命令与默认命令混合使用，请使用相同的组。有关组内排序的更多信息可以在贡献点文档中找到。

为了保持一致性，我们正在弃用菜单ID debug/toolbar，转而使用debug/toolBar。在三月份的发布中，我们将同时支持这两个菜单ID，但在四月份，对debug/toolbar菜单ID的支持将被移除。

"sidebarVisible" 上下文重命名为 "sideBarVisible"

为了保持一致性，我们正在弃用上下文 sidebarVisible，转而使用 sideBarVisible。在三月份的版本中，这两个上下文都将被支持，但在四月份的版本中，将不再支持 sidebarVisible。

TerminalOptions.shellArgs 现在在 Windows 上接受字符串

以前TerminalOptions.shellArgs只支持string[]形式的参数列表。这在Windows上可能会引起问题，因为字符串数组需要转换为命令行格式，而对于复杂情况，这种转换可能会出错或难以正确完成。现在，您可以通过直接使用命令行格式的string来绕过Windows上的这个转换过程。

分层调试会话

为了支持分层调试会话，我们向vscode.debug.startDebugging API添加了一个可选参数parentSession。如果指定了该参数，VS Code将以树状方式显示由startDebugging产生的调试会话，作为父会话的子会话。

移除 vscode.previewHtml 命令

在去年引入webview API之前，vscode.previewHtml命令用于在编辑器中渲染HTML页面。然而，vscode.previewHtml命令存在一些重要的安全和兼容性问题，我们确定在不破坏现有用户的情况下无法修复这些问题。因此，我们没有尝试修复vscode.previewHtml，而是选择在VS Code 1.33中完全移除该命令。

我们已经尽力向所有使用vscode.previewHtml命令的扩展发出充分警告，以便它们可以升级使用webview API。然而，可能仍有一些扩展还在使用vscode.previewHtml命令，因此将不再工作。如果您正在使用这些扩展之一，请向它提交一个问题，或者更好的是，提交一个包含修复的PR。

提议的扩展API

每个里程碑都伴随着新的提议API，扩展作者可以尝试使用它们。一如既往，我们欢迎您的反馈。以下是您尝试提议API需要做的事情：

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

请注意，您不能发布使用提议API的扩展。我们可能会在下一个版本中进行重大更改，并且我们从不希望破坏现有的扩展。

自定义任务执行

除了ProcessExecution和ShellExecution任务外，现在还有一个CustomExecution任务。它不是启动一个进程或运行脚本，而是执行扩展提供的回调函数。

let execution = new vscode.CustomExecution(
  (terminalRenderer, cancellationToken, args): Thenable<number> => {
    return new Promise<number>(resolve => {
      // This is the custom task callback!
      resolve(0);
    });
  }
);
const taskName = 'First custom task';
let task = new vscode.Task2(
  kind,
  vscode.TaskScope.Workspace,
  taskName,
  taskType,
  execution
);

这将为扩展提供的任务在运行时维护状态提供更大的灵活性。它还提供了对任务输入和输出的访问。有关完整示例，请参见测试项目。

评论API

在过去的两个月里，我们围绕评论相关功能进行了大规模的重构，基于我们从GitHub Pull Requests扩展中学到的经验和社区的反馈。新设计的评论API通用且强大，足以满足不同类型的用途。GitHub Pull Requests扩展已经迁移到了新的评论API。

新界面已在VS Code Insiders中提供，我们将使用四月的里程碑来调整和优化API。旧的评论API也将在四月被移除。你可以尝试示例扩展以更好地理解API，或者深入了解GitHub Pull Requests。

WebviewOptions.portMapping

提议的WebviewOptions.portMapping设置允许扩展透明地定义如何在webviews内部解析本地主机端口。

const panel = vscode.window.createWebviewPanel(
  'dog',
  'Dog Doodling',
  vscode.ViewColumn.One,
  {
    portMapping: [
      // Map localhost:3000 in the webview to localhost:4000 externally
      { port: 3000, resolvedPort: 4000 }
    ]
  }
);

panel.webview.html = `<!DOCTYPE html>
    <html lang="en">
    <head>
        <title>Dog Doodling</title>
    </head>
    <body>
        <!--
            With the above port mapping, this image will actually be resolved
            to localhost:4000 on the local machine
        -->
        <img src="http://localhost:3000/canvas.png">
    </body>
    </html>`;

通常认为，在随机端口上启动诸如实时服务器之类的服务是一种良好的做法。通过端口映射，webview的HTML内容可以使用硬编码的端口，该端口映射到服务实际运行的动态打开的端口。

调用层次结构提供者

有一个提议的API用于支持调用层次结构功能的CallHierarchyItemProvider。尝试一下，留下反馈，并帮助我们完善这个优秀的API。

工程

官方Linux snap包

我们现在完全支持将Visual Studio Code作为snap包分发。Snaps可以在许多不同的Linux发行版上运行，为更稳定的VS Code提供可靠的执行环境，并支持后台更新。是的，没错，你现在可以在Linux上获得与Windows和macOS用户相同的产品内自动更新。🎉

Snap store

安装 snap 包非常简单，只需：

sudo snap install code --classic

你是内部人员吗？快来跳转到Insiders snap包，无需额外工作即可获取每日更新：

sudo snap install code-insiders --classic

缓存 NPM 包

感谢我们在Microsoft DevLabs的朋友，我们能够使用一个Azure Pipelines扩展来加速我们的OSS构建，该扩展缓存了NPM包并加速了整个npm install过程。如果您想了解更多关于这方面的信息，您可以阅读这篇博客文章，由Ethan Dennis撰写。

VS Code 的严格空值检查

我们在本次迭代中进行了最后的重大推动，为核心VS Code代码库启用了TypeScript的严格空值检查。严格空值检查有助于捕捉一些常见的编程错误，并使我们的代码库更易于维护，这样我们就能在保持快速的同时确保安全。

为核心VS Code启用严格的空值检查是一项为期六个月的努力，涉及至少40名贡献者，并触及了数万行源代码。您可以阅读我们如何在问题 #60565中逐步启用严格的空值检查。

对扩展的贡献

GitHub 拉取请求

在这个里程碑中，我们继续致力于改进GitHub Pull Requests扩展。

以下是一些新功能：

  • 新增 workbench.action.addComment 和 workbench.action.submitComment 命令，用于自定义添加和提交评论的键盘快捷键。
  • 在描述页面中优化了GitHub待办事项列表的渲染。
  • 采用新的Commenting API。

Vetur

Vetur 扩展现在支持任何工作区版本的 TypeScript > 2.8，因此用户在 *.vue、*.js 和 *.ts 文件之间可以获得更一致的语言支持。

除了提供新的TypeScript语言特性和错误修复外，Vetur还改进了与TypeScript的集成，为*.vue文件带来了灰色未使用变量、代码操作（自动修复）和自动导入功能。

Vetur TypeScript 功能

在Vetur 更新日志中阅读更多关于这些功能的信息。

新文档

Node 远程调试

新的Node.js远程调试主题解释了如何使用Azure App Service扩展将VS Code调试器连接到在Azure上运行的Node.js应用程序。

Azure App Service 扩展

显著的修复

  • 27636: 快速命令模糊搜索不适用于括号内的文本
  • 66632: 以\t开头的行上的终端链接下划线偏移
  • 70962: Console.WriteLine() 不再产生空行

感谢您

最后但同样重要的是，向以下帮助使VS Code变得更好的人们表示衷心的感谢！：

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

对 vscode 的贡献：

对 vscode-css-languageservice 的贡献：

对node-jsonc-parser的贡献：

对inno-updater的贡献：

对debug-adapter-protocol的贡献：

对localization的贡献：

有超过700名云+AI本地化社区成员使用微软本地化社区平台（MLCP），其中约有100名活跃的贡献者为Visual Studio Code做出贡献。

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

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

  • 波斯尼亚语： Ismar Bašanović.
  • 保加利亚语： Любомир Василев.
  • 捷克语： Jakub Stibůrek, David Jareš, Samuel Tulach, Jan Brudný.
  • 丹麦语： Lasse Stilvang, Alexander Matzen, Johan Fagerberg, Allan Kimmer Jensen.
  • 荷兰语： Jos Verlinde, Hans Zoons, Eric Algera, Sujith Quintelier.
  • 英语（英国）： YASHU MITTAL, Mohammad Idrees, Chris Dias.
  • 芬兰语: Petri Niinimäki, Riku Riikonen, Valtteri Vatanen.
  • 法语: Corwin D'Ambre, Mohamed Sahbi, Antoine Griffard, Maxime Coquerel, Cédric M., Steven Dugois, franto.
  • 德语: Frank Lindecke, Dejan Dinic, Jakob von der Haar, Mario Koschischek, Florian Berger, Hans Meiser, Carsten Kneip, Thorsten Hans, Sebastian Seidl.
  • 希腊语: Jim Spentzos, Stratos Kourtzanidis, John D, Δημήτρης Παπαϊωάννου.
  • 希伯来语: Shalom Craimer, Snir Broshi, Kyle Orin.
  • 印地语: Satish Yadav, Amit Gusain, Ashok Kumar Rathore, nirav adatiya, Rajeev Desai, shaswat rungta, Kumar Vaibhav, Jagjeet Singh, Pratishek PII, Chethana S, Dhanvi Kapila.
  • Chinese Simplified: Tingting Yi, 斌 项, feiyun0112 feiyun0112, 刘瑞恒 刘瑞恒, 建东 薛, YITING ZHU, Joel Yang, Junzhe Liu, Dave Young, 昊宇 周, Tony Xia, Yu Zhang, XIANG ZUO, 彦佐 刘, Edi Wang, 少民 谈, Zhiqiang Li, 福永 叶, G.Y. Z, Hao Hu, Pluwen, meng shao, Xiangrui Kong, Liam Kennedy, 松阳 樊, Young Bige, Justin Liu, Jessica Zhang, Licheng Ren, 驰 雷, sun qing, xiong Fu, Fan Su, Lynne Dong, 吉姆 舒, zhao yu, 游 尤, 剑秋 陶, Hanlin Yang, bh wu, Hanyu ZHANG, Y F, WangCG duoduobear, Jiang LI, 越 郑, ziqiang sun, 正元 刘, peng wei, 瑜 周, Simon Chan, 仁松 陈, 翼 张, Wang Weixuan, Ludi Fang, 九鼎 谭.
  • Chinese Traditional: 謝政廷, 奕濬 潘, Winnie Lin, 小克.
  • 匈牙利语: Péter Nagy, Levente Hallai Seiler, Richard Borcsik, Dániel Tar.
  • 印尼语： Laurensius Dede Suhardiman, Franky So, Rachmat Wahidi, Afnizar Nur Ghifari, Pradipta Hendri, Azhe Kun.
  • 意大利语: Alessandro Alpi, Bruni Luca, Andrea Dottor, Riccardo Cappello, Aldo Donetti, Michael Longo.
  • Japanese: nh, EbXpJ6bp -, Hasefumi, Masakazu TENMYO, torisoup, Takayuki Fuwa, Yosuke Sano, Makoto Sakaguchi, 裕子 知念, Rie Moriguchi, Koichi Makino, Fujio Kojima, Kazuya Ujihara, Yasuaki Matsuda.
  • 韩语: Jong Heun Shin, Kyunghee Ko, Jae Yong Kum, SeungJin Jeong.
  • 拉脱维亚语: kaspars bergs.
  • 挪威语： Andreas Rødland, Cookius Monsterius, Stephan Eriksen.
  • 波兰语： Grzegorz Miros, Tomasz Świstak, Michal Szulc, Bartek PL, Szymon Seliga, Tomasz Chojnacki, Marcin Weksznejder, Piotr Grędowski, Artur Pelczar, Marcin Floryan, Jakub Jedryszek.
  • 葡萄牙语（巴西）： Marcondes Alexandre, Albert Tanure, Marcelo Fernandes, Junior Galvão - MVP, Roberto Fonseca, Ray Carneiro, Renan Miguel, Lucas Miranda, Eduardo Moura, Bruno Talanski, Bruno Sonnino, Jucinei Pereira dos Santos, Emmanuel Gomes Brandão, Flávio Albuquerque Camilo, Pablo Garcia, José Rafael de Santana, Douglas Ivatiuk Martim, Giuliano Reginatto, Marcos Dias, Alan William, Lucas Nunes, Gabriel Schade, arthurdenner ., Mauricio Lima, Gabriel Barbosa, Victor Cavalcante, Letticia Nicoli, Fernando Val, Milton Camara, Felipe Scuissiatto, Alessandro Fragnani, Gustavo Bezerra, Cynthia Zanoni, Marcelo Guerra, Jhonathan Soares, Rafael Laranja, Swellington Soares.
  • 葡萄牙语（葡萄牙）： Vitor Barbosa, João Carvalho.
  • 罗马尼亚语： Mihai Marinescu.
  • 俄语: Andrey Veselov, michael v, Иван Лещенко.
  • 塞尔维亚语: Milos Zivkovic.
  • 西班牙语: Andy Gonzalez, Engel Aguilar, Alvaro Enrique Ruano, Carlos Mendible, José María Aguilar, julian3xl, Ing. Sergio Uziel Tovar Lemus, Mario Mendieta, Jorge Serrano Pérez.
  • 泰米尔语: Mani M, Krishna Pravin, Jeffin R P, Vetri ..
  • 土耳其语: Hüseyin Fahri Uzun, Okan Çetin, Muhammed Emin TİFTİKÇİ.
  • 乌克兰语： Dmytro Kutianskyi, Did Kokos.
  • 越南语: Belikhun, Việt Anh Nguyễn.