现已可用！阅读有关 11 月的新功能和修复的说明。

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 月版。此版本中有许多重大更新，我们希望您会喜欢，其中一些主要亮点包括

如果您想在线阅读这些发行说明，请转到 更新，网址为 code.visualstudio.com。
您还可以观看 Cloud Developer Advocate Brian Clark 制作的关于此 1.29 版本亮点视频。

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

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

Insider 版本：想尽快看到新功能吗？您可以下载每日 Insider 版本，并在可用时立即尝试最新的更新。有关最新的 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+Backspace 删除到行首

在 macOS 上为 Cmd+Backspace 添加了一个新的快捷键绑定，它会向终端发送 \u0015 (Ctrl+U)。在 bash 中，这会将光标位置到行首的内容删除，在 zsh 中，它会删除整行。

实验性缓冲区改进

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

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

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

任务

在执行任务前清空终端

一个新的属性 clear 已添加到任务 presentation 配置中。将 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 来实现。

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

Electron 更新

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

预览功能

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

引用视图

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

References View

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

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

扩展创作

规范化的扩展示例

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

现在，每个扩展示例都包含

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

捆绑扩展

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

开发扩展而无需发布者

为了简化初始扩展开发，publisher 字段已从 Yeoman 扩展生成器 模板中删除。对于没有 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。它遵循即将推出的浏览器 剪贴板 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 支持 时，这特别有用。
  • 调试视图的“变量”窗格中现在提供带有 复制值、复制为表达式 和 添加到监视 选项的上下文菜单。
  • 在文件保存时仅对当前文件进行 lint 的选项。

TypeScript TSLint 插件

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

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

GitHub 拉取请求

在这个里程碑中，我们改进了 GitHub 拉取请求 扩展。该扩展现在支持在编辑器内和描述页面上编辑和删除评论，并且为尚未提交的评论提供了更好的缓存。您可以在 此处 阅读扩展的完整发行说明。

新文档

部署 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 内部文件中中断
  • 61711：所有断点都未验证
  • 62085：调试适配器未收到 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
    • 我们适应使用 file:/// 的最新版本 Node.js，并且我们不发送现有文件的 sourceRef PR #373
    • 修复在 NTVS 单元测试的第一行未命中断点的问题 PR #369
    • 修复节点未在网络路径中命中断点的问题 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。