2024年2月（版本 1.87）

Name: Visual Studio Code
Author: Microsoft

更新 1.87.1：此更新修复了这些问题。

更新 1.87.2：此更新修复了此安全问题。

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

欢迎使用 Visual Studio Code 2024 年 2 月版。此版本包含许多我们希望您会喜欢的更新，以下是部分主要亮点：

编辑器中的语音听写 - 使用语音直接在编辑器中进行听写。
多光标内联建议 - 为多个光标查看并接受内联建议。
由 Copilot 驱动的重命名建议 - 从 Copilot 获取符号重命名建议。
并排预览重构 - 使用多重差异编辑器预览跨文件的重构。
更智能的 Python 导入 - 改进了添加缺失 Python 导入的功能。
编辑器粘性滚动 - 编辑器中现已默认启用粘性滚动。
语音识别的多语言支持 - 支持多种语言进行语音识别。
针对开发容器的 Copilot 建议 - 获取开发容器配置的模板和功能建议。

如果您想在线阅读这些发行说明，请访问 code.visualstudio.com 上的更新。Insiders：想尽快尝试新功能吗？您可以下载每晚Insiders版本并尽快尝试最新更新。

辅助功能

在编辑器中使用听写

只要您安装了 VS Code Speech 扩展，现在就可以使用语音直接在编辑器中进行听写。

我们添加了用于开始和停止编辑器听写的新命令：Voice: Start Dictation in Editor（语音：开始编辑器听写）（⌥⌘V (Windows, Linux Ctrl+Alt+V)）和 Voice: Stop Dictation in Editor（语音：停止编辑器听写）（Escape）。

您可以按住开始命令的快捷键（⌥⌘V (Windows, Linux Ctrl+Alt+V)）来启用“对讲机模式”，在该模式下，一旦您松开按键，语音识别就会立即停止。

注意： 听写功能甚至可以在使用富文本编辑器的其他地方工作，例如 SCM 提交输入框，以及在审查拉取请求时的评论输入字段。

语音识别的多语言支持

当您使用 VS Code Speech 扩展时，现在可以通过 accessibility.voice.speechLanguage 设置从 26 种支持的语言中进行选择。

语音扩展的每种语言都作为单独的扩展提供。当您第一次启动语音识别时，您会看到为您选择的每种语言安装相应的扩展。

辅助功能信号

辅助功能信号包括声音（以前称为音频提示）和播报（以前称为警报）。

命令 Help: List Signal Sounds（帮助：列出信号声音） 和 Help: List Signal Announcements（帮助：列出信号播报） 允许用户查看可用的信号并进行配置。向此新配置的迁移会自动发生。

之前

"audioCues.clear": "on | auto | off"
"accessibility.alert.clear": true | false

之后

"accessibility.signals.clear": {
    "sound": "auto | on | off",
    "announcement" (optional): "auto | off"
}

工作台

发行说明中的交互式设置

为了让您更轻松地开始使用新功能，现在您可以直接从发行说明中启用或查看设置。当您在 VS Code 中查看发行说明（Show Release Notes（显示发行说明）命令）时，会注意到某些设置带有齿轮图标。选择该设置或齿轮图标即可立即与该设置进行交互。

Example of an interactive setting in release notes

语言模型访问的透明度和控制

在本迭代中，我们引入了一个提议的 API，它使扩展能够使用 GitHub Copilot Chat 的语言模型。为了提供对模型访问的最大透明度和控制，我们添加了以下功能。

像管理身份验证访问一样管理语言模型访问

我们发现，管理对语言模型的访问与在 VS Code 中管理对 GitHub 帐户或 Microsoft 帐户（或任何利用 AuthenticationProvider 模型的服务）的访问非常相似。由于这些相似性，我们也利用了 VS Code 的身份验证栈来管理对语言模型的访问。

当一个扩展想要访问另一个扩展的语言模型时，它们会看到一个一次性的访问提示，该提示会被持久化：显示需要语言模型访问权限的扩展的模态对话框

一旦授予访问权限，您就可以在管理帐户访问权限的同一位置（帐户菜单中）管理该访问权限。

“管理受信任的扩展”将引导您进入一个快速选择菜单，如果您愿意，可以在其中管理访问权限。

Manage trusted extensions quick pick

随着初步工作的完成，我们将继续完善体验，使其尽可能流畅和清晰。

跟踪扩展的语言模型使用情况

您可以在扩展编辑器和运行时扩展编辑器中跟踪扩展的语言模型使用情况。下图显示了 Copilot Chat 示例扩展对 GitHub Copilot Chat 语言模型发出的请求数量。

Tracking language model usage in extension editor

Tracking language model usage in running extensions editor

编辑器

编辑器粘性滚动

本迭代中，我们默认启用了编辑器中的“粘性滚动”。您可以使用 editor.stickyScroll.enabled 设置来更改此项。

我们还将编辑器粘性小部件中可显示的最大行数从 10 增加到了 20。您可以使用 editor.stickyScroll.maxLineCount 设置来配置最大行数。

多光标内联建议

本迭代中，我们添加了对多光标内联补全的支持。现在，内联补全会在主光标和辅助光标位置处进行预览并应用。

多重差异编辑器中的重构预览

通过重构预览，您可以查看代码重构将应用的更改。重构预览更改现在显示在多重差异编辑器中，这有助于一眼查看所有更改并将其与之前版本进行比较。

终端

命令持续时间跟踪

现在可以跟踪终端持续时间，并且当启用 Shell 集成时，详细信息会显示在命令悬停提示中。

Hovering the terminal command shows how long it took in milliseconds

用于放大、缩小和重置的新命令

有用于放大、缩小和重置终端字体大小的新命令。它们默认未绑定，但您可以将它们绑定到您喜欢的快捷键。

Terminal: Increase Font Size（终端：增大字体） (workbench.action.terminal.fontZoomIn)
Terminal: Decrease Font Size（终端：减小字体） (workbench.action.terminal.fontZoomOut)
Terminal: Reset Font Size（终端：重置字体） (workbench.action.terminal.fontZoomReset)

源代码管理

在窗口标题中包含存储库或分支名称

用户可以使用 window.title 设置自定义窗口标题。本迭代中，我们添加了两个可用于此设置的新变量：${activeRepositoryName} 和 ${activeRepositoryBranchName}。这些变量将分别替换为活动存储库的名称和活动分支的名称。

提交输入验证改进

本迭代中，我们探索了使用语言诊断来为编写提交消息提供更好的输入验证。使用语言诊断使我们能够呈现可以调用的代码操作，以解决输入验证警告。我们添加了用于删除空白字符、根据 git.inputValidationSubjectLength 和 git.inputValidationLength 设置强制换行的代码操作，并且我们正在寻求在未来添加更多的代码操作。

要启用它，请切换 git.inputValidation 设置。在默认启用此功能之前，我们还有一些问题需要解决，但在此期间请随意启用它并告知我们您的反馈。

传入/传出更改设置管理

我们继续优化源代码控制视图的 Incoming/Outgoing（传入/传出） 部分。本迭代中，我们在“传入/传出”分隔符中添加了一个设置操作，允许用户更轻松地切换 scm.showIncomingChanges、scm.showOutgoingChanges 和 scm.showChangesSummary 设置。这些操作也可在源代码控制视图标题栏的 ... 菜单中的 Incoming & Outgoing（传入和传出） 菜单中使用。

关闭所有未修改编辑器的命令

为了帮助编辑器管理，我们在命令面板中添加了 Close All Unmodified Editors（关闭所有未修改的编辑器） 命令，该命令将关闭所有包含未修改文件的编辑器。该命令不会关闭有未保存更改的编辑器。

Notebook

笔记本的缩进设置

我们现在通过 notebook.editorOptionsCustomizations 设置支持笔记本特定的缩进设置。此设置允许用户通过 editor.tabSize、editor.indentSize 和 editor.insertSpaces 设置为笔记本设置特定的缩进样式。

用户还会注意到一个名为 Notebook Indentation（笔记本缩进） 的状态栏条目，它显示当前笔记本编辑器的缩进设置。此条目有一个快速选择菜单，无需打开设置编辑器即可管理缩进设置。这与编辑器中可用的快速选择菜单相同。

调试

支持新的 `BreakpointMode`

VS Code 支持调试适配器协议 (DAP) 的一项新添加功能，允许您设置不同“模式”的断点。此功能通常由本地代码调试器使用，例如，设置硬件断点与软件断点。可以通过上下文菜单中的 Edit Mode（编辑模式） 操作更改断点的模式。

Breakpoint context menu now has an 'Edit Mode...' option to change the breakpoint mode

远程开发

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

亮点包括：

GitHub Copilot Chat 在向工作区添加开发容器配置文件时建议模板和功能

您可以在远程开发发行说明中了解有关这些功能的更多信息。

不要错过最近的使用 Visual Studio Code 进行远程开发学习路径，以了解 VS Code 中不同的远程开发功能。

对扩展的贡献

GitHub Copilot

重命名建议

我们正在逐步推出由 Copilot 提供的重命名建议。当您在编辑器中重命名符号时，GitHub Copilot 会根据您的代码建议该符号的一系列可能的新名称。

内联聊天辅助功能视图

内联聊天现在有一个辅助功能视图，可以像可访问的差异查看器一样显示代码更改。当您使用屏幕阅读器模式时，辅助功能视图会启用。您还可以通过使用 inlineChat.accessibleDiffView 设置将其配置为始终开启或关闭。

此外，现在可以使用快捷键 F7 和 Shift+F7 用键盘导航更改块。

内联聊天的默认模式

我们已停用 live preview 模式，并将 live 设为内联聊天的默认模式。这意味着建议直接应用于编辑器，并且更改通过内联差异突出显示。

麦克风图标始终可见

用于在 Copilot Chat 中启动语音识别的麦克风图标现在始终可见。当尚未安装 VS Code Speech 扩展时，选择该图标首先会请求安装该扩展以启用语音转文本功能。

Microphone icon in chat input

如果您对该功能不感兴趣，或者只想通过快捷键使用它，则可以从上下文菜单中隐藏该功能。

Hide microphone icon in chat input

针对代理和斜杠命令的语音支持

当您使用 VS Code Speech 扩展通过语音填充聊天输入字段时，“at workspace”或“slash fix”等短语现在会转换为相应的代理和斜杠命令。这在聊天视图和内联聊天中均有效。

随处可用的对讲机模式

当您使用 VS Code Speech 扩展时，命令 Voice: Start Voice Chat（语音：开始语音聊天）（⌘I (Windows, Linux Ctrl+I)）现在随处可用，并会调出语音聊天，具体取决于您的焦点位置（编辑器中的内联聊天，否则为面板聊天）。

要启用对讲机模式，请按住快捷键。语音识别处于活动状态，直到您松开按键，之后请求会自动提交。

基于光标位置的 `Copilot: Explain This（Copilot：解释此项）`

以前，在聊天中输入 Explain This 需要您先在活动编辑器中选择要解释的文本。现在，您也可以将光标放在标识符上，让 Copilot 查看该标识符的定义。如果定义在另一个文件中，则需要提供丰富的语言支持。

预览：`#codebase` 变量

本迭代中，在 GitHub Copilot Chat 的预发布版本中，我们引入了一个名为 #codebase 的新聊天变量。此变量可用于根据您的查询向 Copilot 或您正在交谈的聊天参与者提供工作区上下文。

在此示例中，您可以将 #codebase 视为先向 @workspace 提问，然后将该响应添加到您正在向 @terminal 提出的问题中。

这是一个预览功能，因此 #codebase 可能不是此变量的最终名称，但我们的意图是提供某种方式将工作区上下文包含给聊天参与者。

同样，这仅存在于 GitHub Copilot Chat 的预发布版本中。让我们知道您的想法以及您如何使用它！

终端工作区上下文

终端不再自动拉取工作区上下文，因为这可能需要一些时间。相反，您需要通过使用 #codebase 变量显式地包含它。

终端聊天位置

有一个新设置 github.copilot.chat.terminalChatLocation，用于控制终端聊天体验。默认值为 chatView，如果您更喜欢之前的行为，可以将其配置为 quickChat。

Jupyter

对本地运行的 Jupyter 服务器的语言服务器支持

连接到本地 Jupyter 服务器时，Jupyter 扩展以前将这些 Jupyter 服务器视为远程。因此，Pylance 扩展无法检测到已安装的包。

Failed language features for remote Jupyter Servers

本迭代中，Jupyter 扩展会检测连接的 Jupyter 服务器是本地还是远程。这使得 Pylance 扩展能够根据已安装的包（在本地 Python 环境中）提供更丰富的语言功能。

Language features for remote Jupyter Servers

Python

Python REPL 的 Shell 集成

我们现在通过 WSL 扩展在 Mac、Linux 和 Windows 上启用了 Python REPL 的 Shell 集成。当您在 Python REPL 中执行命令时，彩色圆圈装饰器会指示命令是成功还是失败。此外，我们还支持 Python REPL 的 Terminal: Run Recent Command…（终端：运行最近命令…） 命令，这使您可以查看和利用 REPL 的命令历史记录。

我们现在还支持适用于所有操作系统的 Python Shell 文件历史记录，可通过 Terminal: Run Recent Command（终端：运行最近命令） 访问。

降低忽略第一个命令的风险

以前，许多 Python REPL 用户注意到他们的第一个 Python REPL 命令存在问题（例如，通过使用 Shift+Enter）。要么他们的 Python 命令被忽略且未发送到 Python REPL，要么该命令被多次粘贴到启动 Python REPL 的 Shell 中，而不是粘贴到 Python REPL 本身中。这种行为在 Windows 用户或使用旧机器的用户中尤其明显。

在本迭代中，我们努力减轻并降低了这种行为发生的风险。用户现在发送命令到 VS Code 内的第一个 REPL 实例时，丢失第一个命令的情况有所减少。

添加缺失导入的改进

Pylance 扩展提供了一个 Add Imports（添加导入） 代码操作，用于添加缺失的导入。在 Pylance 的预发布版本中，我们改进了这个代码操作。Pylance 现在使用启发式方法仅显示前三个高置信度的导入选项，并根据以下标准进行优先级排序：最近使用的导入、来自同一模块的符号、来自标准库的符号、来自用户模块的符号、来自第三方包的符号，最后按模块和符号名称排序。

此外，引入了两个新的代码操作：Search for additional import matches（搜索其他导入匹配项），它显示一个快速选择菜单，允许您搜索与缺失导入符号前缀匹配的导入选项；以及 Change spelling（更改拼写），它为因拼写错误而导致的缺失导入提供导入建议。

您现在可以使用 python.analysis.addImport.heuristics 设置启用此行为。我们计划很快将其设为默认行为，并在以后的版本中弃用此设置。

调试 Django 或 Flask 应用程序时自动打开浏览器

使用 Python Debugger 扩展，现在开发和测试您的 Python Web 应用程序更加方便了！通过在 launch.json 配置中设置 autoStartBrowser: true，现在可以在使用 Django 或 Flask 应用程序启动调试器时让浏览器自动打开。

{
  "name": "Python Debugger: Flask",
  "type": "debugpy",
  "request": "launch",
  "module": "flask",
  "env": {
    "FLASK_APP": "hello_app.webapp",
    "FLASK_DEBUG": "1"
  },
  "args": ["run"],
  "jinja": true,
  "autoStartBrowser": true
}

符号链接工作区中 Pytest 的 Bug 修复

我们实现了一个 Bug 修复，使 pytest 测试能够为具有符号链接的工作区正常工作。在测试重写中，来自符号链接位置的测试可以根据其符号链接路径正确引用和运行。

GitHub 拉取请求

GitHub Pull Requests 扩展取得了更多进展，该扩展使您能够处理、创建和管理拉取请求和问题。新功能包括：

从“GitHub Pull Requests and Issues”重命名为“GitHub Pull Requests”
与合并或压缩提交关联的电子邮件可以在合并/压缩时选择
设置 githubPullRequests.labelCreated 可用于配置自动添加到创建的 PR 的标签
现在支持“所有者级别”的 PR 模板
可以在创建 PR 和问题时添加项目

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

预览功能

对于扩展开发者：`@vscode/l10n-dev` 和 Azure AI Translator 预览版

本迭代中，我们引入了一个新命令，即 @vscode/l10n-dev 的子命令，允许您使用 Azure AI Translator 翻译您的字符串。

导出字符串并创建 Azure AI Translator 实例后，您可以设置 AZURE_TRANSLATOR_KEY 和 AZURE_TRANSLATOR_REGION 环境变量，然后运行以下命令以使用 Azure AI Translator 生成翻译

npx @vscode/l10n-dev generate-azure -o ./l10n/ ./l10n/bundle.l10n.json ./package.nls.json

Azure AI Translator 提供免费层级。我们认为这是一个很好的机会，可以为扩展开发者提供工具，以便他们能够更轻松地支持各种使用不同语言的用户。请记住，这些是机器翻译，因此可能并不总是完美的。如果您有能力，它们可以作为从讲该语言的人那里获取更精炼翻译的良好起点。

有关更多信息，请查看关于 Azure AI Translator 集成的 l10n-dev 文档。

扩展开发

扩展中的测试覆盖率

使用测试 CLI 的扩展开发者可以通过更新到最新版本的 @vscode/test-cli 包来生成测试覆盖率。

可以通过在运行测试时传递 --coverage 标志在命令行生成覆盖率，也可以通过在 VS Code UI 中使用 Run with Coverage（使用覆盖率运行） 操作来生成。

launch.json 中的测试配置

您现在可以在 launch.json 配置中引用测试配置文件

{
    "type": "extensionHost",
    "request": "launch",
    "name": "My extension tests",
+   "testConfiguration": "${workspaceFolder}/.vscode-test.js",
-   "args": ["--extensionDevelopmentPath=${workspaceFolder}"]
},

以前必需的各种 args 现在会为您自动生成，但传递的任何其他参数都会追加到 VS Code 的命令行中。

在问题报告器中贡献额外数据

上个迭代中，我们在 workbench.action.openIssueReporter 命令中为 data 和 uri 添加了字段。这使得扩展可以直接以更多预填信息打开原生问题报告器。

为了让扩展能够在通过 Help: Reporter Issues...（帮助：报告问题...） 导航常规问题报告器流程的单独情况下从中受益，扩展可以贡献一个自定义命令（这将调用 openIssueReporter）以及一个指向 issue/reporter 的菜单贡献点。

package.json 中 contributes 的贡献命令和菜单示例

"commands": [
    {
        "command": "extension.myCommand",
        "title": "Report Issue"
    }
],
    "menus": {
        "issue/reporter": [
            {
                "command": "extension.myCommand"
            }
        ]
    }

订阅 issue #196863 以获取有关 API 和 openIssueReporter 命令的更新或更改。

提议的 API

聊天和语言模型 API 即将最终确定

我们一直在致力于支持扩展贡献聊天视图和语言模型的通用使用。我们目前处于最终确定以下 API 的最后阶段，并希望听到您的反馈

聊天参与者 (issue #199908) - vscode.proposed.chatParticipant.d.ts
语言模型使用 (issue #206265) - vscode.proposed.languageModels.d.ts

在我们的扩展指南中了解更多关于如何构建聊天扩展以及如何使用语言模型的信息。

FindFiles2 API

我们添加了一个新的提议扩展 API，它是现有 workspace.FindFiles API 的改进版本。新的 workspace.FindFiles2 API 引入了新的选项，允许工作区文件搜索执行以下操作

遵循 files.exclude 和 search.exclude 设置
遵循忽略文件
执行模糊搜索
遵循符号链接

您可以在此处查看新 API。

请注意，FindFiles2 是一个暂定名称，此功能将来可能会作为 FindFiles 的替代重载提供。

测试覆盖率 API

本迭代中，测试覆盖率 API 和编辑器内体验已处于功能完整状态。我们鼓励扩展开发者试用它们并在其预计于 VS Code 1.88 版本最终确定之前提供反馈。

Extension Pack for Java 已经采用了测试覆盖率 API。开发者现在可以看到运行 Java 测试的覆盖率结果。现在您可以通过选择 Run Test With Coverage（使用覆盖率运行测试） 按钮来获取测试覆盖率，并在测试资源管理器视图中查看 Test Coverage（测试覆盖率） 面板。在团队的 12 月和 1 月更新中了解有关 Extension Pack for Java 测试覆盖率的更多信息。

虽然 API 太长无法在此包含，但我们认为它相当简单，并欢迎您在 issue #123713 中提供有关该提案的输入。

调试可视化 API

我们有一个新的 API，使扩展能够为变量贡献可视化工具。这些可视化工具可以是运行命令的操作（例如打开新编辑器），也可以是嵌入调试视图内联的树，它们取代了数据的默认表示形式。