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

2022 年 11 月（版本 1.74）

更新 1.74.1：本次更新修复了这些问题。

更新 1.74.2：本次更新修复了这些问题。

更新 1.74.3：本次更新修复了这个安全问题。

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

欢迎使用 2022 年 11 月发布的 Visual Studio Code。此版本包含许多更新，希望您会喜欢，其中一些主要亮点包括：

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

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

辅助功能

笔记本执行的音频提示

现在，当笔记本单元格完成运行时，有音频提示。提示音不同，以指示单元格是成功运行还是失败。

差异评审模式的音频提示

在差异编辑器中，当触发转到下一个差异时，会播放特定的音频提示，以指示光标是在插入行还是删除行上。

如果您对可用的音频提示感兴趣，可以通过帮助：列出音频提示下拉菜单收听。

List Audio Cues dropdown

键盘可导航的设置编辑器指示器、悬停和链接

设置编辑器中的指示器、悬停和链接现在可以通过键盘导航。某些链接的样式也已调整，以提高设置编辑器中的一致性。

设置编辑器指示器悬停在制表位和保持键盘焦点方面表现得更好了。这种改进的行为仍处于实验阶段，目前仅在设置编辑器指示器悬停中启用，而不是在 VS Code 中的所有悬停中启用。

Navigating settings and a Modified elsewhere indicator in the Settings editor using the keyboard

主题：浅粉色（在 vscode.dev 上预览）

工作台

自定义资源管理器自动显示逻辑

通过引入新设置 explorer.autoRevealExclude，高度赞成的问题 #87956（“允许按特定文件夹设置 explorer.autoReveal”）已得到修复。此设置允许您配置在资源管理器中启用自动显示（explorer.autoReveal，默认为 true）时哪些文件被自动显示。autoRevealExclude 设置使用glob 模式来排除文件，并且类似于 files.exclude，还通过 when 子句支持同级匹配。

默认值排除 node 和 bower 模块

{
  "explorer.autoRevealExclude": {
    "**/node_modules": true,
    "**/bower_components": true
  }
}

按视图容器隐藏徽章

类似于通过右键单击视图容器来隐藏视图容器的方式，您现在可以隐藏容器上的徽章（显示在活动栏、面板和辅助侧边栏中）。徽章通常显示特定视图容器的数字、图标或进度指示器，例如，源代码管理视图中待处理更改的数量。

A context menu is triggered on the Source Control view showing a Hide Badge entry. This is then selected and the blue number one badge disappears. Triggering the context menu again shows a Show Badge entry which brings the blue badge number one badge back.

合并编辑器

此版本包含合并编辑器的一些改进和错误修复。亮点包括：

  • 撤消/重做现在跟踪冲突的处理状态。
  • 输入视图中的忽略操作可用于接受基础版本，而不是结果视图中的标记为已处理操作。
  • 两边相同更改现在自动解决。
  • 提供 git blame 功能的扩展现在可在传入、当前和基础编辑器中工作。

从磁盘安装扩展

您现在可以使用开发者：从位置安装扩展... 命令来安装位于本地磁盘驱动器上的扩展。该命令将打开平台文件夹对话框，以选择扩展 .vsix 文件的位置。

编辑器

CJK 字符的新断词选项

现在可以使用名为 editor.wordBreak 的设置，以避免在CJK 字符后插入换行点。当配置为 keepAll 时，换行算法将尝试将 CJK 字符后的文本保留在同一行上。此设置对其他脚本中的字符没有任何影响。

OpenType 字体的新字体设置

一些支持 OpenType 字体变体的新字体，支持调整某些轴，例如字体粗细轴，以实现无法通过 font-weight CSS 属性配置的字体粗细。在 CSS 中，这通过 font-variation-settings 属性实现。如果您使用此类字体，您现在可以将 editor.fontVariations 配置为 true，这将导致 VS Code 使用 "wght" 显示轴来设置字体粗细。如果您的字体支持其他轴，也可以直接配置它们，例如通过设置 "editor.fontVariations": "'ital' 0.5"。

新缩进大小设置

有一个名为 editor.indentSize 的新设置，它允许将缩进大小（构成缩进的空格数）与制表符大小（用于渲染制表符字符的空格数）分离。这在处理混合使用制表符和空格缩进的文件时非常有用，并且只能在使用手动缩进配置时使用。

下面是一个配置示例

"editor.detectIndentation": false,
"editor.insertSpaces": true,
"editor.tabSize": 8,
"editor.indentSize": 2

部分接受内联补全的命令

命令接受内联建议的下一个单词（editor.action.inlineSuggest.acceptNextWord）可用于接受当前内联建议的下一个单词/非单词段。目前，它只能接受内联建议第一行的部分内容。该命令仍在开发中，我们正在探索键盘快捷键以及未来版本的替代分割规则。

源代码管理

管理不安全的 Git 仓库

VS Code 使用 git.exe 执行所有 Git 操作。从 Git 2.35.2 开始，用户被禁止在当前用户以外的用户拥有的文件夹中的仓库中运行 Git 操作，因为该仓库被认为是潜在不安全的。

从本版本开始，如果您尝试打开此类潜在不安全的仓库，VS Code 将在源代码管理视图中显示欢迎视图以及错误通知。欢迎视图和通知都提供了管理不安全仓库命令，该命令允许您查看潜在不安全的仓库列表，将其标记为安全，并打开它们。管理不安全仓库命令也可在命令面板中使用。将仓库标记为安全将把仓库位置添加到 safe.directory Git 配置中。

乐观的用户界面更新

执行 Git 操作后，会执行一组 git 命令（例如，git status）以在更新源代码管理视图之前更新数据模型。在某些情况下，运行这些命令可能需要几秒钟才能完成（例如，在使用大型单体仓库时），导致源代码管理视图刷新延迟。

在这个里程碑中，我们进行了更改，以便在 git status 完成之前，源代码管理视图能够乐观地更新一些 Git 操作（暂存、取消暂存、丢弃更改和提交），从而使源代码管理视图响应更快。

此新功能默认启用，但可以使用 git.optimisticUpdate: false 禁用。

提交操作按钮改进

当提交操作按钮执行次要提交命令（例如，提交并同步）时，按钮标签现在正确反映正在执行的命令。提交按钮还会显示一个动画以指示进度。

终端

终端快速修复改进

终端快速修复现在以代码操作控件的形式呈现，以与编辑器中的体验保持一致。

A Quick Fix is triggered in the terminal and a menu is presented with a play button to the left of the action's label

终端下拉菜单中的任务操作

运行任务和配置任务命令出现在终端下拉菜单中，以提高可发现性和易用性。

The last section of the terminal dropdown menu contains Run Task and Configure Tasks commands

远程开发

远程隧道现在作为预览功能在 VS Code Stable 中可用。远程隧道允许您通过 VS Code 从任何设备、任何地方安全地访问您的机器。要启用远程隧道访问，您可以选择：

  • 从“帐户”菜单或“命令面板”中选择启用远程隧道访问。
  • 在安装了 VS Code 且已配置 PATH 的机器上运行 code tunnel。
  • 通过下载新的 VS Code CLI 并运行 ./code tunnel。

启用隧道访问后，您可以使用 vscode.dev 或从 VS Code 桌面版内部使用 远程 - 隧道 扩展连接到该机器。

要了解更多信息，请查看我们宣布此功能的博客文章或远程隧道文档。

主题：Codesong（在 vscode.dev 上预览）

注意：如果您之前使用独立的 code-server CLI，现在应改用 VS Code CLI（通过最新版 VS Code 桌面版或上面提到的独立下载）。

调试

JavaScript 调试

支持 console.profile

JavaScript 调试器现在支持 console.profile。在调试器下运行时，将为 console.profile() 和 console.profileEnd() 之间的代码收集 CPU 配置文件。

console.profile();
doSomeExpensiveWork();
console.profileEnd();

生成的 .cpuprofile 文件将保存在您的工作区文件夹中，可以使用 VS Code 内置的配置文件查看器打开和查看。

支持嵌套源映射

有时，特别是在 monorepo 设置中，源代码可能会编译一次，然后再次重新编译或打包。在许多情况下，这会导致生成的包的源映射引用在第一步中创建的已编译文件。

JavaScript 调试器现在将自动递归解析源映射，以便无需额外步骤即可调试原始源文件。

serverReadyAction 中添加了 killOnServerStop 属性

serverReadyAction launch.json 功能允许用户启动一个调试会话，该会话启动一个 Web 服务器，然后一旦服务器启动，自动开始调试导航到该服务器 URL 的浏览器。有一个新属性 killOnServerStop，当设置为 true 时，当服务器调试会话停止时，新的浏览器调试会话将自动停止。

例如

{
  "type": "node",
  "request": "launch",
  "name": "Launch Program",
  "program": "${workspaceFolder}/app.js",

  "serverReadyAction": {
    "pattern": "listening on port ([0-9]+)",
    "uriFormat": "https://:%s",
    "action": "debugWithEdge",
    "killOnServerStop": true
  }
}

在上面的示例中，当原始的 Launch Program 调试会话停止时，自动启动的 Edge 调试会话也将停止。

为焦点调试会话显示异常断点

以前，在运行两种不同类型的调试会话时管理异常断点效果不佳。现在，当调试会话在调用堆栈视图中获得焦点时，将显示该会话调试类型正确的断点集。

Exception breakpoints correctly shown per call stack frame

评论

comments.visible

新设置 comments.visible 可用于关闭编辑器注释（注释栏和编辑器内注释预览视图）。命令注释：切换编辑器注释仍可在会话期间用于打开和关闭编辑器注释。在注释视图中选择注释将始终打开注释。

注释视图徽章

注释视图显示未解决注释数量的徽章。

Comments view badge

任务

问题匹配器“搜索”文件位置方法

以前，问题匹配器需要通过 fileLocation 属性准确知道在哪里查找有问题的文件。支持的方法是 absolute、relative 或 autoDetect（首先检查相对路径，如果失败则查找绝对路径）。

然而，在使用嵌套子目录中脚本的工作区中，设置任务很困难，因为不同的脚本很少以统一的方式（例如，相对于工作区的基目录）报告文件路径。

为了解决这个问题，有一个新的文件位置方法，名为 search。使用此方法，将运行递归文件系统搜索以查找任何捕获的路径。

下面的示例展示了如何设置 search 文件位置方法（尽管所有参数都是可选的）：

"problemMatcher": {
    // ...
    "fileLocation": [
        "search",
        {
            "include": [ // Optional; defaults to ["${workspaceFolder}"]
                "${workspaceFolder}/src",
                "${workspaceFolder}/extensions"
            ],
            "exclude": [ // Optional
                "${workspaceFolder}/extensions/node_modules"
            ]
        }
    ],
    // ...
}

请注意，用户应警惕导致耗时的文件系统搜索（例如，在 node_modules 目录中查找），并适当设置 exclude 属性。

语言

TypeScript 4.9

VS Code 现在随附 TypeScript 4.9。此主要更新带来了新的 TypeScript 语言功能，例如 satisfies 运算符和自动访问器。在工具方面，我们改进了文件监视，并进行了许多其他修复和改进。

查看 TypeScript 4.9 公告了解有关此更新的更多信息。

从 return 跳转到定义

JavaScript 和 TypeScript 现在支持对 return 关键字运行转到定义，以快速跳转到返回函数的顶部。这在处理冗长、复杂或高度嵌套的函数时很有用。您可以使用转到定义命令/键绑定（F12）或简单地在 return 关键字上使用 Cmd/Alt + 点击。

Notebook

内核选择器实验：最近使用的内核

有一个新的笔记本内核选择器，它在选择器顶部显示最近使用的内核。这是一个可选实验，可以通过将 notebook.kernelPicker.type 设置为 mru 来启用。

未使用的内核将被移到辅助选择器选择另一个内核...。当您安装了最新Jupyter 扩展时，此选择器将按其来源（例如：Jupyter 内核、Python 环境等）对所有内核进行分组。

Kernel picker with most recently used kernels

我们很乐意听取您的反馈，您可以在VS Code 仓库中创建问题。

Web 版 VS Code

源代码管理

VS Code 网页版现在在编辑 GitHub 和 Azure Repos 仓库时支持以下设置：

  • "git.branchRandomName.enabled" - 在 VS Code 网页版中创建分支时生成随机分支名称。
  • "git.branchRandomName.dictionary" - 在 VS Code 网页版中创建分支时，指定用于生成随机分支名称的词典。
  • "git.closeDiffOnOperation" - 在执行提交、暂存、取消暂存更改等源代码管理操作后关闭差异编辑器。

此外，VS Code 网页版在状态栏和分支选择器中为受保护的分支显示锁定图标，这与 VS Code 桌面版的体验一致。

Lock icon for protected branches in the Status bar and branch picker

最后，您现在可以使用 VS Code 网页版中的源代码管理操作按钮，直接将您的更改提交并推送到仓库远程。

Commit & Push using source control action button

如果您希望在提交前验证更改，还可以使用操作按钮下拉菜单中的次要继续工作... 操作，将您的工作更改带到另一个开发环境。

“继续工作”的改进

当您在 GitHub 或 Azure Repos 仓库中时，命令面板中现在提供了方便的一步式命令，可将您的工作更改带到特定的开发环境：

  • 在新 Codespace 中继续工作
  • 在本地克隆中继续工作
  • 在 VS Code 桌面版中的远程仓库中继续工作

One step commands to continue working in another development environment

我们还将编辑会话重命名为云更改，以明确它与在云中存储工作更改相关。

对扩展的贡献

Jupyter

笔记本单元格调试的“仅我的代码”

“仅我的代码”调试功能允许您确定调试器是单步调试 Python 库中的代码，还是仅单步调试您的源代码。在调试笔记本单元格时，此功能默认启用，但您可以设置 "jupyter.debugJustMyCode": false 来禁用它，并允许您单步调试库代码。为了获得最佳体验，请将您环境中的 debugpy 升级到 >=1.6.3。以前，debugJustMyCode 设置仅在交互式窗口中调试时有效，现在也适用于笔记本编辑器。

支持重启笔记本单元格调试会话

调试工具栏中的重启命令会重启当前调试会话。以前，这在笔记本调试会话中会引发错误，但现在已支持此功能。遗憾的是，它无法在交互式窗口中得到妥善支持。

此功能在以下工作流中特别有用：您调试、编辑单元格，然后重启调试会话以再次调试应用了您编辑的单元格。

远程开发扩展

远程开发扩展允许您使用容器、远程机器或 适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。此版本的亮点包括：

  • 开发容器 GPU 支持
  • 开发容器 Cygwin / Git Bash 套接字转发
  • 远程 - 隧道扩展 - 无需 SSH 即可连接到远程机器。

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

GitHub 拉取请求和议题

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

  • 笔记本对永久链接命令的支持。
  • 拉取请求检查状态（例如，持续集成 (CI) 进行中、需要评审、CI 失败等）显示在“拉取请求”树视图中。
  • 可以从拉取请求概述中复制用于 PR 的 vscode.dev 链接。
  • 命令转到拉取请求中的下一个差异可跨文件导航到已签出 PR 中的下一个差异。

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

预览功能

配置文件

我们最近几个月一直在努力支持 VS Code 中的配置文件，这是社区最受欢迎的需求之一。此功能通过 workbench.experimental.settingsProfiles.enabled 设置提供预览。请尝试一下，并通过在vscode 仓库中创建问题或在问题 #116740 中评论来向我们提供反馈。

共享配置文件

您现在可以通过将其作为 Gist 导出到 GitHub 来共享配置文件。VS Code 将使用您的 GitHub 帐户创建一个秘密 Gist，并为您提供一个链接，以便与他人共享。当您打开该链接时，VS Code 将要求您安装共享配置文件。在导出或导入配置文件期间，VS Code 将显示预览，以便您可以分别查看和选择要导出或导入的数据。

以下是将配置文件导出到 GitHub 并复制链接与他人共享的视频：

Exporting a Profile

此视频展示了通过打开共享链接导入配置文件：

Importing a Profile

扩展签名和验证

从 11 月中旬开始，所有上传到 Visual Studio Marketplace 的 VS Code 扩展都由 VS Marketplace 签名——此过程称为仓库签名。在每次扩展安装和更新时，VS Code 都会验证扩展包签名。通过签名和签名验证，我们可以保证扩展包的完整性和真实性。

签名验证目前仅在 VS Code Insiders 中进行。如果您发现任何问题，可以通过在vscode 仓库中创建问题来告知我们，您可以通过将 extensions.verifySignature 设置为 false 来选择退出签名验证。我们正在努力在未来几个月内在 VS Code Stable 中启用签名验证。

除了仓库签名，我们还在开始进行扩展发布者签名的工作。

Web 中的 Python 执行

我们为 实验性 - Web 版 Python 扩展添加了调试支持。调试器支持以下功能：

  • 设置断点
  • 单步进入和跳出函数
  • 跨模块调试
  • 在调试控制台中评估变量
  • 在集成终端中调试程序

以下屏幕截图显示了调试 Hello World 程序：

Python debugging in VS Code for the Web

请注意，使用此扩展仍需要您在浏览器 URL 中添加以下查询参数 ?vscode-coi=。

扩展创作

声明的扩展贡献的隐式激活事件

在这个里程碑中，如果您的扩展在其 package.json 中声明了某些扩展贡献，我们取消了显式列出激活事件的要求。

以前，如果一个扩展在其 package.json 文件中声明它贡献了一个命令 mycommand，它还需要在 package.json 的 activationEvents 字段中列出相应的 onCommand:mycommand 激活事件，以便该命令成功执行。这既繁琐又容易出错，并且可能导致 package.json 文件过大。

VS Code 现在将自动填充以下扩展贡献点的激活事件：

贡献点 推断的激活事件
命令 onCommand
认证 onAuthenticationRequest
语言 onLanguage
customEditors onCustomEditor
views onView

扩展作者现在可以安全地从您的扩展中删除这些推断的激活事件。如果您这样做，请更新您的 VS Code 引擎要求，以确保您的扩展不会被视为与早期版本的 VS Code 兼容。

    "engines": {
        "vscode": "^1.74.0"
    },

日志输出通道

在这个里程碑中，我们最终确定了 LogOutputChannel API。您现在可以使用此 API 创建一个日志输出通道，用于记录来自扩展的消息。

我们还在 env 命名空间中最终确定了 logLevel 属性和 onDidChangeLogLevel 事件，以指示应用程序当前的日志级别，并在应用程序日志级别更改时触发事件。

所有 Webview 的一致源

继我们上次迭代的工作之后，VS Code 中的所有 Webview 现在都尝试维护自定义源。在 1.74 中，这也扩展到自定义编辑器使用的 Webview。

这通过允许在更多情况下缓存 Webview 内容来提高性能。有关更多详细信息以及作为扩展作者需要注意的事项，请参阅以前的发布说明。

扩展 README 中对视频标签的支持

扩展现在可以在其 README 中使用 <video> 标签。VS Code Marketplace 和 VS Code 中的扩展视图页面都支持视频。与 .gif 相比，视频文件质量更高，通常也更小。您甚至可以包含音频！

请记住，VS Code 本身仅支持特定的视频和音频格式。目前，您还必须使用 <video> src 和 poster 的完整路径，而不是相对路径。

评论线程附加操作

新的菜单位置 comments/commentThread/additionalActions 允许扩展为评论线程贡献始终可见的按钮。

Visible button in a comment

vsce 更名为 @vscode/vsce

VS Code 的扩展管理器工具 vsce 已更名为 @vscode/vsce。对于任何将此工具用作库的人来说，这是一个破坏性更改。CLI 工具仍然称为 vsce，可以通过 npm install -g @vscode/vsce 安装。

调试适配器协议

调试适配器协议中添加了一些澄清和一个新属性。

  • DataBreakpointInfo 请求有一个新的可选 frameId 属性。客户端可以使用此标志来指定哪个堆栈帧包含 name 变量。
  • 现在为 readMemory 请求指定了文件结束行为。

工程

属性和方法的名称混淆

我们的产品构建现在对属性和方法的名称进行混淆。这使我们主要捆绑包的大小减少了约 13%（-1.5 MB），并使代码加载时间减少了约 5%。

GitHub 和 Microsoft 身份验证扩展包大小改进

考虑到这两个扩展所提供的功能以及它们在许多情况下（例如 vscode.dev）对于启动的关键性，它们的捆绑包大小比我们预期的要大。在这个里程碑中，我们专注于减小这些扩展的大小，结果如下：

  • GitHub 身份验证：93 KB -> 64.9 KB
  • Microsoft 身份验证：97 KB -> 57.7 KB

这是通过以下方式实现的：

  • 不再依赖（并捆绑）提供 Node.js 和 Web 中现成可用功能的节点模块（例如，删除 uuid 而改用 Crypto.randomUUID()）。
  • 仅在 Node.js 中使用 node-fetch，而不是同时用于 Node.js 和 Web。
  • 采用最新版本的 @vscode/extension-telemetry，其大小显著减小。

在此过程中没有丢失任何功能，并且这些扩展由于其大小减小而现在可以更快地获取和加载。

Electron 沙箱之旅

您可以在最近的“将 VS Code 迁移到进程沙箱”博客文章中了解我们在启用 Electron 沙箱方面的进展。这篇详细文章介绍了技术时间线，并描述了为支持 VS Code 沙箱所做的增量更改。

如果您想试用 VS Code 沙箱模式，可以在设置中将 "window.experimental.useSandbox": true。希望您不会注意到任何功能差异，但如果您发现问题，请向我们报告。

Windows 上默认重新启用窗口控制叠加

窗口控制叠加（WCO）已默认重新启用。它之前在 8 月份启用，但随后再次禁用，因为它对于使用从右到左系统语言的用户来说渲染在错误的一侧，覆盖了文件和编辑菜单项。

主要问题是 VS Code 没有将应用程序区域设置传递给 Electron，因此 Electron 使用系统区域设置来确定 WCO 的位置。然而，VS Code 依赖于 Electron 的 app.getLocale() API 来获取系统语言并确定要推荐的语言包，而将应用程序区域设置传递给 Electron 导致 app.getLocale() 返回相同的区域设置而不是系统语言。

为了解决这个问题，我们在 Electron 中添加了一个新的 app.getPreferredSystemLanguages() API，这样即使在将区域设置传递给 Electron 后，我们仍然可以获取用于 VS Code 语言包推荐器的系统语言，同时将 WCO 保持在右侧。

VS Code with the custom title bar along with Paint's title bar. The screenshot is taken on Windows 11 with the system language in Arabic, showing that the WCO is on the right for VS Code, which is in English, while it is on the left for Paint, which is in Arabic.

内置扩展现在使用新的 l10n API 而不是 vscode-nls

上个月我们稳定了新的本地化 (l10n) API。本月，我们已在 Microsoft/vscode 仓库中的每个扩展中采用了该 API。我们仍然需要将语言服务器转移到使用 @vscode/l10n 而不是 vscode-nls，以及团队拥有的其他一些扩展（JS Debug、Python、Jupyter Notebooks 等），但我们正在朝着为所有扩展提供统一本地化体验的正确方向前进。

值得注意的修复

感谢

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

问题跟踪

对我们问题跟踪的贡献

拉取请求

对 vscode 的贡献

对 vscode-css-languageservice 的贡献

对 vscode-eslint 的贡献

对 vscode-js-debug 的贡献

对 vscode-json-languageservice 的贡献

对 vscode-pull-request-github 的贡献

对 debug-adapter-protocol 的贡献

对 devcontainers/cli 的贡献