🚀 在 VS Code 中

2023 年 2 月(版本 1.76)

更新 1.76.1:此更新解决了以下问题

更新 1.76.2:此更新解决了以下问题

下载:Windows:x64 Arm64 | Mac:通用 Intel Silicon | Linux:deb rpm tarball Arm snap


欢迎使用 Visual Studio Code 2023 年 2 月版。此版本包含许多更新,我们希望您会喜欢,其中一些主要亮点包括

如果您想在线阅读这些发行说明,请访问 更新,网址为 code.visualstudio.com

Insiders: 想尽快试用新功能吗?您可以下载每晚构建的 Insiders 版本,并尽快试用最新的更新。

辅助功能

终端命令失败音频提示

当命令在具有 shell 集成的终端中以非零代码退出时,有视觉的用户可以快速浏览命令装饰,以快速了解是否存在故障。为了向屏幕阅读器用户传达失败信息,VS Code 现在播放 audioCues.terminalCommandFailed 音频提示。

您可以通过滚动浏览帮助:列出音频提示下拉列表来收听可用的音频提示声音。

List Audio Cues dropdown with Terminal Command Failed cue selected

改进的错误音频提示响应速度

audioCues.lineHasError 音频提示现在在字符导航期间播放,以便屏幕阅读器用户可以更好地了解编辑器中错误的位置。

终端辅助功能缓冲区改进

上次迭代,我们引入了终端辅助功能缓冲区,该缓冲区为屏幕阅读器用户提供了通过终端:聚焦辅助功能缓冲区命令访问终端内容的功能。

在此迭代中,我们通过添加选择和链接支持,使其成为只读,并使用 shell 集成洞察力将输出限制为仅重要的终端内容 - 运行的命令、退出代码(如果有)和输出来改进了辅助功能缓冲区。我们计划在下一次迭代中添加此功能的配置。

上下文特定的 Tab 焦点模式

切换 Tab 键移动焦点命令对于确定工作台或编辑器/终端是否接收 Tab 键输入非常有用。

新的 editor.tabFocusMode 设置允许用户设置默认行为。当值设置为 true 时,工作台接收 Tab 键输入,而不是编辑器或终端。

Windows 上屏幕阅读器 shell 集成支持

当在 Windows 上检测到屏幕阅读器时,以前禁用了 Shell 集成,原因是 PowerShell 在此上下文中存在问题。我们已确定在大多数情况下这不再是问题,因此已启用它。

终端辅助功能帮助添加

与屏幕阅读器社区的讨论促成了对终端辅助功能帮助对话框()的添加,例如提及创建新终端(使用配置文件)首选项:打开辅助功能设置命令。

配置文件

配置文件,在上个里程碑发布到稳定版,让您可以根据当前的工作流程和项目快速切换 VS Code 配置。您可以保存一组自定义设置,例如设置、扩展和键盘快捷键,在您的机器之间同步它们,并轻松地与同事共享它们。

配置文件徽章

VS Code 现在通过在管理活动栏图标上显示配置文件名称的前两个字母作为配置文件徽章来指示当前的自定义配置文件。

Two profile badges showing the first two letters of the profiles

主题可以通过配置两种新的主题颜色来自定义配置文件徽章的背景色和前景色

  • profileBadge.background
  • profileBadge.foreground

切换配置文件

您现在可以使用命令面板中的配置文件:切换配置文件命令(⇧⌘P (Windows、Linux Ctrl+Shift+P))快速切换配置文件,该命令面板会显示一个下拉列表,其中列出了您可用的配置文件。

Switch Profile command dropdown listing available profiles

远程工作区中的配置文件

您现在可以创建和自定义包含远程扩展的配置文件,并在 远程开发 工作区中在它们之间切换。

下面两个不同的配置文件(“文档编写”和“代码”)在两个 Remote - SSH 实例中处于活动状态。

Profiles active in two Remote - SSH instances

配置文件文档

如果您想了解有关配置文件以及它们在何时有用的场景的更多信息,请查看新的 Visual Studio Code 中的配置文件主题。本文详细介绍了如何创建、修改、共享和重用配置文件。

工作台

可移动的资源管理器视图

VS Code 中的大多数视图和视图容器都是可移动的,除了少数内置视图和视图容器。在此版本中,资源管理器视图容器(⇧⌘E (Windows、Linux Ctrl+Shift+E))现在是可移动的,可以放置到辅助侧边栏或底部面板中,以进一步自定义工作台。

下面,文件资源管理器视图已移动到面板区域。

File Explorer view moved to the panel area

如果您想将所有视图重置为默认布局,可以从命令面板运行视图:重置视图位置

固定宽度居中布局

视图:切换居中布局命令 (workbench.action.toggleCenteredLayout) 现在具有固定宽度布局选项。此选项通过新的 workbench.editor.centeredLayoutFixedWidth 设置启用。启用并激活居中布局后,编辑器将居中,并尝试在窗口和面板调整大小时保持其宽度。

多个快速差异

随着建议的 多个快速差异 API 的引入,多个扩展可以提供快速差异。当文件中存在多个快速差异时,您现在将看到一个下拉列表,用于选择要查看的差异基准

Multiple quick diffs and diff base dropdown

评论

评论视图有一个新的全部展开命令,与现有的全部折叠命令一起使用。未解决评论的装订线图标现在与评论视图中使用的图标相同。

配置默认日志级别

您现在可以从开发人员:设置日志级别...命令配置 VS Code 或扩展的默认日志级别。这会在重启后持久保存,并在机器之间同步。

Default log level dropdown with several extensions listed

选择扩展程序会显示与默认日志级别相同的日志级别下拉列表。

扩展编辑器中已验证的发布者域

扩展编辑器现在在已验证的指示器旁边显示已验证的发布者域。在下面,prettier.io 域显示在已验证徽章的右侧。

Prettier extension in the extension editor displaying verified publisher domain prettier.io

编辑器

JSONC 文档排序

现在可以按键对 JSONC(带有注释的 JSON 文档)文件进行排序。要使用此功能,请从命令面板中选择 JSON:排序文档

用于匹配和着色的独立括号对

在此迭代中,我们更改了同时配置 editor.language.bracketseditor.language.colorizedBracketPairs 时的行为。之前,设置 editor.language.colorizedBracketPairs 会覆盖用于括号匹配的 editor.language.brackets(因为两者都使用相同的 括号对树)。现在,括号匹配使用两个设置的并集,但只有在 editor.language.colorizedBracketPairs 中配置的括号才会被着色。

源代码管理

Git 提交语法高亮

VS Code 采用了新的 Git 语法,该语法为 Git 提交消息文件提供语法高亮。新语法更好地支持英语以外的语言。

Git 和 GitHub 文档

无论您是源代码管理新手还是经验丰富的 Git 用户,您都可以在我们文档的 源代码管理 部分了解有关 VS Code Git 集成的更多信息。文章包括

笔记本

内核选择器默认模式:MRU

内核选择器现在默认显示最近使用过的 (MRU) 内核。这与以前的行为有所不同,以前的行为是显示所有可用的内核。您仍然可以通过辅助选择器选择另一个内核...查看所有内核,当您安装了最新的 JupyterPython 扩展时,它将按其来源(例如:Jupyter 内核、Python 环境等)对内核进行分组。

Notebook kernel picker with MRU list and using the Select Another Kernel option

笔记本渲染器性能诊断

运行笔记本单元时,某些笔记本输出渲染器可能需要很长时间才能渲染。为了帮助识别这些渲染器,我们在笔记本单元状态栏中的悬停中添加了诊断信息。此视图显示每个渲染器的执行时间以及总执行时间。此外,悬停中的链接将打开问题报告器,其中预先填写了渲染器的名称和执行时间,以便您可以轻松地提交问题(如果您发现渲染器执行时间过长)。

Image showing the cell Status bar hover with renderer execution times

内置错误渲染器现在支持指向文件和行号的链接。这允许您单击错误消息中的文件路径,并在编辑器中打开该文件。

Jupyter 扩展的错误渲染器已被弃用,转而使用内置错误渲染器。

Notebook built-in error renderer

语言

需要链接到另一个 Markdown 文档中的标题,但不记得或不想键入完整的文件路径?尝试使用工作区标题补全!首先,只需在 Markdown 链接中键入 ##,即可查看当前工作区中的所有 Markdown 标题

Suggestions for all Markdown headers in the current workspace

接受其中一个补全以插入指向该标题的完整链接,即使它在另一个文件中

Adding a link to the selected header in another file

您可以使用 Markdown > 建议 > 路径:包括工作区标题补全设置 (markdown.suggest.paths.includeWorkspaceHeaderCompletions) 配置何时/何时显示工作区标题补全。

有效的设置值是

  • onDoubleHash(默认)- 仅在键入 ## 后才显示工作区标题补全。
  • onSingleOrDoubleHash - 在键入 ### 后显示工作区标题补全。
  • never - 永远不显示工作区标题补全。

请记住,在当前工作区中查找所有标题可能很耗时,因此首次请求它们时可能会有轻微延迟,尤其是对于包含大量 Markdown 文件的工作区。

新的 markdown.preferredMdPathExtensionStyle 设置配置 VS Code 是否首选为 Markdown 文件的链接使用文件扩展名。此首选项用于语言工具,例如 路径补全链接重命名

有效的设置值是

  • auto - 尝试保留文件扩展名的现有样式。
  • includeExtension - 在链接中包含尾随 .md
  • removeExtension - 从链接中删除尾随 .md

远程开发

远程开发扩展,允许您使用 开发容器、通过 SSH 或 远程隧道 的远程计算机或 Windows Subsystem for Linux (WSL) 作为功能齐全的开发环境。

您可以在 远程开发发行说明中了解有关新扩展功能和错误修复的信息。

远程菜单

在此里程碑中,我们对远程菜单进行了一些可用性改进,可以通过单击状态栏左下角的远程指示器访问该菜单

  1. 现在有一个默认键盘快捷键用于打开远程菜单:⌥⌘O (Windows、Linux Ctrl+Alt+O)

  2. 我们减少了远程扩展对远程菜单的贡献,以便于一目了然地查看连接到远程窗口的所有操作。

    • 用于打开远程窗口的基本操作现在始终在远程菜单中可用,因此即使您已经在远程窗口中,也可以发现连接到另一个远程的操作。
    • 大多数用于配置远程或开始使用远程的操作已从远程菜单移动到命令面板,以节省远程菜单中的空间。
  3. 远程菜单中的安装其他远程扩展选项现在指向精选的远程开发扩展列表,如果所有此类扩展都已安装,则会从远程菜单中隐藏。

远程存储库

在此里程碑中,我们在 远程存储库 扩展中引入了浏览和编辑远程存储库,无需克隆演练,以帮助您在 GitHub 和 Azure Repos 中搜索、编辑和创建快速提交,而无需在本地克隆。

您还可以查看 远程存储库教程 以帮助您入门。

Web 版 VS Code

在此里程碑中,我们添加了对 Git LFS 跟踪的文件在 vscode.dev 上 GitHub 和 Azure Repos 存储库中托管的实验性只读支持。

在下面的短视频中,当在 vscode.dev 上滚动 Markdown 预览时,存储在 vscode-docs 存储库中 Git LFS 上的图像是可见的。

当您在 GitHub 或 Azure Repos 存储库中查看文件时,根据您的 .gitattributes 配置,我们会检测到该文件是否为 LFS 跟踪的文件,并且需要从 GitHub 或 Azure Repos 的 LFS 服务器获取。

您还可以将 GitHub 存储库Azure Repos 扩展与 VS Code Desktop 一起使用,以浏览包含 Git LFS 跟踪的文件而无需克隆的存储库。

可以使用以下设置禁用此行为

  • "githubRepositories.experimental.lfs.read.enabled": false
  • "azureRepos.experimental.lfs.read.enabled": false

VS Code 尚不支持提交 Git LFS 跟踪的文件,并且 github.dev 没有 Git LFS 读取支持。

扩展

改进的扩展搜索相关性

我们改进了 扩展视图Marketplace 库中扩展搜索结果的相关性。结果现在应该更合适,尤其是对于多词查询。

之前 之后
Search results for "mono debugger" showing Java debugger extension as the top result Search results for "mono debugger" showing Mono debug extension as the top result

扩展的贡献

Jupyter

IPyWidgets

Jupyter 扩展现在支持 IPyWidgets 的版本 8。依赖于 IPyWidgets 7.* 的 Python Widgets 将继续工作,因为版本 7.*8.* 都受支持。

交互式窗口内核选择

修改了 交互式窗口的自动选择内核,以便更好地与新的内核选择器 UI 配合使用。除非先前已为该工作区中的交互式窗口选择了另一个内核,否则将使用当前活动解释器,在这种情况下,将使用先前选择的内核。

Python

改进了对 pytest 的 IntelliSense 支持

Pylance 扩展现在具有强大的功能,可以帮助您在使用 pytest 编写清晰、简洁且易于理解的测试时更有效率和效果。

  • 支持 pytest fixtures 和参数化参数的补全、转到定义查找所有引用重命名符号F2)。
  • 通过内嵌提示(通过 "python.analysis.inlayHints.pytestParameters" 设置启用)和代码操作支持 pytest 参数的类型注释。
  • 基于提供给装饰器的参数值,对参数化 pytest 参数进行类型推断。

下面的短视频重点介绍了这些新的 pytest 功能

GitHub Pull Requests and Issues

GitHub Pull Requests and Issues 扩展取得了更多进展,该扩展允许您处理、创建和管理 pull requests 和 issues。亮点包括

  • PR 描述和评论中的永久链接渲染。
  • 从描述页面重新请求审阅。
  • 已签出 PR 中文件的快速差异。

查看扩展的 0.60.0 版本的变更日志,以查看其他亮点。

预览功能

全局搜索现在支持从笔记本中显示结果,就像它们在笔记本编辑器中显示一样。启用 search.experimental.notebookSearch 以试用此功能,并让我们知道您遇到的任何错误!目前,这仅支持搜索单元格输入和单元格中的 Markdown 源。

主题:Community Material Theme(在 vscode.dev 上预览)

异步标记化

此版本发布了实验性异步标记化功能。此功能允许编辑器在单独的 Web Worker 中标记化文档,这可以提高文档较大时编辑器的响应速度。

目前,异步标记化默认情况下处于禁用状态,但可以通过将 editor.experimental.asyncTokenization 设置为 true 来启用它。

TypeScript 5.0 支持

此更新包括对即将发布的 TypeScript 5.0 版本的支持。有关 TypeScript 团队当前正在进行的工作的更多详细信息,请参阅 TypeScript 5.0 Beta 博客文章TypeScript 5.0 迭代计划。一些编辑器工具亮点

  • 新的 switchcase 补全可帮助您更快地填写 switch 语句的两个部分。
  • github.devvscode.dev 上启用项目范围的 IntelliSense 的工作。

要开始使用 TypeScript 5.0 每晚构建版本,请安装 TypeScript Nightly 扩展或安装最新的 VS Code 1.76+ Insiders 构建版本

扩展编写

在此迭代中,我们引入了对 InputBox 提示和验证消息中链接的支持。在这些字符串中,您现在可以使用以下语法创建链接

[link text](link target)

链接目标可以是 URL 或命令 ID。当用户单击链接时,链接目标将在浏览器中打开或作为命令执行。

示例

const result = await vscode.window.showInputBox({
  prompt:
    'Please enter a valid email address [more info](https://aka.ms/vscode-email-validation)',
  validateInput: text => {
    if (text.indexOf('@') === -1) {
      return 'Please enter a valid email address, [more info](https://aka.ms/vscode-email-validation)';
    }
    return undefined;
  }
});

这将产生以下提示

Prompt contains a link that is underlined

以及以下验证消息

Validation message contains a link that is underlined

主题:Panda Theme(在 vscode.dev 上预览)

此行为适用于 showInputBoxcreateInputBox API。

用于 * 激活事件的信息诊断

当扩展使用 *(星号)激活事件时,它会在 VS Code 启动过程中激活。这可能会延迟 VS Code 的启动。为了帮助扩展作者了解使用 * 激活事件的影响,我们添加了一个信息诊断,当扩展使用 * 激活事件时会显示该诊断。该诊断显示在“问题”视图中,并且在扩展编辑器中也可见

Diagnostic for * activation event

有关 *(星号)激活的更多信息,您可以阅读 激活事件 文档。

when clause 上下文解析的即将到来的更改

扩展清单文件 (package.json) 中使用的 When clauses 允许扩展有选择地启用和禁用贡献,例如命令和 UI 元素(例如,菜单或视图)。下一个 VS Code 版本计划包含 when clause 的新解析器。新解析器提供了更多功能和正确性,但它也对 when clause 强制执行更严格的规则,并且可能会导致现有 when clause 的一些中断。查看 问题 #175540 以了解有关中断和新功能的更多信息。还鼓励您订阅该问题以获取有关新解析器的更新,包括新功能、中断和迁移指南。

即将到来的 Electron 更新可能需要对本机模块进行强制性更改

我们计划在我们的下一个稳定版本中更新到 Electron 22。这会给利用本机模块的扩展带来影响,原因是启用了 V8 内存笼:不再允许指向外部(“堆外”)内存的 ArrayBuffers。这意味着依赖于 V8 中此功能的本机模块将需要重构才能在 VS Code 1.77 及更高版本中继续工作。

请按照 Electron 博客文章 中的建议,了解如何使您的本机模块与未来版本的 VS Code 一起使用。

语言服务器协议

语言服务器协议 (LSP) 客户端 (8.1.0) 和服务器 (8.1.0) npm 包的新版本已发布。这些是错误修复版本(主要是为了解决使用完整文本文档同步时请求排序问题),并且包含用于自定义消息处理的 JSON-RPC 库的 API 添加。

建议的 API

每个里程碑都带有新的建议的 API,扩展作者可以试用它们。与往常一样,我们希望得到您的反馈。以下是试用建议的 API 的步骤

  1. 查找您想要试用的建议,并将其名称添加到 package.json#enabledApiProposals
  2. 使用最新的 vscode-dts 并运行 vscode-dts dev。它会将相应的 d.ts 文件下载到您的工作区。
  3. 您现在可以针对该建议进行编程。

您无法发布使用建议的 API 的扩展。下一个版本中可能会有重大更改,我们永远不想破坏现有扩展。

OpenDialogOptions allowUIResources

当扩展知道它们在远程扩展主机中运行时,可以使用 allowUIResources 使显示本地按钮显示在打开文件对话框中。使用 allowUIResources 的扩展应始终检查返回的 URI 的方案。

QuickPickItems 的工具提示

在此迭代中,我们为 QuickPickItems 引入了一个新的建议的 API,用于 tooltip 属性。此属性允许您为 Quick Pick 中的每个项目指定工具提示。当用户将鼠标悬停在项目上时,将显示工具提示,或者可以使用 Ctrl+Space 切换工具提示。

示例

await vscode.window.showQuickPick(
  [
    {
      label: 'label',
      tooltip: 'tooltip'
    },
    {
      label: 'label2',
      tooltip: new vscode.MarkdownString('tooltip2 [link](https://github.com)')
    }
  ],
  {
    placeHolder: 'placeholder'
  }
);

这将产生以下 Quick Pick

主题:Panda Theme(在 vscode.dev 上预览)

显然,这是一个不需要工具提示的简单示例。当您想提供可能有多行或指向其他资源的链接的长描述时,工具提示非常有用。

我们认为此属性是对 Quick Pick API 的一个很好的补充,我们期待您的反馈。

工程

更多 Electron UtilityProcess 采用

作为我们的 进程沙箱之旅的一部分,我们希望确保我们的应用程序中不再有启用 Node.js 的浏览器窗口。在此里程碑中,我们开始将我们最后剩下的进程从隐藏的 Node.js 浏览器窗口转换为 Electron UtilityProcess。作为这项工作的一部分,文件监视器进程也必须移出到其自己的实用程序进程中。

新的设置 window.experimental.sharedProcessUseUtilityProcess 启用了 UtilityProcess 的使用,我们计划在下一个版本中将其设为默认设置。

macOS 10.11 和 10.12 支持已结束

正如我们在 1.75 发行说明 中提到的,1.76 是最后一个支持 macOS 10.11 (OS X El Capitan) 和 10.12 (macOS Sierra) 的版本。有关更多信息,请参阅我们的 常见问题解答

值得注意的修复

  • 168939 跨重新加载和视图移动持久化徽章隐藏状态。
  • 164397 RTL macOS 中布局控件位置错误。

感谢

最后但同样重要的是,非常感谢 VS Code 的贡献者。

问题跟踪

对我们的问题跟踪的贡献

拉取请求

vscode 的贡献

贡献于 vscode-pull-request-github

贡献于 vscode-vsce

贡献于 monaco-editor