在 VS Code 中试试

2024 年 2 月(版本 1.87)

更新 1.87.1:此更新解决了这些问题

更新 1.87.2:此更新解决了此安全问题

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

欢迎来到 Visual Studio Code 2024 年 2 月版本。此版本有许多我们希望您会喜欢的更新,其中一些主要亮点包括

如果您想在线阅读这些发行说明,请访问 code.visualstudio.com 上的更新页面。Insiders 版本: 想尽快尝试新功能吗?您可以下载每日更新的 Insiders 版本,并在最新更新可用时立即试用。

可访问性

在编辑器中使用听写

现在,您可以直接在编辑器中使用声音进行听写,前提是您已经安装了 VS Code Speech 扩展。

我们添加了新的命令来启动和停止编辑器听写:语音: 在编辑器中启动听写 (⌥⌘V (Windows, Linux Ctrl+Alt+V)) 和 语音: 在编辑器中停止听写 (Escape)。

您可以按住启动命令的快捷键 (⌥⌘V (Windows, Linux Ctrl+Alt+V)) 来启用对讲机模式,即当您释放按键时语音识别立即停止。

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

语音识别支持多种语言

使用 VS Code Speech 扩展时,您现在可以使用 accessibility.voice.speechLanguage 设置从 26 种支持的语言中选择一种。

语音扩展的每种语言都作为其自己的扩展提供。首次启动语音识别时,您将看到为所选每种语言安装扩展的提示。

可访问性信号

可访问性信号包括声音(以前称为音频提示)和通知(以前称为警报)。

命令 帮助:列出信号声音帮助:列出信号通知 允许用户查看可用的信号并对其进行配置。迁移到此新配置会自动发生。

之前

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

之后

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

工作台

发行说明中的交互式设置

为了让您更轻松地开始使用新功能,您现在可以直接从发行说明中启用或查看设置。当您在 VS Code 中查看发行说明(显示发行说明 命令)时,请注意某些设置旁有一个齿轮图标。选择该设置或齿轮图标即可立即与该设置进行交互。

Example of an interactive setting in release notes

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

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

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

我们发现管理语言模型访问与在 VS Code 中管理对您的 GitHub 帐户或 Microsoft 帐户(或任何利用 AuthenticationProvider 模型的内容)的访问非常相似。由于这些相似性,我们也利用了 VS Code 的身份验证堆栈来访问语言模型。

当某个扩展想要访问另一个扩展的语言模型时,它们将看到一次性的访问提示,该提示将持久存在:显示扩展需要语言模型访问的模态对话框

授予访问权限后,您将可以在与管理帐户访问权限相同的位置(即帐户菜单中)管理该访问权限。

Manage trusted extensions options in the account menu

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

Manage trusted extensions quick pick

在完成初步工作后,我们将继续完善用户体验,使其尽可能流畅和清晰。

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

您可以在扩展编辑器和运行时扩展编辑器中跟踪扩展的语言模型使用情况。以下图像显示了 Copilot Chat Sample Extension 对 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

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

添加了新的命令来放大、缩小和重置终端字体大小。这些命令默认没有绑定快捷键,但您可以将它们绑定到您喜欢的快捷键。

  • 终端:增加字体大小 (workbench.action.terminal.fontZoomIn)
  • 终端:减小字体大小 (workbench.action.terminal.fontZoomOut)
  • 终端:重置字体大小 (workbench.action.terminal.fontZoomReset)

源代码管理

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

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

提交输入验证改进

在本次迭代中,我们探索了使用语言诊断来为提交消息的编写提供更好的输入验证。使用语言诊断使我们能够显示可调用的代码操作来解决输入验证警告。我们添加了代码操作来移除空白字符,根据 git.inputValidationSubjectLengthgit.inputValidationLength 设置对行进行硬换行,并且我们正在寻求在未来添加更多代码操作。

要启用此功能,请切换 git.inputValidation 设置。我们在默认启用此功能之前还有一些问题需要解决,但与此同时,您可以随意启用它并向我们提供反馈。

传入/传出更改设置管理

我们继续完善源代码管理视图的传入/传出部分。在本次迭代中,我们在“传入/传出”分隔符中添加了一个设置操作,允许用户更轻松地切换 scm.showIncomingChangesscm.showOutgoingChangesscm.showChangesSummary 设置。这些操作也可以在源代码管理视图标题栏的 ... 菜单中的传入和传出菜单中找到。

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

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

Notebooks

Notebook 的缩进设置

我们现在通过 notebook.editorOptionsCustomizations 设置支持 Notebook 特定的缩进设置。此设置允许用户通过 editor.tabSizeeditor.indentSizeeditor.insertSpaces 设置为 Notebook 设置特定的缩进样式。

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

调试

支持新的 BreakpointMode

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

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 设置将其配置为始终打开或关闭。

此外,现在可以使用键盘快捷键 F7Shift+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 扩展时,命令 语音: 启动语音聊天 (⌘I (Windows, Linux Ctrl+I)) 现在在任何地方都有效,并根据您的焦点位置(编辑器中的行内聊天,否则是面板聊天)显示语音聊天。

要启用对讲机模式,请按住快捷键。语音识别将一直处于活动状态,直到您释放按键,之后请求将自动提交。

基于光标位置的 Copilot: 解释此内容

之前,在聊天中输入 解释此内容 需要您首先在活动编辑器中选择要解释的文本。现在,您还可以将光标放在标识符上,让 Copilot 查看标识符的定义。如果定义位于另一个文件中,则需要丰富的语言支持。

预览:#codebase 变量

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

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

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

重申一下,这仅存在于 GitHub Copilot Chat 的预发布版本中。请告诉我们您的想法以及您如何使用它!

终端工作区上下文

终端不再自动拉取工作区上下文,这可能需要一些时间。相反,您需要使用 #codebase 变量明确地包含它。

终端聊天位置

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

Jupyter

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

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

Failed language features for remote Jupyter Servers

在本次迭代中,Jupyter 扩展会检测连接的 Jupyter Server 是本地的还是远程的。这使得 Pylance 扩展能够根据安装的包(在本地 Python 环境中)提供更丰富的语言功能。

Language features for remote Jupyter Servers

Python

Python REPL 的 Shell 集成

现在,我们通过 WSL 扩展在 Mac、Linux 和 Windows 上启用了 Python REPL 的 shell 集成。当您在 Python REPL 中执行命令时,彩色圆点装饰器会指示命令是成功还是失败。此外,我们还支持 Python REPL 的 终端:运行最近的命令... 命令,该命令使您能够查看和使用 REPL 的命令历史记录。

我们现在还支持所有操作系统的 Python shell 文件历史记录,可通过 终端:运行最近的命令 访问。

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

之前,一些 Python REPL 用户注意到他们在向 Python REPL 发送第一个命令时(例如,使用 Shift+Enter)出现了问题。他们的 Python 命令要么被忽略,没有发送到 Python REPL,要么在启动 Python REPL 的 shell 中被多次粘贴,而不是在 Python REPL 本身中。这种行为特别发生在 Windows 用户或使用旧机器的用户身上。

在本次迭代中,我们努力缓解和降低这种行为发生的风险。现在,用户在将他们的 Python 命令发送到 VS Code 中的第一个 REPL 实例时,第一个命令丢失的情况会减少。

改进了添加缺失导入的功能

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

此外,还引入了两个新的代码操作:搜索其他导入匹配项,该操作显示一个快速选择菜单,允许您搜索与缺失导入符号前缀匹配的导入选项;以及 更改拼写,该操作为因拼写错误而缺失的导入提供导入建议。

您现在可以使用 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 拉取请求 扩展取得了更多进展,该扩展使您能够处理、创建和管理拉取请求和议题。新功能包括

  • 从“GitHub 拉取请求和议题”更名为“GitHub 拉取请求”
  • 合并或挤压提交关联的电子邮件可以在合并/挤压时选择
  • 设置 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_KEYAZURE_TRANSLATOR_REGION 环境变量,然后运行以下命令以使用 Azure AI Translator 生成翻译:

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

Azure AI Translator 提供免费层级。我们认为这是一个很好的机会,可以为扩展作者提供工具,使他们能够更轻松地支持讲各种语言的众多用户。请记住,这些是机器翻译,因此可能并非总是完美。如果您有能力进行人工翻译,它们可以成为获得更精确翻译的良好起点。

更多信息,请查看l10n-dev 文档中关于 Azure AI Translator 集成的内容。

扩展创作

扩展中的测试覆盖率

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

可以在运行测试时通过传递 --coverage 标志在命令行生成覆盖率,也可以在 VS Code UI 中使用 带覆盖率运行 操作生成覆盖率。

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 命令中添加了 datauri 字段。这使得扩展可以直接打开原生问题报告器,并预填充更多信息。

为了让扩展在通过 帮助:报告问题... 导航正常问题报告流程的独立情况下也能从中受益,扩展可以贡献一个自定义命令(该命令将调用 openIssueReporter)和一个菜单贡献点到 issue/reporter

package.jsoncontributes 的贡献命令和菜单示例

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

订阅议题 #196863 以获取 API 和 openIssueReporter 命令的更新或更改。

提议的 API

聊天和语言模型 API 接近最终确定

我们一直在努力支持扩展对聊天视图的贡献以及语言模型的一般使用。我们现在正处于最终确定以下 API 的最后阶段,非常希望听到您的反馈。

在我们的扩展指南中了解如何构建聊天扩展以及如何使用语言模型

FindFiles2 API

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

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

您可以在此处查看新 API。

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

测试覆盖率 API

本次迭代中,测试覆盖率 API 和编辑器内体验已达到功能完备状态。我们鼓励扩展作者在 VS Code 1.88 版本中最终确定之前试用它们并提供反馈。

Java 扩展包已经采用了测试覆盖率 API。开发人员现在可以查看运行 Java 测试的覆盖率结果。现在,您可以通过选择 运行带覆盖率测试 按钮,并在测试资源管理器视图中查看 测试覆盖率 面板来获取测试覆盖率。在团队的12 月1 月更新中了解有关 Java 扩展包测试覆盖率的更多信息。

虽然此处的 API 过长无法全部包含,但我们相信它相当直接,并且欢迎您在议题 #123713 中提供关于该提议的意见。

调试可视化工具 API

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

您可以在此处查看新 API。

新的符号名称提供程序 API

此 API 允许扩展在用户想要重命名符号时提供名称建议。

值得注意的修复

  • 184046 终端中的链接有时会完全停止工作

感谢

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

问题跟踪

对我们的问题跟踪的贡献

拉取请求

vscode 的贡献

vscode-black-formatter 的贡献

vscode-hexeditor 的贡献

vscode-isort 的贡献

vscode-languageserver-node 的贡献

vscode-pull-request-github 的贡献

language-server-protocol 的贡献

node-pty 的贡献