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

2023 年 3 月（版本 1.77）

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

更新 1.77.2：此更新解决了此安全问题。

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

下载：Windows：x64 Arm64 | Mac：通用 Intel Apple 芯片 | Linux：deb rpm tarball Arm snap

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

如果您想在线阅读这些发行说明，请访问 code.visualstudio.com 上的更新页面。

内测版：想尽快尝试新功能？您可以下载每晚的内测版构建，并尽快尝试最新的更新。

辅助功能

终端可访问缓冲区改进

终端可访问缓冲区，它通过终端：焦点可访问缓冲区（⌥F2 (Windows Alt+F2, Linux Shift+Alt+F2)）为屏幕阅读器用户提供对终端内容的访问，现在会动态更新并保持活动状态，直到使用Escape或Tab结束会话。

当带有 shell 集成的终端中焦点位于可访问缓冲区时，可访问视图中的转到符号（⇧⌘O (Windows, Linux Ctrl+Shift+O)）可以实现在终端命令之间导航，类似于编辑器如何使用转到编辑器中的符号...进行导航。

悬停控件导航

现在可以通过 up、down、home、end、page up 和 page down 键将焦点放在悬停控件上并进行水平和垂直滚动。用于聚焦悬停控件的键盘快捷方式（⌘K ⌘I (Windows, Linux Ctrl+K Ctrl+I)）与在主光标位置显示悬停的快捷方式相同。

接受通知的主操作

要接受通知的主操作，用户过去需要导航到通知中心。通知：接受通知主操作（⇧⌘A (Windows, Linux Ctrl+Shift+A)）会在不离开当前上下文的情况下运行主操作。

粘滞滚动导航

现在可以将焦点放在粘滞滚动行上，并使用 up 和 down 键进行导航。您可以使用 Enter 键转到选定行。要聚焦粘滞滚动，您可以从命令面板运行聚焦粘滞滚动。通过视图：切换粘滞滚动命令启用粘滞滚动 UI。

工作台

从编辑器沟槽复制 GitHub 深层链接

在 GitHub 存储库中工作时，您现在可以从编辑器沟槽复制编辑器行或范围的深层链接。

在 VS Code Desktop 中，要能够从编辑器沟槽创建 GitHub 永久链接和 HEAD 链接，您需要安装 GitHub 拉取请求和问题扩展。在 vscode.dev 中，GitHub 存储库的深层链接是开箱即用的。

这些操作也已添加到编辑器选项卡上下文菜单和资源管理器上下文菜单中的共享子菜单。

按文件内容推荐扩展

VS Code 现在可以根据文件内容推荐扩展。例如，如果您打开一个包含笔记本单元格语法的 Python 文件，VS Code 会推荐 Jupyter 扩展以正确呈现和运行这些单元格。

为粘滞滚动选择默认提供程序

粘滞滚动（视图：切换粘滞滚动）使用几种不同的内容模型来创建其标题。现在可以在大纲提供程序模型、折叠提供程序模型和缩进模型之间进行选择，以确定在粘滞滚动 UI 中显示哪些行。如果当前语言没有可用的模型，VS Code 将按照上述顺序回退到下一个模型。最初使用的默认模型可以通过编辑器 > 粘滞滚动：默认模型（editor.stickyScroll.defaultModel）进行更改。

终端

改进的选项卡悬停

终端选项卡悬停现在显示 shell 的进程 ID、完整的命令行以及改进的扩展环境变量贡献视图。

Hovering the terminal tab will reveal details about the terminal, this can be triggered with the keyboard via Ctrl/Cmd+K, Ctrl/Cmd+I

源代码管理

远程存储库中的 Git LFS 提交支持

编辑 GitHub 和 Azure Repos 存储库时，您现在无需安装 Git LFS 即可提交 LFS 跟踪的文件。要开始使用，请在 VS Code Desktop 上安装 GitHub Repositories 或 Azure Repos 扩展，运行打开远程存储库命令以打开您的存储库，并使用源代码管理视图提交您的更改。这些扩展会解析您的 .gitattributes 配置，以确定您的更改文件是否应提交到存储库提供程序的 Git LFS 存储。

要禁用此行为，您可以设置 "githubRepositories.experimental.lfs.write.enabled": false 和 "azureRepos.experimental.lfs.write.enabled": false。

注意：尚不支持 VS Code for the Web (vscode.dev)。

3 向合并编辑器文档

如果您还没有尝试使用 3 向合并编辑器来帮助您解决合并冲突，请查看源代码管理文档中的3 向合并编辑器部分。3 向合并编辑器允许您同时查看和选择传入和当前更改，预览结果，甚至在任何更改之前查看文件的基本版本。

3-way merge editor

不要错过 The EXTREMELY Helpful Guide to Merge Conflicts YouTube 视频，该视频以 3 向合并编辑器为主角。

Notebook

保存时格式化

您现在可以为笔记本启用保存时格式化。这会在您保存笔记本时格式化整个笔记本。您可以通过将 notebook.formatOnSave.enabled 设置为 true 来启用此功能。

笔记本输出中的查找默认启用

当您在笔记本中打开查找控件时，它现在会默认在单元格输入和输出中搜索文本。您可以通过更改筛选器下拉菜单中的选项来关闭此功能。

可滚动输出区域

当 notebook.output.scrolling 设置为 true 时，超出 notebook.output.textLineLimit 的输出和错误将在可滚动区域内呈现。

语言

TypeScript 5.0

VS Code 现在附带 TypeScript 5.0.2。此重大更新带来了新的 TypeScript 语言功能、改进的性能以及许多重要的改进和错误修复。您可以在 TypeScript 博客上阅读有关 TypeScript 5.0 的信息。

JavaScript 和 TypeScript 的 Switch Case 自动补全

VS Code 现在可以帮助在 JavaScript 或 TypeScript 中搭建字面量类型的 switch 语句

在 switch 语句中键入 case 并接受 case ... 的建议。这将自动插入此类型的所有值的 case。请注意，这仅适用于被切换的值是联合类型或字面量类型的情况。

Web 版 VS Code

.gitignore 支持

此里程碑中，我们增加了对 VS Code for Web 上 GitHub 和 Azure Repos 存储库中 .gitignore 文件的支持。在下面的视频中，通过 .gitignore 未跟踪的文件在资源管理器视图中显示为灰色，并且不出现在源代码管理视图中。当使用 GitHub Repositories 或 Azure Repos 扩展远程浏览 VS Code Desktop 上的存储库时，这也适用。

下面的短视频将 .pxt 文件夹添加到 .gitignore 以隐藏源代码管理视图中包含的文件。

远程开发

远程开发扩展允许您使用 开发容器、通过 SSH 或 远程隧道连接的远程机器，或者 适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。

开发容器允许您使用容器作为功能齐全的开发环境。开发容器规范旨在丰富现有格式，使其包含常见的开发设置、工具和配置，同时仍然提供简化的、非编排的单容器选项。您可以在 Changelog 播客的第 529 集中了解有关开发容器和规范的更多信息。

其他远程开发亮点包括

  • 远程隧道 - 更好地重用现有隧道。
  • 远程隧道 - 在 VS Code Desktop 中继续工作命令可快速转换为本地开发。
  • 开发容器 - 更容易清理未使用的开发容器和卷。

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

扩展

扩展安装不受签名验证失败的阻碍

扩展签名验证错误地报告了少量有效扩展的错误，并阻止了它们的安装。这些失败是由于 VS Marketplace 和 VS Code 中的错误造成的，我们正在积极修复。为了解除扩展使用障碍，VS Code 将安装扩展，即使签名验证失败。我们将在 VS Marketplace 问题 #619 修复后重新启用签名验证检查，很可能在我们的下一个稳定版本中。

对扩展的贡献

Python

移动符号重构

多亏了新的将符号移动到代码操作，您现在可以更方便地使用 Pylance 重构您的 Python 代码！

要试用它，请选择 Python 文件中的一个符号，然后单击出现的灯泡（⌘. (Windows, Linux Ctrl+.)）。您可以将符号移动到现有文件或新文件。如果位置是新文件，则会创建一个与您的符号同名的 Python 文件。所有适用的导入引用都会随着符号移动而自动更新。

从依赖文件创建环境

当您打开 requirements.txt 或 pyproject.toml 文件时，编辑器中会出现一个新的创建环境...按钮，它会运行Python：创建环境命令，允许您创建新的虚拟环境并安装列出的依赖项。

A pyproject.toml file open with dependencies listed, and a Create Environment button displayed on the bottom right corner for the editor

针对扩展作者的已定型环境 API

Python 扩展的用于处理用户计算机上可用 Python 环境的 API 已定型。扩展还可以使用 API 访问 Python 扩展用于运行脚本的选定环境路径，或将其路径更新为首选路径。

API 用法示例在Python 环境 API Wiki 页面中。我们还计划将来发布一个 npm 类型包，以便更轻松地跟踪 Python 扩展 API 中的任何更改。

Jupyter

Python 环境的内核选择器改进

即使 Python 运行时未安装在其中，内核选择器现在也会列出 conda 环境。

例如，如果使用 CLI（例如 conda create -n envML）创建新的 conda 环境，则此新环境将显示在Python 环境列表中的没有 Python 的 Conda 环境部分下。

当您选择此类环境时，Python 运行时和必要的依赖项会自动安装到环境中。

Notebook kernel picker with ability to select empty conda environments

GitHub 拉取请求和议题

GitHub Pull Requests and Issues 扩展取得了更多进展，该扩展允许您处理、创建和管理拉取请求和问题。亮点包括

  • 可以从拉取请求视图在 vscode.dev 上打开拉取请求。
  • 创建拉取请求视图中有一个新设置用于检查自动合并选项：githubPullRequests.setAutoMerge。

查看扩展 0.62.0 版本的更新日志以查看其他亮点。

GitHub Copilot

GitHub Copilot 是一款人工智能结对编程工具，可帮助您更快、更智能地编写代码。您可以使用 VS Code 中的 Copilot 扩展来生成代码、从其生成的代码中学习，甚至配置您的编辑器。

GitHub Copilot extension

我们很高兴地宣布更深入的 Copilot 集成到 VS Code 的预览版。通过使用 GitHub Copilot Chat 扩展，您将能够试用新功能，例如

  • 内联建议：当您在代码中工作时，Copilot 建议会内联显示。
  • 聊天视图：在 GitHub Copilot Chat 视图中，就任何任务或问题向 Copilot 寻求帮助。
  • 内联聊天：在编写代码时，在文件中与 Copilot 进行内联对话。

您可以要求 Copilot 查找错误、解释复杂的代码、创建测试，甚至提出有关 VS Code 的问题。

Copilot chat example asking how to change VS Code colors

您可以在VS Code 和 GitHub Copilot 博客文章中了解有关 VS Code 团队使用 Copilot 的经验和未来的更多信息。您还可以阅读VS Code 中的 GitHub Copilot 文章，了解有关在 VS Code 中使用 Copilot 的更多详细信息。

预览功能

笔记本搜索支持输出

上一次迭代中，我们为打开的笔记本中的格式化笔记本内容引入了全局搜索，但仅限于单元格和 Markdown 输入。这次迭代中，我们增加了对搜索笔记本输出的支持。当您打开笔记本时，有一个切换按钮允许您自定义要在笔记本中搜索的位置。启用 search.experimental.notebookSearch 来试用此功能！

欢迎页面上的远程连接选择器

欢迎页面现在支持启动列表中的实验性远程连接选择器连接到...，以帮助您开始远程连接（SSH、远程隧道、GitHub Codespaces 等）。此功能默认禁用，可以通过将 workbench.remote.experimental.showStartListEntry 设置为 true 来启用。

扩展创作

即将到来的 Electron 22 更新可能需要更改本机模块

我们计划在下一个稳定版本中更新到 Electron 22。由于启用了 V8 内存笼，这对使用本机模块的扩展会产生影响：不再允许指向外部（“堆外”）内存的 ArrayBuffers。

我们计划提供一个自定义内存分配器，以便未更新的本机模块仍能继续工作，但仍然建议您检查已分配外部内存的使用情况。请遵循 Electron 博客文章中的建议，了解如何采用此更改。

已完成对持续测试运行的支持

对持续测试运行的支持已完成。此 API 允许用户向测试扩展指示他们希望“监视”测试并在进行更改时继续运行它们。

const profile = ctrl.createRunProfile(/* ... */);
+profile.supportsContinuousRun = true;

function runHandler(request: vscode.TestRunRequest, cancellation: vscode.CancellationToken) {
+  if (request.continuous) {
+    startWatchingAndRunningTests(request);
+  }

  // ...
}

新 when 子句解析器

此 VS Code 版本包含一个用于when 子句的新解析器，提供新功能（例如，支持括号）和更好的正确性，但也更严格。此版本还包含一个用于扩展清单文件（package.json）中 when 子句的 lint 工具，以确保它们在语法上正确。我们鼓励您检查您的 when 子句是否存在新解析器可能造成的损坏。此外，如果您在 when 子句中使用括号，您的扩展将与 VS Code 1.77 及更高版本兼容。有关更改的更多信息，请参阅问题 #175540。

源代码管理输入中的内联补全

源代码管理输入框现在支持内联补全

The inline suggestions extension sample running in the Source Control input

源代码管理输入框的文档语言标识符是 scminput。

提议的 API

每个里程碑都会带来新的提议 API，扩展作者可以尝试这些 API。一如既往，我们希望得到您的反馈。以下是尝试提议 API 的步骤

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

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

编辑器侧边栏提议的上下文菜单

editor/lineNumber/context 提议菜单锚定在编辑器侧边栏和编辑器行号上，提供了一种显示与特定行相关的扩展操作的方式。

要在开发中试用此功能，请启用 contribEditorLineNumberMenu API 提案。贡献给此菜单的操作将在命令参数中接收行号，并且可以在其 when 子句中引用 editorLineNumber 上下文键。您可以在API 提案问题 #175945 中留下反馈。

笔记本生命周期事件：onWillSaveNotebookDocument

onWillSaveNotebookDocument 事件在保存笔记本文档之前触发。此事件对于希望在保存笔记本文档之前执行某些操作的扩展非常有用。例如，希望在保存笔记本之前清理笔记本单元格输出的扩展可以为此事件注册一个侦听器，并返回要应用的单元格输出编辑。

以下是扩展如何为此事件注册侦听器

vscode.workspace.onWillSaveNotebookDocument(e => {
    if (event.reason == vscode.NotebookDocumentSaveReason.Manual) {
      event.waitUntil(new Promise((resolve) => {
        const notebookEdit = new vscode.NotebookEdit(...);
        const edit = new vscode.WorkspaceEdit();
        edit.set(event.document.uri, [notebookEdit]);
        resolve([edit]);
      }));
    }
});

工程

Windows 8 和 8.1 的EOL警告

VS Code Desktop 将在接下来的几个里程碑中更新到 Electron >=23。随着 Electron 23 更新，VS Code Desktop 将不再在 Windows 8 / Windows Server 2012 和 Windows 8.1 / Windows Server 2012 R2 上运行。在此里程碑中，我们已为受影响平台的用户添加了弃用通知，以准备他们进行迁移。如果您正在运行这些 Windows 版本之一，请查看我们的 常见问题以获取更多信息。

Snap 包的基础镜像已更新

在此迭代中，我们已将 Snap 包更新为使用 Core20（基于 Ubuntu 20.04 构建）作为基础镜像，而不是以前的 Core（基于 Ubuntu 16.04 构建）。此更改解决了我们 CLI 缺少 GLIBC 符号的问题，并修复了 wayland 支持以及其他问题。您可以在拉取请求 #127320中找到更多上下文。

探索扩展主机自定义内存分配器

为了采用启用 V8 沙盒的 Electron 22，并最大限度地减少对依赖特定使用外部数组缓冲区的本机模块的扩展的影响，我们自定义了扩展主机中现有的内存分配器。具体来说，扩展主机现在适应这些本机模块的分配，使其位于 V8 沙盒内部，作为避免致命崩溃的权宜之计。如果您有兴趣了解我们如何/为何最终选择此解决方案，您可以查看问题 #177338 以获取详细信息。

文档

新编程语言主题

值得注意的修复

  • 174690 注释 API - author.iconPath 如何引用与扩展捆绑在一起的文件？
  • 175805 VS Code 不会自动检测用于端口转发的 IPv6 进程

感谢

最后但同样重要的是，向 VS Code 的贡献者们致以衷心的感谢。

问题跟踪

对我们问题跟踪的贡献

拉取请求

对 vscode 的贡献

对 vscode-languageserver-node 的贡献

对 vscode-pull-request-github 的贡献

对 vscode-docs 的贡献

对 monaco-editor 的贡献

对 devcontainers/cli 的贡献