尝试以扩展 VS Code 中的代理模式！

2018 年 8 月 (版本 1.27)

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

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

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

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

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

工作台

设置编辑器

在过去的几个月里，我们一直在开发用于编辑设置的 GUI。在 1.27 中，我们将其设置为默认设置编辑器。

Settings UI

您仍然可以通过使用命令首选项：打开用户设置 (JSON)或通过更改"workbench.settings.editor"设置来更改您的默认设置编辑器来访问 JSON 设置编辑器。

我们本月做出的一项改进是通过将设置值描述 (enumDescriptions) 移到自定义下拉控件中来清理 UI。

dropdown

已修改的设置现在会用蓝色线条表示，就像编辑器中已修改的行一样。齿轮图标会打开一个上下文菜单，其中包含一个将设置重置为其默认值的选项。

modified indicator and context menu

设置值现在会进行验证，并显示任何验证错误。

validation error

目录现在将在搜索期间保持可见，并过滤以仅显示具有匹配项的类别。您可以单击一个类别以将结果过滤到该类别下的设置。如果您希望在搜索期间隐藏目录，请将"workbench.settings.settingsSearchTocBehavior"设置为"hidden"。

settings search

当您在设置中搜索时，我们的 Bing 驱动的搜索服务仍然会提供它认为相关的结果。现在，该服务还会向您显示 Marketplace 中具有相关设置的扩展。您将在设置搜索结果底部看到一个按钮，显示匹配的扩展。单击后，扩展视图将打开并显示匹配的扩展。

extension settings

Windows 和 Linux 上的自定义标题栏和菜单

在过去的几次迭代中，我们一直在努力改进 Windows 和 Linux 上标题栏和菜单的外观、感觉和可用性。本次迭代中，我们正在删除预览标签，旨在尽快将其设为 Windows 上的默认体验。要启用此功能，您可以将设置"window.titleBarStyle"设置为"custom"。

Custom Title Bar and Menus

新体验比默认体验具有几个优势

  • 产品中可主题化的标题栏、菜单栏和上下文菜单。这意味着您的深色主题保持深色！
  • 菜单栏中更好的键盘导航。我们让使用键盘和菜单助记符在菜单之间切换变得更容易。
  • 侵入性更小的菜单栏。当将"window.menuBarVisibility"设置为"toggle"时，新体验更紧凑，干扰更小。
  • 更好的可访问性。已解决几个可访问性问题，以改善屏幕阅读器使用菜单的可用性。

由于我们希望将这种新体验设为 Windows 上的默认体验，因此我们鼓励您试用并向我们发送您的反馈，以便我们提供最佳体验。

面包屑改进

我们调整了新的面包屑栏，进行了各种改进，并修复了错误。

  • 聚焦的文档符号现在在编辑器中高亮显示。
  • 当运行聚焦命令（⇧⌘; (Windows、Linux Ctrl+Shift+;)）时，面包屑会自动启用。
  • 面包屑在主题方面表现更好。
  • 面包屑现在遵守文件排除配置。

Breadcrumbs Highlights

新终端菜单

任务菜单已重命名为终端，并为集成终端添加了更多条目。

Terminal Menu

平台特定键盘绑定

现在可以使用 keybinding 的when子句中的isLinux、isMac和isWindows为特定操作系统启用键盘快捷方式。

[
  {
    "key": "ctrl+o",
    "command": "workbench.action.files.openFolder",
    "when": "!isMac"
  },
  {
    "key": "cmd+o",
    "command": "workbench.action.files.openFolder",
    "when": "isMac"
  }
]

这使得在不同机器之间共享您的keybindings.json文件变得更加容易。

以新的原生选项卡打开窗口

一个新的仅限 macOS 的命令workbench.action.newWindowTab将窗口作为新的原生选项卡打开。newWindowTab没有默认的键盘绑定，需要启用window.nativeTabs设置。

文件在外部删除/重命名时不再关闭

我们将workbench.editor.closeOnFileDelete设置的默认值从true更改为false。这意味着已在 VS Code 之外（或通过 Git 等其他程序或集成终端中的命令）删除或重命名的文件将不再关闭作为编辑器选项卡打开的文件。相反，文件将指示它已从磁盘中删除，您可以保存文件以恢复它。

Deleted from Disk

注意：除非文件已修改，否则文件内容在重启后不会保留。

鼠标中键单击在新编辑器中打开文件

现在可以在 Explorer 视图中使用鼠标中键单击以在新编辑器中打开文件，而不是在预览模式下重用以前的编辑器。

辅助功能改进

我们已经修复了相当多的可访问性问题——主要是围绕键盘导航、屏幕阅读器支持和焦点。完整列表可以在此处找到。这是一项持续的工作，我们计划在 9 月继续进行。

改进的 Windows 后台更新

我们对自定义 Windows 后台更新程序进行了一些稳定性工作，以解决导致某些用户安装损坏的问题。这是一项持续的工作项，将在即将发布的版本中进行更多改进。

编辑器

自动关闭和包围字符

当输入某些括号（如{、[或(）时，根据编程语言，如果它们后面跟着通常不能开始表达式的特定字符（例如;:.,=}])>），它们将默认自动关闭。此行为可以通过editor.autoClosingBrackets设置进行自定义。同样，可以使用editor.autoClosingQuotes在输入引号（如"、'或`）时自定义自动关闭行为。

当文本被选中并且您输入其中一个字符时，选择将被括号或引号包围。现在可以通过新的editor.autoSurround设置单独调整此行为。

语言

CSS 导入的路径补全

现在支持 CSS、SCSS 和 Less @import的路径补全。SCSS 部分@import也已处理。

css-import

CSS 链接的跳转到定义

现在 CSS、SCSS 和 Less 中@import和url()链接支持跳转到定义。

css-definition

JSON

内置的 JSON 语言扩展现在支持新的JSON Schema Draft-07。

最有趣的添加是if、then、else关键字，以允许条件模式评估。

{
  "type": "integer",
  "minimum": 1,
  "maximum": 1000,
  "if": { "minimum": 100 },
  "then": { "multipleOf": 100 },
  "else": {
    "if": { "minimum": 10 },
    "then": { "multipleOf": 10 }
  }
}

if关键字表示，如果值模式的验证结果通过，则应用then模式，否则应用else模式。

HTML

HTML 格式化程序已更新到 1.8.1 版本的JS Beautifier。

这为"html.format.wrapAttributes"设置添加了一个新选项

  • "aligned-multiple"将在达到最大行长度时换行属性，并将所有换行行与第一个属性对齐。

aligned-multiple

TypeScript 3.0.3

VS Code 现在随附 TypeScript 3.0.3。此小版本修复了许多错误并提高了稳定性。您可以在此处阅读所有更改。

调试

已加载脚本视图现在可重用

一年多来，调试视图中的已加载脚本浏览器由 Node.js 调试扩展贡献，并且不适用于其他调试器。在此版本中，我们已将已加载脚本视图添加为内置调试器功能。所有具有“脚本”概念的调试扩展都将能够支持在动态更新视图中访问其脚本。

此外，我们还改进了旧版“已加载脚本”浏览器的一些缺点：

  • 现在，单子文件夹链已折叠为单个节点。这使得深入到深层但稀疏的文件夹层次结构变得更加容易。
  • 我们已经开始解决可访问性问题。

鼠标中键单击以删除断点

现在可以在断点视图中使用鼠标中键单击以轻松删除断点。

将“openDebug”的默认值更改为每次会话开始时打开

对于新用户，有时当您开始调试会话而调试视图没有每次自动打开时，可能会感到困惑。如果用户还不熟悉 UI，他们不知道要查找哪些关键字才能打开 UI。为了避免混淆，我们将debug.openDebug的默认值更改为openOnSessionStart，以便调试视图在每次会话开始时打开，而不仅仅是在第一次（这是以前的默认行为）。

扩展开发

扩展日志记录

作为activate函数的参数的ExtensionContext有一个新属性logPath。这是扩展可以存储日志文件的目录的绝对文件路径。该路径对于一个扩展是唯一的，不会被其他扩展重用。

语言服务器协议

新的语言服务器协议版本已发布，并包含用于 VS Code 的相应节点模块。

新版本支持

  • 服务器的代码操作种类公告，以允许客户端填充相应的菜单项。
  • 一个textDocument/prepareRename的实现。
  • 工作区编辑中文件操作（创建、重命名和删除）的支持。

vscode-languageclient：JSON 日志格式和日志流

以前，在使用vscode-languageclient构建语言服务器扩展时，您可以指定[langId].trace.server将LSP 日志发送到 VS Code 输出通道。

[langId].trace.server现在可以以机器可读的JSON 格式输出日志信息

"languageServerExample.trace.server": {
  "format": "json", // or "text"
  "verbosity": "verbose" // or "off" | "messages"
}

这开辟了有趣的用例，例如将 LSP 日志流式传输到LSP Inspector以可视化语言服务器的行为

lsp-streaming

您可以在Microsoft/language-server-protocol-inspector和lsp-log-streaming-sample中了解更多信息。

调试扩展：内置已加载脚本视图

“已加载脚本”浏览器现在是 VS Code 调试器的内置组件。要使用它，调试器扩展需要按以下方式更改其调试适配器：

  • 在initialize请求返回的Capabilities中添加一个值为true的supportsLoadedSourcesRequest能力。
  • 通过返回当前加载的源集来实现loadedSources请求。
  • 为新加载或卸载的源发送loadedSource事件。

新主题颜色

面包屑有一个新的主题颜色

  • breadcrumb.background：面包屑项的背景颜色。

设置编辑器有新的主题颜色

  • settings.dropdownListBorder：新下拉控件的边框颜色。
  • settings.modifiedItemIndicator：指示已修改设置的线条颜色。

Git 扩展 API

Git 扩展已开始公开更明确的 API。此 API 可用于任何其他扩展，以与用户工作区中打开的 Git 存储库进行交互。由于它仍处于初步阶段，我们将在即将发布的版本中不断改进此 API。

提议的扩展 API

每个里程碑都附带新的提议 API，扩展作者可以试用它们。一如既往，我们渴望您的反馈。以下是试用提议 API 所需的操作：

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

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

SCM：选定的源代码管理器

为了让扩展知道用户已选择哪些源代码管理实例以在 UI 中可见，SourceControl实例现在具有一个selected属性以及一个表示该状态的onDidChangeSelection事件。

export interface SourceControl {
  /**
   * Whether the source control is selected.
   */
  readonly selected: boolean;

  /**
   * An event signaling when the selection state changes.
   */
  readonly onDidChangeSelection: Event<boolean>;
}

评论提供者

本次迭代我们引入了评论概念，允许扩展在编辑器和新的评论面板中创建和管理对话。这使得扩展能够支持代码审查场景。

评论被组织成线程并与特定文档关联。

export enum CommentThreadCollapsibleState {
  Collapsed = 0,
  Expanded = 1
}

interface CommentThread {
  threadId: string;
  resource: Uri;
  range: Range;
  comments: Comment[];
  collapsibleState?: CommentThreadCollapsibleState;
}

interface Comment {
  commentId: string;
  body: MarkdownString;
  userName: string;
  gravatar: string;
  command?: Command;
}

要显示评论，扩展必须注册DocumentCommentProvider或WorkspaceCommentProvider。

export interface CommentThreadChangedEvent {
  readonly added: CommentThread[];
  readonly removed: CommentThread[];
  readonly changed: CommentThread[];
}

interface CommentInfo {
  threads: CommentThread[];
  commentingRanges?: Range[];
}

interface DocumentCommentProvider {
  provideDocumentComments(
    document: TextDocument,
    token: CancellationToken
  ): Promise<CommentInfo>;
  createNewCommentThread(
    document: TextDocument,
    range: Range,
    text: string,
    token: CancellationToken
  ): Promise<CommentThread>;
  replyToCommentThread(
    document: TextDocument,
    range: Range,
    commentThread: CommentThread,
    text: string,
    token: CancellationToken
  ): Promise<CommentThread>;
  onDidChangeCommentThreads: Event<CommentThreadChangedEvent>;
}

interface WorkspaceCommentProvider {
  provideWorkspaceComments(token: CancellationToken): Promise<CommentThread[]>;
  onDidChangeCommentThreads: Event<CommentThreadChangedEvent>;
}

使用DocumentCommentProvider，可以返回打开文档的评论。在提供评论时，扩展会指定文档上的当前线程以及文档支持添加新评论的范围。可以在文档中添加或回复评论。

A comment within an editor

当WorkspaceCommentProvider首次注册时，CommentsPanel变为可见并显示提供给它的所有评论。评论按评论线程和资源分组。当在面板中选择评论时，会运行评论command，因此扩展决定其行为。

Comments panel

预览功能

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

Electron 3.0 探索

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

工程

扩展与 webpack

我们现在正在使用webpack来打包扩展。它解锁了两项成就：（1）减少扩展的启动时间，因为要加载的文件更少，要解析的源代码也更少；（2）减少安装时间，因为需要提取和写入磁盘的文件更少。到目前为止，我们已将包大小减少了约 4000 个文件！

性能金丝雀

我们添加了一个测试工具来确保我们的启动性能不会退步。有一个新的脚本可以部署到专用机器上，以测试内部版本构建的性能。该脚本只是安装最新的构建并确保它在时间限制内启动。目前，我们从 Windows 开始，因为性能通常受防病毒软件更新的影响，但计划是在我们支持的所有平台上进行测试。

IPC 堆栈改进

我们改进了我们自有的 IPC 堆栈，以支持进程间的字节缓冲区消息。这使得某些场景得以实现，例如在我们的不同进程之间发送二进制数据而没有开销，以及允许我们优化 IPC 以提高性能。

值得注意的修复

  • 6363：保存时删除备用数据流
  • 25919：新命令强制将新窗口作为原生选项卡打开
  • 49021：保存时不要重置 WSL 权限元数据
  • 49403：在集成终端调试时自动附加导致问题
  • 55025：允许在扩展主机重启时继续调试
  • 56084：打开编辑器：重新审视组的顺序以基于可视顺序
  • 56691：路径中存在#时启动 vscode 错误
  • 57018：停止/重新启动调试器无法停止 babel-node

感谢

最后但同样重要的是，衷心感谢！以下帮助使 VS Code 变得更好的各位：

对 vscode 的贡献

对 vscode-vsce 的贡献

对 vscode-eslint 的贡献

对 language-server-protocol 的贡献

对 vscode-languageserver-node 的贡献

对 debug-adapter-protocol 的贡献

对 vscode-css-languageservice 的贡献

对 vscode-html-languageservice 的贡献

对 vscode-json-languageservice 的贡献

对 node-jsonc-parser 的贡献

对 vscode-generator-code 的贡献

对 localization 的贡献

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

以下是此版本的贡献者快照。有关项目（包括贡献者名单）的详细信息，请访问项目网站：https://aka.ms/vscodeloc。

  • 保加利亚语：Любомир Василев。
  • 克罗地亚语：Nikša Mihaica。
  • 丹麦语：Christoffer Bech。
  • 英语（英国）：Matthew John Cheetham、Swotboy2000。
  • 芬兰语：Petri Niinimäki、Feetu Nyrhinen、Jussi Palo。
  • 法语：Antoine Griffard、Guillaume Bauer、Smrman。
  • 德语：Carsten Siemens、Carsten Kneip、Jonas Droste、Markus Hatvan、Christian Studer、Peter Schneider、Jonas Keller、thefreshman89。
  • 匈牙利语：Tar Dániel、Bence László。
  • 简体中文：Joel Yang、王子实、Wang Dongcheng、pluwen、DongWei、Henry Chu、aimin guo、Chris Pan 潘冬冬、马子昂。
  • 繁体中文：Duran Hsieh、Winnie Lin、Poy Chang、Alan Tsai。
  • 印尼语：Wildan Mubarok、G-RiNe Project。
  • 意大利语：Luca Bruni、Alessandro Alpi、Andrea Dottor、Emanuele Curati、Riccardo Cappello、Gianluca Acerbis、Emilie Rollandin、Marco Dal Pino、Luigi Bruno、Lorthirk、Aldo Donetti。
  • 日语：Shunya Tajima、Satoshi Kajiura、Yuichi Nukiyama、Hiroyuki Mori、yoshioms。
  • 韩语：Kyunghee Ko、PaulNara、smallsnail、Kwangjin Hwang。
  • 立陶宛语：Tomas Cimermonas。
  • 波兰语：Artur、hawkeye116477、Patryk Brejdak、Mateusz Gazdziak、Robert Skórski、Sebastian Baran。
  • 葡萄牙语（巴西）：Roberto Fonseca、Bruno Sonnino、Marcelo Fernandes、Lucas Miranda、João Mesquita、Danilo Dantas、Rodrigo Crespi、Arthur Bruel、Thiago Moreira de Souza Arrais、Otacilio Saraiva Maia Neto、Loiane Groner、Fabio Correia。
  • 葡萄牙语（葡萄牙）：Richard Nunes、Daniel Correia、Tiago Costa。
  • 罗马尼亚语：Bogdan Mateescu、Szauka。
  • 俄语：Roman Slauta、Ivan Kuzmenko。
  • 西班牙语：Alejandro Medina、José M. Aguilar、Roberto Fonseca、Javier Moreno、Andy Gonzalez、Alberto Poblacion、Nancy Todd、Antonio Sanmartín。
  • 泰卢固语：Hari Jujjavarapu、Sridhar L。