🚀 在 VS Code 中获取 ！

2018 年 10 月（版本 1.29）

更新 1.29.1：此更新解决了这些 问题。

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

欢迎使用 Visual Studio Code 2018 年 10 月版。此版本中有许多重大更新，我们希望您会喜欢。以下是一些主要亮点，包括

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

发行说明按与 VS Code 重点领域相关的以下部分进行组织。以下是一些进一步的更新

  • 工作台 - 平台特定的行尾字符，突出显示已修改的文件选项卡。
  • 集成终端 - 拆分终端 cwd 选项，Cmd+退格键删除到行首。
  • 语言 - 在悬停时显示 CSS 特异性，处理未知的 CSS 属性。
  • 调试 - 多个调试控制台，启动时停止在入口点，样式化 console.log 消息。
  • 扩展创作 - 活动终端 API，对自定义视图的更多控制。

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

搜索

多行搜索

VS Code 现在支持多行搜索！与编辑器中相同，只有当正则表达式搜索包含 \n 字面量时，才会在多行模式下执行。搜索视图会在每个多行匹配项旁边显示一个提示，其中包含其他匹配行的数量。

Multiline search

此功能得益于在 ripgrep 工具中完成的多行搜索实现工作。

搜索中的反向引用和先行断言

现在还可以通过设置 "search.usePCRE2": true 在正则表达式搜索中使用反向引用和 先行断言。这会将 ripgrep 配置为使用 PCRE2 正则表达式引擎。虽然 PCRE2 支持许多其他功能，但我们仅支持在 JavaScript 中仍然有效的正则表达式，因为打开的编辑器仍然使用编辑器的基于 JavaScript 的搜索进行搜索。

Fancy regex search

如果您仍然缺少后向断言，请不要担心！JavaScript 最近才支持该功能，并且应该会在以后的 Electron shell 更新中添加到 VS Code 中。

在搜索中显示行号

我们添加了一个设置 search.showLineNumbers，它将在搜索视图中为每个匹配项显示行号。

禁用搜索和替换预览

有一个新设置 search.useReplacePreview，允许您禁用在搜索视图中执行搜索/替换时出现的预览差异。

line numbers

在搜索中使用全局 .gitignore 文件

Git 允许您使用 core.excludesfile 配置属性来配置全局 gitignore 文件。默认情况下，搜索不遵守全局 gitignore 文件，但您现在可以通过启用新设置 search.useGlobalIgnoreFiles 来更改此行为。

工作台

macOS Mojave 深色模式支持

VS Code 现在更好地支持 macOS Mojave 深色模式。以前，即使 macOS 在深色主题下运行，VS Code 菜单和对话框也会显示默认的浅色主题。现在，如果启用深色模式，所有本机 UI 元素都将以深色模式显示。

macOS Mojave Dark Mode

macOS 全屏支持

引入了一个新设置 window.nativeFullScreen，如果设置为 false，将为 VS Code 启用不使用本机 macOS 全屏功能的全屏模式。这样做的好处是进入全屏模式不会在桌面上创建 macOS 空间。默认情况下，VS Code 仍将使用 macOS 本机全屏。

files.eol 的新默认值：auto

行尾设置 files.eol 现在有一个新的默认值 auto。当设置为 auto 时，新文件的行尾字符特定于操作系统。在 Windows 上为 \r\n，在 macOS 和 Linux 上为 \n。您仍然可以显式将 file.eol 设置为 \n 或 \r\n。

突出显示已修改的选项卡

新设置 workbench.editor.highlightModifiedTabs 在编辑器选项卡的顶部显示一个粗边框，只要编辑器是脏的（有未保存的更改）。这使得查找需要保存的文件更容易。可以自定义边框的颜色（见下文）。

Highlight modified tabs

居中编辑器布局自动调整大小

当打开超过 1 个编辑器组时，居中布局视图现在将自动调整大小以达到最大宽度。这应该使居中布局更易于使用，并减少手动切换的需要。此行为由新设置 workbench.editor.centeredLayoutAutoResize 控制，默认情况下启用该设置。

面包屑中的符号顺序

有一个新设置控制面包屑选择器中符号的排序方式：breadcrumbs.symbolSortOrder。

允许的值为

  • position - 文件中的位置（默认）
  • name - 字母顺序
  • type - 符号类型顺序

下面的示例显示了按名称排序的面包屑符号列表

Breadcrumb picker ordered by name

面包屑和预览编辑器

当在面包屑导航中单击鼠标中键时，它们现在在新编辑器中打开，并且不重用预览编辑器。此行为现在与在资源管理器中单击鼠标中键文件相匹配。

即使显示按钮，通知也会自动隐藏

以前，如果通知包含按钮，VS Code 永远不会隐藏通知。这导致通知有可能堆积在右下角并覆盖编辑器的部分区域。在此版本中，即使通知显示按钮，也会在超时后隐藏。

有两个例外

  • 严重性为 error 的通知不会被隐藏，因为假设用户需要采取一些操作。
  • 来自 VS Code 的一些特定通知将保持打开状态。例如，在浏览 VS Code Marketplace 后，询问您是否要安装扩展的通知。

注意： 即使通知被隐藏，您始终可以从通知中心访问所有通知，方法是单击状态栏中的小铃铛图标或通过显示通知 (notifications.toggleList) 命令。

面板位置按钮到上下文菜单

为了保留水平空间并减少混乱，我们从面板标题区域中删除了切换面板位置按钮（移至右侧、移至底部）。该操作现在在面板标题区域上下文菜单中以及查看 > 外观 > 切换面板位置主菜单中可用。删除此按钮的另一个原因是，我们认为用户设置一次布局，通常不会来回切换。

Move panel

更新了每个文件类型的文件图标

在上一个版本中，我们为常见的 VS Code 文件类型添加了自定义图标。我们现在将这些图标添加到较小的视图中，以便它们将出现在列表视图中。

Updated file icons

设置编辑器“在其中修改”提示现在是一个链接

在设置编辑器中，当设置在当前选定范围（用户、工作区）以外的范围中配置时，我们会显示一个提示。另一个范围提示现在是一个链接，它会将您带到另一个范围中的设置。

modified in link

树形小部件性能

VS Code 树形小部件控件在 VS Code UI 中的许多地方使用，但在某些特定用例（“问题”面板、“大纲”视图）中达到了性能限制。我们一直在研究更快的虚拟树形小部件实现，它可以适应不同的性能级别与 API 便利性。您可以在此处阅读更多信息。

新的 ObjectTree 小部件现在正在“问题”面板中使用，我们已经看到了显着的改进。我们能够显着提高工作台可以处理的问题项数量，并提高某些操作（例如全部折叠）和高级筛选场景的速度。这些改进现在使得处理更大的集合大小成为可能。

工作台导航命令

添加了四个命令来改进工作台导航

  • workbench.action.nextSideBarView：转到侧边栏中的下一个视图。
  • workbench.action.previousSideBarView：转到侧边栏中的上一个视图。
  • workbench.action.nextPanelView：转到下一个面板。
  • workbench.action.previousPanelView：转到上一个面板。

默认情况下，这些命令没有键盘快捷键。

还添加了两个上下文键 sideBarFocus 和 panelFocus。这允许在不同的工作台区域为不同的命令使用相同的键盘绑定

[
  { "key": "cmd+]", "command": "workbench.action.nextEditor" },
  { "key": "cmd+[", "command": "workbench.action.previousEditor" },
  {
    "key": "cmd+]",
    "command": "workbench.action.nextSideBarView",
    "when": "sideBarFocus"
  },
  {
    "key": "cmd+[",
    "command": "workbench.action.previousSideBarView",
    "when": "sideBarFocus"
  },
  {
    "key": "cmd+]",
    "command": "workbench.action.nextPanelView",
    "when": "panelFocus"
  },
  {
    "key": "cmd+[",
    "command": "workbench.action.previousPanelView",
    "when": "panelFocus"
  }
]

workbench-navigation

显示视图组父级

打开视图命令（快速打开中的 view）现在显示每个视图组的父级，以更好地表示视图层次结构。例如，资源管理器组现在显示为侧边栏 / 资源管理器，终端组显示为面板 / 终端。

structured-view

编辑器

IntelliSense 中的文件和文件夹图标

IntelliSense 小部件现在根据您的文件图标主题显示文件完成的文件和文件夹图标。这提供了统一的外观，并帮助您快速识别不同的文件类型。

File Icons in IntelliSense

格式化选区

为了加快小的格式化操作，在没有编辑器选区的情况下使用格式化选区命令现在将格式化当前行。

显示错误代码

如果定义了错误代码，编辑器现在会显示问题的错误代码。错误代码显示在行尾的方括号中。

在下面，您可以看到 TypeScript 正在显示错误代码“2339”

error codes

集成终端

拆分终端可以继承工作目录

添加了一个设置 terminal.integrated.splitCwd，用于控制拆分终端时新终端的当前工作目录 (cwd)

  • workspaceRoot - 之前的行为；新的拆分终端将使用工作区根目录作为工作目录。在多根工作区中，可以选择要使用的根文件夹。
  • initial - 新的拆分终端将使用父终端启动时的工作目录。
  • inherited - 在 macOS 和 Linux 上，新的拆分终端将使用父终端的工作目录。在 Windows 上，此行为与 initial 相同。

Cmd+退格键删除到行首

在 macOS 上为 Cmd+退格键 添加了一个新的键盘绑定，它向终端发送 \u0015 (Ctrl+U)。在 bash 中，这会从光标处删除到行首，在 zsh 中，它会删除整行。

实验性缓冲区改进

新设置 terminal.integrated.experimentalBufferImpl 允许将终端存储其缓冲区的方式更改为基于 TypedArray/ArrayBuffer 的实现。如果您想选择加入，您可以预期整体性能会得到提高，包括减少内存使用和垃圾回收，以及终端吞吐量的整体增加。

{
  "terminal.integrated.experimentalBufferImpl": "TypedArray"
}

这仅仅是开始，我们预计在接下来的几个版本中吞吐量和内存使用率将得到进一步改进，然后将其设为默认实现。特别感谢来自 xterm.js 团队的 @jerch，他一直是这个 为期数月的项目背后的主要推动力。

任务

在执行任务之前清除终端

任务 presentation 配置中添加了一个新属性 clear。将 clear 属性设置为 true 以在运行任务之前清除终端。

调试

可折叠堆栈帧

有时，调试器中的调用堆栈包含用户不感兴趣的堆栈帧（外部代码、跳过的文件等...）。为了减少混乱并节省垂直空间，我们现在将这些不相关的堆栈帧呈现为折叠状态。

stack frames

改进的已加载脚本视图

在此里程碑中，我们更新了已加载脚本视图以支持文件图标，并添加了将相关资源显示为子元素的功能。调试扩展可以使用此功能来显示转译为脚本的源文件。

来自 Node.js 调试器的以下图片显示了 JavaScript 文件的 TypeScript 源代码（在源映射中可用）

loaded scripts view

请注意，相关资源功能需要调试扩展选择加入。在 10 月版中，只有 node-debug 对 Node.js 版本 < 8.0（又名“旧版”）具有对此功能的实验性支持。

多个调试控制台

当调试多个调试会话时，我们现在将它们的输出显示在不同的调试控制台中。这使得更容易区分哪个调试会话负责哪个输出和评估。

multiple debug consoles

启动调试时停止在入口点

对于 Node.js 调试，我们添加了一个新命令调试：启动调试并在入口点停止 (extension.node-debug.startWithStopOnEntry)。如果您想启动调试并在程序入口点立即停止，请使用此命令。默认键盘绑定是 F11。请注意，仅当您选择的启动配置类型为 node 时，此命令才可用。

Node 调试支持 console.log 样式

当调试 Node.js（或使用“Debugger for Chrome”扩展程序的 Chrome）时，您现在可以使用 %c 样式化来自 console.log 的消息，类似于 Chrome DevTools 支持的功能。支持的属性包括 color、background、font-weight: bold 和 text-decoration: underline。

console styles

断点小部件扩展到多行

断点小部件现在可以扩展到多行，使用 Shift+Enter 插入附加行，或直接粘贴多行条件或日志消息。这应该有助于编辑更复杂的条件和日志消息。

breakpoint widget

语言

TypeScript 3.1.4

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

Markdown 代码片段改进

内置的 Markdown 代码片段，例如链接和代码块的代码片段，现在默认使用当前选定的文本。这允许您创建键盘绑定，将当前选定的文本转换为链接或标题

{
  "key": "cmd+k",
  "command": "editor.action.insertSnippet",
  "when": "editorTextFocus",
  "args": {
    "langId": "markdown",
    "name": "Insert link"
  }
}

悬停消息中的 CSS 特异性

CSS 悬停现在会向您显示 CSS 特异性。

css-specificity

处理未知的 CSS 属性

使用 CSS 预处理器（如 PostCSS），您可能会使用在开发时编译为有效属性的无效属性。[css/less/scss].lint.validProperties 设置可防止 VS Code 将这些无效属性标记为错误。

改进的 CSS 零单位警告

CSS 现在会检查 零单位是否在 CSS 简写属性值中使用。例如，0px 现在将导致警告。

优雅地处理 JSON 模式加载错误

如果 VS Code 无法下载用于 IntelliSense 或错误检查 JSON 文件的 JSON 模式，则状态栏中将显示警告

json-schema-loading

过去，您会在编辑器中看到错误。

工程

继续探索 Electron 3.0

在此里程碑中，我们继续探索将 Electron 3.0.0 捆绑到 VS Code 中。这是一个主要的 Electron 版本，附带 Chrome 66 和 Node.js 10.x（与我们当前的 Chrome 61 和 Node.js 8.x 版本相比，这是一个重大飞跃）。我们计划在不久的将来将更新推送给我们的 Insiders 用户，以收集更多反馈。如果您有兴趣提供帮助，请务必安装 VS Code Insiders 版本。

核心 VS Code 的严格空值检查

在此里程碑中，我们还开始工作，以在核心 VS Code 源代码中启用 TypeScript 的 严格空值检查。严格的空值检查有助于捕获许多常见的编程错误，并使程序员的意图更加明确。我们已经看到了为 VS Code 的内置扩展使用严格空值检查的明显好处。

由于 VS Code 的 核心源代码 包含数千个文件，因此我们正在逐步采用严格的空值检查。我们首先对没有导入的文件进行严格的空值检查，现在正在迭代地在仅导入其他经过严格空值检查的文件的文件中启用严格的空值检查。这将一直持续到整个代码库都完成转换为止。

启用严格的空值检查是一项重大的工程工作，但我们认为在源代码和产品质量方面的回报将是值得的。您可以在此处跟踪我们的严格空值检查进度。

其他

低对比度菜单栏

如果您使用的是 Ubuntu 18.10 或 GTK 主题，该主题将浅色或深色上下文菜单与应用程序菜单栏的相反主题混合在一起，您可能会遇到难以阅读的低对比度菜单栏。

对此有两种可能的解决方法

  • 通过将设置 window.titleBarStyle 配置为 custom，尝试 VS Code 自定义标题栏样式。
  • 更改您的 GTK 主题。您可以通过安装 Gnome Tweaks 应用程序并使用以前的默认主题 Adwaita 来完成此操作。

有关此问题的信息，可以在问题 62593 中进行跟踪。

Electron 更新

在此版本中，我们从 Electron 2.0.9 更新到 2.0.12。

预览功能

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

引用视图

有一个新命令查找所有引用，它显示一个专用的侧边栏视图，显示引用搜索结果。这是对现有“速览”视图演示的补充，并提供了更稳定的引用列表。在上下文菜单中，选择查找所有引用 ()，引用将显示在单独的视图中，就像搜索结果一样。

References View

结果是稳定的，可以清除单个结果，如果您将该视图用作待办事项列表，这将非常棒。您可以使用 F4 和 ⇧F4 (Windows, Linux Shift+F4) 在结果之间导航，而无需将手从键盘上移开。

请告诉我们您的想法，我们将在下次更新中改进体验。

扩展创作

规范化的扩展示例

vscode-extension-samples 中的 VS Code 扩展示例 vscode-extension-samples 已更新以保持一致性。

每个扩展示例现在都包括

  • 统一的编码风格和结构。
  • 一个 README，其中包含简短动画，解释了示例的功能。
  • 每个示例中使用的 vscode API 或贡献点的列表。

捆绑扩展

捆绑的扩展加载速度更快。因此，我们创建了一个示例，展示如何 webpack 扩展。

开发扩展而无需发布者

为了简化初始扩展开发，从 Yeoman Extension Generator 模板中删除了 publisher 字段。对于没有 publisher 标识符的扩展，VS Code 现在使用 undefined_publisher 作为其发布者加载它们。但是，当尝试将扩展发布到 Marketplace 时，vsce 发布工具会警告您是否缺少有效的发布者。

活动终端 API

提供对活动终端访问权限的提议 API window.activeTerminal 和 window.onDidChangeActiveTerminal 现在是稳定的。

带有按钮的通知在超时后隐藏

如果您的扩展使用带有非模态选项和按钮的 showInformationMessage 或 showWarningMessage API，请注意这些通知现在会在一定的超时后隐藏。只有通过 showErrorMessage 触发且带有按钮的通知才会像以前一样保持打开状态。如果您必须从用户那里获得即时输入或需要突出显示消息，您仍然可以使用 modal: true 作为选项。这将弹出一个模态对话框，阻止用户在解除对话框之前执行任何操作。但是，我们不鼓励过度使用此选项，因为它会中断用户。

自定义视图：展开显示的元素

您现在可以使用 reveal API 中的 expand 选项展开元素以显示。它还支持通过传递级别数来递归展开子元素。

注意： 您最多只能展开到 3 个级别。

/**
 * Reveals the given element in the tree view.
 * If the tree view is not visible then the tree view is shown and element is revealed.
 *
 * By default revealed element is selected.
 * In order to not to select, set the option `select` to `false`.
 * In order to focus, set the option `focus` to `true`.
 * In order to expand the revealed element, set the option `expand` to `true`. To expand recursively set `expand` to the number of levels to expand.
 * **NOTE:** You can expand only to 3 levels maximum.
 *
 * **NOTE:** [TreeDataProvider](#_TreeDataProvider) is required to implement [getParent](#_TreeDataProvider.getParent) method to access this API.
 */
reveal(element: T, options?: { select?: boolean, focus?: boolean, expand?: boolean | number }): Thenable<void>;

新的主题颜色

有新的主题颜色

  • tab.activeModifiedBorder：活动组中已修改（脏）的活动选项卡顶部的边框。
  • tab.inactiveModifiedBorder：活动组中已修改（脏）的非活动选项卡顶部的边框。
  • tab.unfocusedActiveModifiedBorder：非焦点组中已修改（脏）的活动选项卡顶部的边框。
  • tab.unfocusedInactiveModifiedBorder：非焦点组中已修改（脏）的非活动选项卡顶部的边框。
  • editor.stackFrameHighlightBackground：编辑器中顶部调试堆栈帧突出显示的背景颜色。默认情况下，此颜色为黄色。
  • editor.focusedStackFrameHighlightBackground：编辑器中焦点调试堆栈帧突出显示的背景颜色。默认情况下，此颜色为绿色。

Git 扩展 API 添加

Git 扩展 API 已更新，以公开有关每个存储库的实际更改的详细信息。

此外，还公开了以下方法

使用 Azure Pipelines 进行扩展 CI

我们更新了关于如何为您的扩展设置持续集成解决方案 的文档，使用 Azure Pipelines。新的指南提供了一个配置，您可以使用该配置在 Windows、macOS 和 Linux 上同时运行扩展测试。

Azure Pipelines CI results

提议的扩展 API

每个里程碑都带有新的提议 API，扩展作者可以试用它们。与往常一样，我们渴望您的反馈。这是您试用提议 API 必须执行的操作

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

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

剪贴板 API

我们有一个提议的 API 来访问剪贴板。它遵循即将推出的浏览器 Clipboard API，目前允许读取和写入文本

export interface Clipboard {
  readText(): Thenable<string>;
  writeText(value: string): Thenable<void>;
}
export namespace env {
  const clipboard: Clipboard;
}

完成文本插入规则

有一个新的提议 API 来修改完成项的插入行为。默认情况下，多行完成项会“重新格式化”以匹配当前行的缩进。有时不需要此缩进，新的提议 API 允许完成项将其关闭。CompletionItemInsertTextRule 是一个位掩码，它具有完成项可以设置的 KeepWhitespace 规则。

自定义视图

全部折叠操作

您只需在创建 TreeView 时将 showCollapseAll 选项设置为 true，即可将全部折叠操作添加到您的视图中。

/**
 * Options for creating a [TreeView](#_TreeView]
 */
export interface TreeViewOptions<T> {
  /**
   * A data provider that provides tree data.
   */
  treeDataProvider: TreeDataProvider<T>;

  /**
   * Whether to show collapse all action or not.
   */
  showCollapseAll?: boolean;
}

namespace window {
  export function createTreeView<T>(
    viewId: string,
    options: TreeViewOptions<T>
  ): TreeView<T>;
}

VS Code 提供了全部折叠功能，并为所有选择加入的视图显示相同的图标和位置。

Collapse All

TreeItem 标签突出显示

您可以使用 highlights 选项提供范围来突出显示 TreeItem 标签。由于它是提议的 API，因此您必须使用 TreeItem2 来更新突出显示。

/**
 * Label describing the [Tree item](#_TreeItem)
 */
export interface TreeItemLabel {
  /**
   * A human-readable string describing the [Tree item](#_TreeItem).
   */
  label: string;

  /**
   * Ranges in the label to highlight. A range is defined as a tuple of two number where the
   * first is the inclusive start index and the second the exclusive end index
   */
  highlights?: [number, number][];
}

export class TreeItem2 extends TreeItem {
  /**
   * Label describing this item. When `falsy`, it is derived from [resourceUri](#_TreeItem.resourceUri).
   */
  label?: string | TreeItemLabel | /* for compilation */ any;

  /**
   * @param label Label describing this item
   * @param collapsibleState [TreeItemCollapsibleState](#_TreeItemCollapsibleState) of the tree item. Default is [TreeItemCollapsibleState.None](#_TreeItemCollapsibleState.None)
   */
  constructor(label: TreeItemLabel, collapsibleState?: TreeItemCollapsibleState);
}

Label highlights

隐藏源代码管理输入框

SourceControlInputBox 实例上有一个新的提议 API 属性，它将允许您隐藏源代码管理提供程序 UI 视图顶部的输入框。

export interface SourceControlInputBox {
  /**
   * Controls whether the input box is visible (default is  true`).
   */
  visible: boolean;
}

SignatureHelpContext

提议的 SignatureHelpContext 为 SignatureHelpProviders 提供了有关为什么请求签名帮助的更多信息

export interface SignatureHelpProvider {
  provideSignatureHelp(
    document: TextDocument,
    position: Position,
    token: CancellationToken,
    context: SignatureHelpContext
  ): ProviderResult<SignatureHelp>;
}

SignatureHelpContext 包括

  • 导致签名帮助触发的操作
  • 触发字符（如果有）
  • 这是重新触发吗？（签名帮助已在显示）
/**
 * Contains additional information about the context in which a
 * [signature help provider](#_SignatureHelpProvider.provideSignatureHelp) is triggered.
 */
export interface SignatureHelpContext {
  /**
   * Action that caused signature help to be requested.
   */
  readonly triggerReason: SignatureHelpTriggerReason;

  /**
   * Character that caused signature help to be requested.
   *
   * This is `undefined` when signature help is not triggered by typing, such as when invoking signature help
   * or when moving the cursor.
   */
  readonly triggerCharacter?: string;

  /**
   * Whether or not signature help was previously showing when triggered.
   *
   * Retriggers occur when the signature help is already active and can be caused by typing a trigger character
   * or by a cursor move.
   */
  readonly isRetrigger: boolean;
}

/**
 * How a [Signature provider](#_SignatureHelpProvider) was triggered
 */
export enum SignatureHelpTriggerReason {
  /**
   * Signature help was invoked manually by the user or by a command.
   */
  Invoke = 1,

  /**
   * Signature help was triggered by a trigger character.
   */
  TriggerCharacter = 2,

  /**
   * Signature help was triggered by the cursor moving or by the document content changing.
   */
  ContentChange = 3
}

此外，该提案允许使用一组 triggerCharacters 和一组不同的 retriggerCharacters 注册 SignatureHelpProvider

export interface SignatureHelpProviderMetadata {
  readonly triggerCharacters: ReadonlyArray<string>;
  readonly retriggerCharacters: ReadonlyArray<string>;
}

namespace languages {
  export function registerSignatureHelpProvider(
    selector: DocumentSelector,
    provider: SignatureHelpProvider,
    metadata: SignatureHelpProviderMetadata
  ): Disposable;
}

仅当签名帮助已在显示时，retriggerCharacters 才会导致调用签名帮助提供程序。

扩展贡献

我们的团队维护或贡献了许多 VS Code 扩展。本月最值得注意的是

Go

以下是当您在 Go 1.11 中使用新的 Go 模块 时，Go 扩展现在支持的一些关键功能

  • 代码导航（转到定义、签名帮助、悬停时显示符号信息）
  • 代码完成
  • 代码覆盖率
  • 代码诊断
  • 包相关命令，如 Go: 添加导入 和 Go: 浏览包

有关更多详细信息，请阅读关于 Visual Studio Code 中的 Go 模块支持的 wiki。

Go 扩展中的其他值得注意的功能包括

  • Sourcegraph 的语言服务器现在在 Windows 中也受支持。
  • 自动完成小部件现在显示建议符号的文档。按 ⌃Space (Windows, Linux Ctrl+Space) 展开/折叠自动完成小部件的详细信息部分。
  • 交叉编译时现在支持自动完成。当您尝试在 Go 1.11 中试用新的 WebAssembly 支持时，这尤其有用。
  • 带有 复制值、复制为表达式 和 添加到监视 选项的上下文菜单现在在“调试”视图的“变量”窗格中可用。
  • 可以选择仅在文件保存时检查当前文件。

TypeScript TSLint 插件

新的 TypeScript TSLint 插件 启用 TSLint 作为 TypeScript 语言服务插件。这些插件可以在任何使用 TypeScript 语言服务的编辑器中使用，包括 VS Code、Visual Studio、Atom 和 Sublime Text。

我们还发布了一个 扩展，它捆绑了 TypeScript TSLint 插件，因此您不必在工作区中配置插件。

GitHub Pull Requests

在此里程碑中，我们致力于改进 GitHub Pull Requests 扩展。该扩展现在支持编辑和删除评论，包括在编辑器内和描述页面上，并对尚未提交的评论具有更好的缓存。您可以在 此处阅读该扩展的完整发行说明。

新文档

部署 Python 教程

有两个新的 Python 教程，展示了如何使用 VS Code 部署 Python Web 应用程序。

调试配方

有新的 VS Code 调试 配方，用于 PHP、Python 和 Ruby on Rails。

值得注意的修复

  • 54214：即使构建失败，vscode 中的 startDebugging 方法仍然返回 true
  • 57289：设置 UI 应在重新加载时记住其搜索
  • 57321：当设置搜索未返回任何结果时，显示“清除搜索”和“清除过滤器”按钮
  • 59305: 在 .code-workspace 文件中显示“打开工作区”按钮
  • 59430: 无法再在 node internals 文件中设置断点
  • 61711: 所有断点都未经验证
  • 62085: debugAdapter 未收到 PauseRequest
  • 62346: 无法在调试会话初始化时取消会话
  • 62354: Node 10.12 之后的远程调试问题

感谢

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

贡献至 vscode

贡献至 vscode-eslint

贡献至 vscode-languageserver-node

贡献至 language-server-protocol

贡献至 vscode-html-languageservice

贡献至 vscode-css-languageservice

贡献至 vscode-json-languageservice

贡献至 debug-adapter-protocol

贡献至 vscode-debugadapter-node

贡献至 vscode-chrome-debug-core

  • @digeff
    • 我们适应最新版本的 Node.js，它使用 file:///，并且我们不为存在的文件发送 sourceRef PR #373
    • 修复未命中 NTVS 单元测试第一行 BP 的问题 PR #369
    • 修复 node 未命中网络路径中断点的问题 PR #368
  • @rdegelo
    • 改进调试控制台样式。添加下划线和背景支持 PR #374
    • 在调试控制台上添加了对基本颜色转义序列的支持 PR #367

贡献至 vscode-generator-code

贡献至 vscode-vsce

贡献至 vscode-extension-samples

贡献至 vscode-recipes

贡献至 inno-updater

贡献至 localization

Transifex VS Code 项目团队中大约有 1400 名成员，每月约有 100 名活跃贡献者。我们感谢您的贡献，无论是提供新的翻译、为翻译投票还是提出流程改进建议。

这是此版本贡献者的快照。有关包括贡献者姓名列表在内的项目详细信息，请访问项目站点 https://aka.ms/vscodeloc。

  • 波斯尼亚语: Dario Fuzinato。
  • 保加利亚语: Любомир Василев。
  • 加泰罗尼亚语: joanmiro pisa。
  • 捷克语: Vít Staniček, Kryštof Černý, Michal Franc。
  • 荷兰语: Gerald Versluis, Vincent Verbist。
  • 英语（英国）: Matthew John Cheetham, Alexander Ogilvie。
  • 芬兰语: Petri Niinimäki, Feetu Nyrhinen。
  • 法语: Antoine Griffard, Adrien Clerbois。
  • 德语: J.M. Rütter, Volkmar Rigo。
  • 希腊语: Dimitris Siakavelis, Christos Koutsiaris。
  • 印地语: Ashwini Gupta, Bimal ., Brahma Dev, Rahul Bhammarker。
  • 匈牙利语: Tar Dániel。
  • 简体中文: Joel Yang, pluwen, Zijian Zhou, Simon Chan。
  • 繁体中文: Duran Hsieh, Poy Chang, Alan Tsai, Kevin Yang, Winnie Lin。
  • 印尼语: Rizki A. Wibowo, Laurensius Dede Suhardiman, Fahmi Irsyad khairi, Wildan Mubarok, G-RiNe Project, Pratikto Ariestyadi, Joshua Siagian, William Tantiono, Herman Prawiro, Febrian Setianto (Feber), Angger Rafi Akbar, Joseph Aditya P G, Oka bRionZ, rodin。
  • 意大利语: Alessandro Alpi, Riccardo Cappello, Marco Dal Pino, Roberto Albano, Andrea Dottor, Luigi Bruno。
  • 日语: Shunya Tajima, Yuichi Nukiyama, Satoshi Kajiura, Yoshihisa Ozaki。
  • 卡纳达语: Sanjay !。
  • 韩语: Kyunghee Ko, Junseong Jang。
  • 立陶宛语: Martynas Jusys。
  • 马拉雅拉姆语: Ajith S Punalur, Anand Chalakkal Jose Mohan, Kiren Paul。
  • 挪威博克马尔语: Espen Klein Nilsen。
  • 波兰语: Artur, Andrzej Supermocny, Jan Bońkowski, Mateusz Wyczawski, Warchlak。
  • 葡萄牙语（巴西）: Rodrigo Crespi, Roberto Fonseca, Danilo Dantas, Thiago Aragão, Thiago Moreira de Souza Arrais, Atílio Dadalto, Marcelo Fernandes, Douglas Heydt, Robson Cassiano, Lucas Miranda, Thiago Custodio。
  • 葡萄牙语（葡萄牙）: Diogo Barros, António Santos, Antonio Lourenco。
  • 俄语: Ivan Kuzmenko, Roman Slauta, Michael Crane。
  • 西班牙语: José M. Aguilar, Matias Menich, Alberto Poblacion, Daniel J. Pérez Nieto, Andrés Reyes Galgani。
  • 泰米尔语: Nadar Solomon Sunder, Sarath Jasrin, Sakthi Raj, rajakvk, Avinash, ஜெகன் லங்கா சாமி துரை, Anand AV, Jeyanthinath Muthuram, Narayanan Singaram。
  • 泰卢固语: Rama Chandu, Hari Jujjavarapu, Sai Pavan Koundinya Upadhyayula。
  • 乌克兰语: Svitlana Galianova, Borys Lebeda, Dmytro Kyrychuk, Victor Kubrak, Volodymyr Holovka。
  • 乌尔都语: Haseeb Anwer, Saqib Ameen, Ahmad Awais。
  • 越南语: Thanh Phu, Daniel Nguyen, Nguyễn Nhật Tân, Hung Nguyen, Vuong。