在 VS Code 中尝试！

2020 年 10 月 (版本 1.51)

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

下载：Windows：x64 Arm64 | Mac：Intel | Linux：deb rpm tarball Arm snap

欢迎阅读 Visual Studio Code 2020 年 10 月版本。正如在10 月迭代计划中宣布的那样，我们专注于整理 GitHub 问题和拉取请求，这在我们的问题整理指南中有所记载。

我们还与 GitHub 的合作伙伴在 GitHub Codespaces 上合作，这项工作最终比最初预期的更为复杂。为此，我们将在 11 月迭代的一部分时间里继续进行整理工作。

在此整理里程碑期间，我们还解决了多项功能请求和社区拉取请求。请继续阅读以了解新功能和设置。

工作台

更显眼的固定选项卡

固定选项卡现在将始终显示其固定图标，即使在非活动状态下也是如此，以便更容易识别。如果编辑器既已固定又包含未保存的更改，则图标会同时反映这两种状态。

Inactive pinned tabs showing pin icons

扩展树使用自定义悬停

现在，扩展树视图不再使用原生工具提示，而是使用自定义悬停，这在跨平台方面保持一致，并更好地适应整体用户体验。

Custom tree hover

不同步安装扩展

现在，在启用设置同步的情况下，你可以在不同步扩展的情况下安装它。

Install extension without syncing

主题：GitHub Light

从资源管理器安装扩展

VS Code 现在支持从资源管理器安装 VSIX 扩展文件，只需右键单击 VSIX 文件并选择上下文菜单项 安装扩展 VSIX。

输入失焦命令

现在可以使用新的内部命令 workbench.action.blur，它会从任何可聚焦的输入框中移除焦点。你可以在键盘快捷方式首选项中为此命令分配键盘快捷方式。

集成终端

本地回显

传统上，在终端中进行修改需要将信息发送到终端进程，然后进行处理并返回到 VS Code 才能生效。当连接到 SSH 服务器或 Codespace 的网络状况不佳或距离较远时，这可能会很慢。

此版本为终端添加了“本地回显”模式，它尝试预测本地进行的修改和光标移动，并在 UI 中显示它们，而无需往返服务器。默认情况下，预测字符显示为“变暗”

Gif showing typing with 250ms latency where characters entered immediately are dimmed

你可以使用以下两个设置来配置此功能

  • terminal.integrated.localEchoLatencyThreshold 配置了检测到的延迟阈值（毫秒），达到此阈值时本地回显将激活。可以将其设置为 0 以始终开启此功能，或设置为 -1 以禁用它。默认为 30。
  • terminal.integrated.localEchoStyle 配置了本地字符的样式或颜色，默认为 dim（变暗）。

IntelliSense

可调整大小的建议

在此里程碑中，我们对建议 UI 进行了多项改进。首先也是最重要的是，它现在可以调整大小。拖动侧边或角落即可调整控件的大小。

Resizable Suggestions control

主题：GitHub Light，字体：FiraCode

建议列表的大小将在会话之间保存和恢复。详细信息窗格的大小仅按会话保存，因为该大小通常更具可变性。此外，editor.suggest.maxVisibleSuggestions 设置已过时。

建议的状态栏

建议控件现在也可以在窗口底部显示自己的状态栏。使用 editor.suggest.showStatusBar 设置启用它。它使切换详细信息更简单，并显示完成项是否支持插入、替换或两者。

Suggestions Status Bar

主题：GitHub Light，字体：FiraCode

在上面的示例中，选择“插入”将得到 Math.floorceil，选择“替换”将得到 Math.floor。

新的 editor.suggest.insertMode 设置允许你配置是偏好插入还是替换。当一个建议同时支持两者时，你的偏好将成为默认值。

移动光标以选择建议

最后但同样重要的是，现在可以在显示建议时移动光标。例如，你可以在单词末尾触发建议，向左移动以查看更多建议，然后使用替换来覆盖该单词。

Moving cursor while suggestions are showing

主题：GitHub Light

Emmet

Emmet 中的自定义片段已回归。此外，现在保存片段文件或更新 emmet.extensionsPath 设置时，片段会自动刷新。

Emmet custom snippets working again

源代码管理

源代码管理输入框保存提交消息历史

这解决了浏览 SCM 提交历史的功能请求。按 ↑ (Windows、Linux Up) 和 ↓ (Windows、Linux Down) 可分别显示上一个和下一个提交。要直接移动到输入框的第一个和最后一个位置，请按住 Alt 键并配合相应的箭头键。

After typing a message in the SCM input box, then staging and committing changes, pressing the up arrow reveals the message that was just committed

Git：子菜单中的标签命令

标签相关的 Git 命令已添加到 Git 的 ... 菜单中。

Git tags submenu

Git：变基命令

已添加新的 Git: Rebase branch... 命令，允许你使用 UI 对分支进行变基。

Git：递归克隆命令

使用 Git: Clone (Recursive) 命令，你现在可以递归克隆 Git 仓库，包括其嵌套的 Git 子模块。

时间线：表情符号短代码渲染

我们现在在时间线视图中渲染表情符号短代码，例如 :smile:。

Timeline view with emoji

语言

Markdown 智能选择

使用以下新命令在 Markdown 文档中展开和收缩选区：

  • 展开：⌃⇧⌘→ (Windows、Linux Shift+Alt+Right)
  • 收缩：⌃⇧⌘← (Windows、Linux Shift+Alt+Left)

选择适用于以下内容，并遵循传统的层次结构模式：

  • 标题
  • 列表
  • 块引用
  • 围栏代码块
  • HTML 代码块
  • 段落

Smart select within a Markdown document expands from a block element, to the block element containing it, to the rest of the content under a header, to the header itself

JavaScript 和 TypeScript 的空大括号格式化选项

新的格式化配置选项 javascript.format.insertSpaceAfterOpeningAndBeforeClosingEmptyBraces 和 typescript.format.insertSpaceAfterOpeningAndBeforeClosingEmptyBraces 控制是否在空大括号之间插入空格。这些设置的默认值为 true。例如，对于 JavaScript 代码：

class Foo {
    doFoo() { }
}

将 "javascript.format.insertSpaceAfterOpeningAndBeforeClosingEmptyBraces": false 设置并格式化代码后，结果为：

class Foo {
    doFoo() {} // Notice that the space has been removed
}

浏览器支持

下载文件夹 (Edge, Chrome)

利用新的 文件系统访问 API，在浏览器中运行的 VS Code 现在可以提供从文件资源管理器下载文件夹的操作，将所有文件和文件夹下载到磁盘。

Download folder

注意：这需要最新版本的 Microsoft Edge 或 Google Chrome。

打开工作区通知

如果你打开一个顶层包含 .code-workspace 文件的文件夹，你现在会看到一个通知，询问你是否要打开它。这在桌面版 VS Code 中一直如此，现在在浏览器中也适用。

Open workspace notification

防止意外关闭

添加了一个新设置 window.confirmBeforeClose，用于在关闭或离开工作台之前显示确认对话框。

可能的值有：

  • keyboardOnly：仅当你使用键盘快捷方式关闭时（例如，⌘W (Windows、Linux Alt+F4)）才会显示确认。 (默认)
  • always：始终显示确认对话框，即使你通过鼠标手势关闭。
  • never：从不显示确认。

Close confirmation dialog

注意：此设置可能无法覆盖所有情况。浏览器仍可能决定不经确认就关闭标签页或窗口。

对扩展的贡献

GitHub 拉取请求和问题

GitHub 拉取请求和问题扩展的工作仍在继续，该扩展允许你处理、创建和管理拉取请求和问题。

要了解所有新功能和更新，你可以查看扩展 0.21.0 版本的完整更新日志。

远程开发

远程开发扩展的工作仍在继续，它允许你使用容器、远程机器或 适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。

1.51 版本的功能亮点包括：

  • 能够持久化/重新连接到终端会话。
  • 改进的端口转发体验。

你可以在远程开发发布说明中了解新的扩展功能和错误修复。

预览功能

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

设置同步

设置同步现在会同步扩展的全局状态。扩展将必须使用新引入的 setKeysForSync API 提供要同步的状态。

记住代理凭据

我们正在彻底改进当网络连接需要代理身份验证时显示的登录对话框。一个新的设置 window.enableExperimentalProxyLoginDialog: true 将启用这种新体验，我们计划在未来的版本中将其设为默认值。

Proxy Login

主题：GitHub Light

对话框将出现在 VS Code 窗口内，并提供一种记住凭据的方式，这样你每次启动 VS Code 时就不必提供它们。凭据将存储在操作系统标准凭据存储中（macOS 上的钥匙串、Windows 上的 Windows 凭据管理器以及 Linux 上的 GNOME 密钥环）。

我们仍然只在每个会话中显示此对话框一次，但将来可能会重新考虑此决定。如果选择记住的凭据无效，你将再次看到该对话框。再次提供凭据允许你更改它们。

请启用此选项，如果出现任何不符合预期的情况，请通过我们的问题跟踪器告知我们。

TypeScript 4.1 测试版支持

VS Code 支持 TypeScript 4.1 测试版和每夜构建。4.1 更新带来了一些新的 TypeScript 语言特性，例如支持递归条件类型，以及工具改进。其中一个重点是初步支持 JSDoc 注释中的 @see 标签。

要开始使用 TypeScript 4.1 每夜构建，只需安装 TypeScript Nightly 扩展。请分享反馈，如果在使用 TypeScript 4.1 时遇到任何错误，请告知我们。

扩展创作

更新的扩展示例

我们已更新了一些扩展示例，以包含与我们的颜色主题令牌关联的 VS Code 默认样式。这意味着常见元素（文本、按钮、输入框）将可主题化并与产品中的默认样式匹配。以下是包含此功能的扩展：

Webview style samples

树中的 Codicon 颜色

随着 ThemeIcon 颜色 API 的最终确定，扩展作者可以在自定义树视图中对 codicon 使用主题颜色。

Tree view with icon colors

同步全局状态

扩展现在可以通过在 globalState memento 中使用新引入的 setKeysForSync API 来同步其全局状态，该 API 提供在启用设置同步时应同步的键值。

/**
 * Set the keys whose values should be synchronized across devices when synchronizing user-data
 * like configuration, extensions, and mementos.
 *
 * Note that this function defines the whole set of keys whose values are synchronized:
 *  - calling it with an empty array stops synchronization for this memento
 *  - calling it with a non-empty array replaces all keys whose values are synchronized
 *
 * For any given set of keys this function needs to be called only once but there is no harm in
 * repeatedly calling it.
 *
 * @param keys The set of keys whose values are synced.
 */
setKeysForSync(keys: string[]): void;

评论线程回复按钮可见性

评论扩展现在可以通过新的属性 CommentThread#canReply 控制评论线程中回复按钮的可见性。当它设置为 false 时，用户将不会在评论线程中看到回复按钮或评论框。

提议的扩展 API

每个里程碑都会带来新的提议 API，扩展作者可以尝试使用它们。一如既往，我们期待你的反馈。以下是尝试提议 API 的步骤：

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

你不能发布使用提议 API 的扩展。下一个版本中可能会有破坏性更改，我们绝不希望破坏现有扩展。

折叠范围提供者更改事件

折叠范围提供者可以使用 onDidChangeFoldingRanges 事件向编辑器发出信号，通知折叠范围需要更新。

欲了解更多详情并提供反馈，请使用问题 #108929。

密码 API

作为身份验证提供者持续工作的一部分，我们引入了用于存储和检索敏感信息的 API。在内部，这充当了 VS Code 用于存储密钥的 keytar 库的包装器。

/**
 * Retrieve a password that was stored with key. Returns undefined if there
 * is no password matching that key.
 * @param key The key the password was stored under.
 */
export function getPassword(key: string): Thenable<string | undefined>;

/**
 * Store a password under a given key.
 * @param key The key to store the password under
 * @param value The password
 */
export function setPassword(key: string, value: string): Thenable<void>;

/**
 * Remove a password from storage.
 * @param key The key the password was stored under.
 */
export function deletePassword(key: string): Thenable<void>;

/**
 * Fires when a password is set or deleted.
 */
export const onDidChangePassword: Event<void>;

工程

使 VS Code 符合 Trusted Types 规范

我们继续努力使 VS Code 符合“Trusted Types”规范。目标是防止基于 DOM 的跨站脚本漏洞。你可以在 web.dev 的Trusted Types 站点上了解有关 Trusted Types 的更多信息，并通过问题 #103699关注我们的进展。

文档

入门

我们正在专注于如何让编辑器入门更简单。我们在网站上创建了一个新的“学习编程”登录页，其中包含编程包和面向编程新手的新内容。我们还在网站 code.visualstudio.com/learn 上创建了新的适合学生的视频和资源。

Learn to code

新命令

键 命令 命令 ID
聚焦左侧编辑器组（不换行） workbench.action.focusLeftGroupWithoutWrap
聚焦右侧编辑器组（不换行） workbench.action.focusRightGroupWithoutWrap
聚焦上方编辑器组（不换行） workbench.action.focusAboveGroupWithoutWrap
聚焦下方编辑器组（不换行） workbench.action.focusBelowGroupWithoutWrap
聚焦活动栏 workbench.action.focusActivityBar

值得注意的修复

  • 43819：Windows：删除包含正在使用的文件的文件夹时，不显示错误消息
  • 71315：删除文件后应保持行焦点
  • 96522：多根工作区中启动配置的用户输入变量无效
  • 100255：移动文件时应直接加载其之前的内容模型
  • 108578：v1.50 中带有 onDebugDynamicConfigurations 的扩展在启动时被急切激活
  • 109088：为文件夹发送 vscode.workspace.onWillCreateFiles/onDidCreateFiles 事件
  • 109226：调试悬停在展开/折叠时移动

感谢

最后但同样重要的是，衷心感谢本月为 VS Code 做出贡献的以下人员：

对我们问题跟踪的贡献

对 vscode 的贡献

对 vscode-json-languageservice 的贡献

对 vscode-html-languageservice 的贡献

对 vscode-css-languageservice 的贡献

对 vscode-eslint 的贡献

对 language-server-protocol 的贡献

对 vscode-emmet-helper 的贡献

对 lsif-node 的贡献

对 debug-adapter-protocol 的贡献

对 vscode-vsce 的贡献

对 vscode-js-debug 的贡献