Visual Studio Code

2023年9月（版本1.83）

更新 1.83.1: 此次更新解决了这些问题。

下载：Windows: x64 Arm64 | Mac: Universal Intel silicon | Linux: deb rpm tarball Arm snap

欢迎来到2023年9月发布的Visual Studio Code。此版本中有许多更新，我们希望您会喜欢，一些关键亮点包括：

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

内部人员：想要尽快尝试新功能吗？您可以下载每晚的内部人员版本，并在更新可用时立即尝试最新更新。

可访问性

GitHub 拉取请求和问题评论改进

GitHub Pull Requests and Issues 扩展，允许您处理、创建和管理拉取请求和问题，在此次迭代中，评论和审查体验的可用性得到了许多改进。

当屏幕阅读器用户打开一个包含评论范围的编辑器时，他们会收到通知。一个新的辅助功能帮助对话框（editor.action.accessibilityHelp）提供了在评论线程和范围之间导航的命令的详细信息。

此外，现在可以访问评论控件。在该上下文中还提供了一个帮助对话框（editor.action.accessibilityHelp），以告知用户可以期待什么以及如何使用该功能。还有新的命令评论：转到下一个评论范围（⌘K ⌥⌘↓ (Windows, Linux Ctrl+K Ctrl+Alt+Down)）和评论：转到上一个评论范围（⌘K ⌥⌘↑ (Windows, Linux Ctrl+K Ctrl+Alt+Up)）用于在评论范围之间导航。

工作台

命令面板中的类似命令结果

找到你想要的命令可能具有挑战性。仅在VS Code中就有超过2000个命令...加上你最喜欢的扩展，这个数字可能会更高。我们想引入一种方法，帮助你在保持命令面板当前提供的速度的同时，找到你正在寻找的内容。为此，我们在命令面板结果中引入了一个名为“类似命令”的新部分。以下是一些示例：

查询不再需要“模糊”匹配即可显示在结果中。例如“切换自动保存”：

'自动保存开启' 和 '切换自动保存' 出现在类似的结果部分

如果有模糊的结果，这些结果仍然会显示在顶部，类似的命令会跟随其后：

用户搜索了'更改语言'，并在类似结果部分显示了'配置显示语言'

扩展贡献的命令也会被识别：

用户搜索了'show git blame'，并且在类似结果部分显示了'toggle file blame'

我们认为这将真正帮助那些难以记住确切命令名称的人...老实说，这几乎是我们所有人都会遇到的问题。

这只是这个新功能的初步版本，仍然需要匹配命令名称中的确切单词。未来，您可以期待以下改进：

  • 基于命令的不可见描述进行命令匹配。
  • 更好地处理基本同义词（"toggle" 和 "turn on/off"，"show" 和 "reveal" 等）

让我们知道您的想法！

个人资料图标

你现在可以将一个图标与配置文件关联起来。这个图标将显示在活动栏中，代替管理齿轮图标。如果你有多个配置文件并希望快速识别当前激活的是哪个配置文件，这将非常有用。

下图显示了在创建新配置文件时的图标选择对话框。

图标选择对话框

活动配置文件图标随后显示在活动栏中。

活动栏中的活动配置文件图标

编辑器标签高度密度

window.density.editorTabHeight 设置允许用户将标签高度减小到更紧凑的尺寸。

默认编辑器标签高度

编辑器标签默认高度

紧凑编辑器标签高度

编辑器标签紧凑高度

固定在单独行的编辑器标签

新增了一个设置项 workbench.editor.pinnedTabsOnSeparateRow。当启用时，固定的标签页 会显示在其他标签页上方的单独一行中。当在标签页行之间拖动时，编辑器标签页会自动固定或取消固定。

在两个标签行之间移动编辑器标签

设置编辑器搜索调整

设置编辑器现在显示更少的搜索结果以减少干扰。如果您安装了GitHub Copilot Chat扩展，除了通过关键字匹配找到的设置外，仅选择前五个Copilot Chat设置匹配项，而不是前十五个。

搜索结果现在也按照设置编辑器目录排序，以在顶部显示常用设置，并按原始顺序显示过滤后的扩展设置。要恢复按匹配类型和分数排序搜索结果，请将workbench.settings.settingsSearchTocBehavior设置为"hide"，清除搜索查询，并开始另一次搜索。

在设置编辑器中搜索“默认格式化程序”会导致editor.defaultFormatter设置出现在顶部。

主题: Light Pink (在 vscode.dev 上预览)

编辑器操作的改进溢出行为

当编辑器操作的数量超过可用空间时，操作会溢出到... 更多操作菜单中。这一逻辑已经得到优化，一些关键操作，如关闭或拆分编辑器，现在被排除在外。这意味着即使可用空间有限，它们也始终可见。

颜色主题选择器现在显示主题标识符

颜色主题选择器现在显示颜色主题的本地化名称及其旁边的字符串标识符。这样做是为了帮助使用非英语语言包但只知道主题英文名称的用户。

韩语中的颜色主题选择器，显示在本地化名称旁边的英文主题标识符

评论

评论编辑器用于扩展程序，例如GitHub Pull Request and Issues扩展，它显示拉取请求的评论。

评论编辑器大小

评论编辑器现在会随着行的增加而扩展，最大高度取决于评论所在编辑器的大小。

评论编辑器随着行数增加而扩展

在未解决的评论上打开评论视图

设置 comments.openView 有一个新的可能值 firstFileUnresolved。设置 firstFileUnresolved 会导致在每次会话中首次打开带有未解决评论的文件时，评论视图会自动打开。

自动折叠已解决的评论

默认情况下，当你解决一个评论线程时，它现在会折叠。可以通过设置 "comments.collapseOnResolve" 来禁用此功能。

编辑器

保存和自动保存时的代码操作

您现在可以在编辑器中启用自动保存时的代码操作。当您保存或自动保存时，窗口更改（onWindowChange）或焦点更改（onFocusChange）会触发代码操作。要启用此功能或更新当前设置，请检查编辑器：保存时的代码操作（editor.codeActionsOnSave）并将每个代码操作的设置更改为always。

设置值也已更新，当前的布尔值将被弃用，转而使用等效的字符串。

选项有：

  • explicit: 当明确保存时触发代码操作。与 true 相同。
  • always: 当显式保存以及窗口或焦点更改时的自动保存时触发代码操作。
  • never: 保存时从不触发代码操作。与 false 相同。

布尔值在此版本中仍然受支持。

笔记本

在笔记本中转到符号

启用notebook.gotoSymbols.showAllSymbols后，转到符号快速选择将填充笔记本中的所有代码符号。

单元格执行时的滚动

你现在可以配置在使用Shift+Enter运行notebook.cell.executeAndSelectBelow时，通过notebook.scrolling.revealNextCellOnExecute设置来显示下一个单元格的多少内容：

  • fullCell - 完整的下一个单元格（默认）。
  • firstLine - 仅第一行。
  • none - 完全不滚动。

"notebook.scrolling.revealNextCellOnExecute": "firstLine" 如下所示。

空白修剪支持

Notebooks 现在遵循现有的三个与空白相关的设置：

  • files.trimTrailingWhitespace - 保存文件时修剪尾随空格。
  • files.trimFinalNewlines - 修剪文件中最后一个换行符之后的所有换行符。
  • files.insertFinalNewline - 自动在文件末尾插入一个最终换行符。

这些设置会在保存时应用，包括自动保存。

最终确定的笔记本代码操作API

Notebooks 现在完全支持贡献的代码操作，并且有一个专门的代码操作类型来支持它们。如果扩展作者定义了一个带有 kind 前缀 notebook.source. 的操作，在保存时，Notebook 编辑器将对整个 Notebook 运行该操作，而不是对每个单元格单独运行。要编辑将在保存时运行的代码操作，您可以在设置编辑器中设置 Notebook: Code Actions on Save 或在您的 settings.json 文件中编辑 "notebook.codeActionsOnSave"。

代码操作的当前启用状态已更新，之前的布尔值已被弃用，转而使用枚举等效值。选项包括：

  • "explicit": 当明确保存时触发代码操作。与 true 相同。
  • "never": 保存时从不触发代码操作。与 false 相同。

第三个选项 "always" 即将推出，以完全匹配编辑器的代码操作，让用户可以在自动保存设置 onFocusChange 和 onWindowChange 时触发笔记本的代码操作。

语言

Perl 6/Raku

Perl 6 语言已更名为 Raku（语言标识符 raku），并且 Raku 将自动被选为 .raku 文件的编程语言。

调试

JavaScript 调试器

WebAssembly 调试

JavaScript 调试器现在可以调试编译成 WebAssembly 的代码，如果它包含 DWARF 调试信息。例如，使用 Emscripten 编译的 C++ 代码可以被调试：

调试器在C++源代码的断点处停止

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

要启用此功能，您需要安装WebAssembly DWARF Debugging扩展，该扩展会插入内置的JavaScript调试器。更多信息请参阅调试WebAssembly。

WebAssembly 调试建立在 Chromium 作者的 C/C++ 调试扩展 之上，并在他们的支持下得以实现。

改进的调用堆栈视图

调用堆栈视图中的方法和函数现在将包括函数（this）上下文的名称。例如，类Foo上的方法bar的调用堆栈现在显示为Foo.bar。

远程开发

Remote Development extensions 允许您使用 Dev Container、通过 SSH 连接的远程机器或 Remote Tunnels，或者 Windows Subsystem for Linux (WSL) 作为全功能的开发环境。

此版本增加了使用隧道连接到开发容器的能力，类似于通过SSH连接。您可以在远程开发发布说明中了解更多关于此新功能的信息。

对扩展的贡献

GitHub Copilot

/tests 的改进

我们已经改进了GitHub Copilot Chat扩展中可用的Chat视图和内联聊天的/tests功能。/test斜杠命令现在能更好地检测您正在使用的测试框架，并以相同的风格生成新的测试。此外，它在为新测试文件建议名称方面应该会更好，例如为foo.py建议test_foo.py，为bar.js建议bar.test.js。

内联聊天支持多轮对话

内联聊天现在保留当前会话的所有提示，这使您可以参考先前的消息并回答问题。

在下面的短视频中，内联聊天记住了用户说过他们位于东京，当提供一个代码片段来计算当地时间以及与苏黎世的时间差时。

GitHub Copilot 默认使用聊天视图

几个月前，我们在命令面板中引入了一个Ask GitHub Copilot选项，这样如果命令面板没有提供有用的答案，您可以在命令面板中提出查询并在Copilot聊天中打开它。

我们收集了关于Ask GitHub Copilot首选体验的反馈：应该打开侧边栏中的聊天视图还是快速聊天。为了使初次体验更加熟悉，我们选择了聊天视图。

话虽如此，如果您希望Ask GitHub Copilot在快速聊天中打开，您可以通过askChatLocation设置更改行为：

"workbench.commandPalette.experimental.askChatLocation": "quickChat"

命令面板类似命令

在这个迭代中，我们在命令面板中推出了相似命令功能。Copilot Chat 用户将获得更好的相似命令体验，因为我们可以使用 Copilot AI 来确定相似性。这些智能功能有助于处理同义词和意图，在我们的测试中，Copilot 还能够处理跨语言的相似性。在命令面板中找到您正在寻找的确切命令从未如此简单！

Jupyter

为扩展作者提供的最终版Jupyter Server Provider API

Jupyter 扩展的用于贡献 Jupyter 服务器的 API 已经最终确定。扩展可以使用该 API 提供自定义 Jupyter 服务器列表，以显示在内核选择器中。

API 使用示例可以在 Jupyter Server Provider Sample 中找到。JupyterHub 扩展 也使用了相同的 API。

npm包@vscode/jupyter-extension包含了所有的TypeScript类型定义。

JupyterHub 扩展

现在有一个JupyterHub 扩展，支持登录JupyterHub并在 VS Code 的笔记本或交互式窗口中执行代码。此扩展也适用于vscode.dev和github.dev中的浏览器。

如果您对这个新扩展有任何问题或希望提供反馈，您可以在JupyterHub扩展GitHub仓库中提交问题。

在Kernel Picker中选择现有的JupyterHub服务器

Python

Python 调试器更新

Debugpy扩展，几个月前宣布，已更名为Python Debugger，以提高在Marketplace中的可发现性。

此扩展现在包括一个新的用户设置 debugpy.debugJustMyCode，当禁用时，它允许您进入系统或第三方库代码以调试所有应用程序（默认情况下，调试器仅进入您自己的Python代码中定义的代码）。对于那些希望更方便地为所有项目禁用 justMyCode 而不是必须在其所有项目的 launch.json 调试配置中手动配置它的人来说，这是一个受欢迎的功能请求。

要尝试它，请确保你已经安装了Python Debugger扩展。然后打开设置编辑器（⌘, (Windows, Linux Ctrl+,)），搜索“debugJustMyCode”，并禁用复选框：

在设置编辑器中搜索 "debugJustMyCode" 会导致 debugpy.debugJustMyCode 设置出现在顶部。

现在，一旦你创建了一个launch.json文件，扩展默认使用debugpy.debugJustMyCode的值，只要文件中没有指定justMyCode。请注意，当launch.json中指定了justMyCode时，它的值优先于debugpy.debugJustMyCode设置。

Pylint 扩展的更改时 Lint 选项

默认情况下，Pylint 扩展仅在文件保存时报告错误和警告。现在有一个名为 pylint.lintOnChange 的新设置，如果将其设置为 true，则指示扩展在您输入时报告错误和警告，而无需保存文件。

Mypy 扩展报告范围和守护模式

Mypy Type Checker 扩展现在有两个新设置，允许您指定 Mypy 的报告范围以及是否使用 Mypy 的守护进程。

第一个是mypy-type-checker.reportingScope，可以设置为file（默认值）以仅对工作区中打开的文件报告问题，或设置为workspace以对工作区中的所有文件启用报告。

第二个是mypy-type-checker.preferDaemon，当设置为true时，使用Mypy的守护进程（dmypy）而不是Mypy本身（mypy）来执行类型检查，这在某些情况下可能会快得多。

更新调用参数内联提示设置

之前，Pylance的设置用于启用部分调用参数的内嵌提示（python.analysis.inlayHints.callArgumentNames）只能设置为true或false来启用或禁用调用参数的类型提示。此设置已被修改，以允许对显示的调用参数类型提示进行更细粒度的控制。

现在可以设置为partial以禁用仅位置和仅关键字参数的提示，all以启用它们，或off以完全禁用它们。

弃用 Python 3.7 支持

正如我们在2023年7月的发布博客中提到的，我们已经在Python扩展中放弃了对Python 3.7的官方支持。目前没有计划主动移除对Python 3.7的支持，因此我们预计在可预见的未来，该扩展将继续非正式地与Python 3.7一起工作。

请记住，所有其他Python版本现在都采用年度发布节奏，因此，我们预计一旦某个Python版本在下一个日历年的第一个扩展版本中达到EOL（例如，Python 3.8计划在2024年10月达到EOL），我们将停止对该版本的官方支持。

GitHub 拉取请求和问题

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

  • 审查PR的可访问性已得到改进。
  • 即使分支尚未发布，提交也会显示在创建视图中。

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

预览功能

最近的快速修复键盘快捷键

有一个新的设置可以从⌘. (Windows, Linux Ctrl+.) (命令ID editor.action.quickFix)激活一行中的最近快速修复，无论光标在该行的哪个位置。

该命令突出显示将使用快速修复进行重构或修复的源代码。普通代码操作和非修复重构仍然可以在光标位置激活。要启用此功能，请勾选代码操作小部件：包括附近的快速修复 (editor.codeActionWidget.includeNearbyQuickfixes)。

新快速修复行为的示例，显示在最近的错误上激活，并展示如何在光标位置仍然可以使用所有代码操作

源代码控制同步视图

此里程碑的发布包含了源代码控制同步视图的早期版本。新视图提供了有关尚未推送到远程分支的本地更改（传出）和尚未从远程分支拉取到本地的更改（传入）的详细信息。该视图还允许您发布分支并与远程分支同步更改（拉取/推送）。新视图仍处于实验阶段，我们将根据用户反馈在未来的里程碑中继续改进它。您可以通过scm.experimental.showSyncView设置显示新视图。请尝试并提供反馈在问题 #192290中。

源代码控制同步视图显示传入更改的差异视图

命令中心和调试工具栏

有一个新的实验性设置，可以在命令中心内显示调试工具栏。确保启用了命令中心并配置了debug.debugToolbarLocation设置：

"debug.toolBarLocation": "commandCenter"

命令中心内的调试控制

主题: GitHub Light Colorblind (Beta) (在 vscode.dev 上预览)

扩展开发

支持用于字符串设置验证的Unicode字符类转义

Unicode 字符类转义 现在在正则表达式中得到支持，用于验证字符串和字符串数组设置。换句话说，字符串和字符串数组设置现在可以指定一个 pattern 字段，其值如 "\\p{Letter}+"，允许仅包含字母的字符串值。

目前不支持在具有字符串值的对象设置中使用Unicode字符类转义。

贡献给终端菜单

有两个新的菜单可以贡献给terminal/context和terminal/title/context，它们分别向终端上下文菜单和终端标签上下文菜单添加条目。示例用法：

{
  "contributes": {
    "menus": {
      "terminal/context": [
        { "command": "terminalTest.sendText" }
      ],
      "terminal/title/context": [
        { "command": "terminalTest.sendText" }
      ]
    }
    }
}

新的 env.onDidChangeShell 事件

有一个新的env.onDidChangeShell: Event事件，当env.shell的值发生变化时触发。

keytar 已从 VS Code 中移除

早在六月，我们将SecretStorage API迁移到了使用Electron的safeStorage，并包含了一个废弃和移除计划，针对现在已归档且不再维护的keytar模块从VS Code中移除。我们最初没有移除keytar，因为一些扩展仍然直接导入/需要keytar（这是在SecretStorage API存在之前推荐的，但在SecretStorage API发布后不再推荐）。

根据产品遥测数据和没有keytar的Insiders构建，keytar的使用率已经下降，我们准备从VS Code中完全移除keytar。

这对我的扩展意味着什么？

如果您使用SecretStorage API，无需任何操作。自六月以来，我们一直在将密钥从keytar迁移出去，因此如果您的密钥在过去两个月内被访问过，它们应该已经全部迁移完毕。

如果您仍然在扩展中直接使用keytar，有几个选项供您考虑：

  • （推荐） 使用 VS Code 在 ExtensionContext 上提供的 SecretStorage API。此 API 是跨平台的，适用于 VS Code 支持的所有平台。它由 VS Code 团队维护，将继续得到维护，并且多年来一直是 VS Code API 的一部分。
  • （不推荐） 你可以将 keytar 模块与你的扩展捆绑在一起。请记住，keytar 是一个原生的 node 模块，这意味着你需要为每个你想支持的平台 发布一个特定平台的扩展。

--disable-keytar 已更名为 --use-inmemory-secretstorage

当使用SecretStorage API时，--disable-keytar标志禁用了在机器上持久化秘密的功能。这主要用于CI环境中，这些环境通常没有配置密钥环，因为如果没有它，当使用SecretStorage API而没有可用的密钥环时，VS Code会抛出错误。

由于我们已经移除了keytar，这个标志需要一个新名称。我们现在已将--disable-keytar标记为弃用，推荐使用--use-inmemory-secretstorage。未来，我们将考虑移除--disable-keytar，但在不久的将来它不会消失。

最后，我们要感谢所有迅速采取行动，从keytar迁移并确保他们的用户在VS Code中拥有良好且安全的秘密体验的出色扩展作者！

语言服务器协议

新版本的语言服务器协议 npm 包已经发布（protocol@3.17.5, client@9.0.1 和 server@9.0.1）。

发布的亮点包括：

  • 添加了提议的内联完成请求。

  • 添加了建议的格式化范围请求。

  • 添加了折叠范围的刷新请求提议。由于API需要暴露事件发射器，这改变了折叠范围功能的形态，并且是一个破坏性变更。要访问提供者，你现在需要使用以下代码：

    client.getFeature(lsclient.FoldingRangeRequest.method).getProvider(document)?.provider;

  • 各种错误修复。

工程

浮动编辑器窗口探索

我们已经开始探索如何将编辑器从工作台窗口中拉出到它们自己的窗口中。这个功能是我们最高投票的功能请求，我们计划在十月份为我们的Insiders用户提供一个可用的初步版本。

所有窗口中的所有编辑器都在相同的基础编辑器模型上操作，因此在一个窗口中进行的更改会实时反映在所有其他窗口中。您可以在浮动窗口中创建任何编辑器布局，并在任意数量的窗口中打开您喜欢的任何编辑器。

对于我们第一个工作版本，我们设想状态栏也会出现在浮动窗口中，以便显示编辑器信息——例如行号和选择范围。敬请期待未来几个月的更多开发进展！

vscode.dev 现在已跨源隔离

跨源隔离现已为vscode.dev启用。这使得新的强大功能成为可能，如共享数组缓冲区，这是跨文件TypeScript支持、Web中的Python执行以及vscode-wasm-wasi的基础。

设置同步故障排除

我们新增了一个开发者命令Developer: Download Settings Sync Activity，用于下载您在云端和本地机器上的所有设置同步活动，包括日志。这将帮助我们排查设置同步的问题。我们还创建了一个新的视图来浏览下载的活动。您可以通过运行命令Settings Sync: Show Synced Data并启用SYNC ACTIVITY (DEVELOPER)视图来打开该视图。您可以通过在视图中选择Load Sync Activity按钮来加载下载的同步活动，如下所示。

同步活动（开发者）视图与加载同步活动按钮

显著的修复

  • 190679 主题颜色 icon.foreground 不一致且不适用于 .svg

感谢您

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

问题跟踪

对我们问题跟踪的贡献：

拉取请求

对 vscode 的贡献：

对 vscode-css-languageservice 的贡献：

对vscode-html-languageservice的贡献：

对vscode-languageserver-node的贡献：

对 vscode-pull-request-github 的贡献：