尝试以扩展 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:变基分支... 命令,允许你使用 UI 对分支进行变基。

Git:递归克隆命令

使用Git:克隆(递归)命令,你现在可以递归克隆 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.insertSpaceAfterOpeningAndBeforeClosingEmptyBracestypescript.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 Pull Requests and Issues 扩展的开发工作仍在继续,该扩展允许你处理、创建和管理拉取请求和问题。

要了解所有新功能和更新,你可以查看该扩展 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 Beta 支持

VS Code 支持 TypeScript 4.1 Beta 版和每夜构建。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 备忘录中使用新引入的 setKeysForSync 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 符合受信任类型规范

我们继续努力使 VS Code 符合“受信任类型”规范。目标是防止基于 DOM 的跨站点脚本漏洞。你可以在 web.dev 受信任类型网站上了解有关受信任类型的更多信息,并在问题 #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 的贡献