尝试以扩展 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 月版。此版本包含许多重要更新,我们希望您会喜欢,其中一些主要亮点包括:

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

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

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

内测版:想尽快看到新功能?您可以下载每晚的内测版构建,并在最新更新可用时立即尝试。有关 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

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:转到上一个面板。

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

还添加了两个上下文键 sideBarFocuspanelFocus。这允许在不同的工作台区域中使用相同的键绑定来执行不同的命令

[
  { "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,他一直是这项为期数月项目的主要推动力。

任务

在执行任务前清除终端

任务 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 支持的功能。支持的属性包括 colorbackgroundfont-weight: boldtext-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 属性

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

改进的 CSS 零单位警告

CSS 现在会对 CSS 简写属性值中使用的零单位进行检查。例如,0px 现在将导致警告。

JSON Schema 加载错误的优雅处理

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

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 相比,这是一个重大飞跃)。我们计划在不久的将来向我们的内测用户推送此更新,以收集更多反馈。如果您有兴趣提供帮助,请务必安装 VS Code 内测版

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 扩展示例已更新以保持一致性。

每个扩展示例现在都包括:

  • 统一的编码风格和结构。
  • 一个解释样本功能的 README,附带短动画。
  • 列出每个示例中使用的 vscode API 或贡献点。

打包扩展

打包的扩展加载速度更快。因此,我们创建了一个示例,展示如何打包扩展

无需发布者即可开发扩展

为了简化初始扩展开发,publisher 字段已从 Yeoman 扩展生成器模板中移除。对于没有 publisher 标识符的扩展,VS Code 现在会将其发布者设置为 undefined_publisher 加载。但是,如果您尝试将扩展发布到 Marketplace 但缺少有效发布者,vsce 发布工具将发出警告。

活动终端 API

提供对活动终端访问的提议 API window.activeTerminalwindow.onDidChangeActiveTerminal 现已稳定。

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

如果您的扩展正在使用 showInformationMessageshowWarningMessage 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

提议的 SignatureHelpContextSignatureHelpProviders 提供了关于请求签名帮助原因的额外信息

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 拉取请求

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

新文档

部署 Python 教程

新增了两个 Python 教程,演示如何使用 VS Code 部署 Python Web 应用程序。

调试配方

新增了适用于 PHPPythonRuby on Rails 的 VS Code 调试配方

值得注意的修复

  • 54214: vscode 中的 startDebugging 方法即使构建失败也返回 true
  • 57289: 设置 UI 重新加载后应记住其搜索
  • 57321: 当设置搜索没有结果时显示“清除搜索”和“清除过滤器”按钮
  • 59305: 在 .code-workspace 文件中显示“打开工作区”按钮
  • 59430: 无法再在 Node 内部文件中设置断点
  • 61711: 所有断点均未验证
  • 62085: PauseRequest 未被 debugAdapter 接收
  • 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 单元测试第一行未命中断点的问题 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。