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

2023 年 11 月 (版本 1.85)

更新 1.85.1：本次更新解决了这些问题。

更新 1.85.2：本次更新解决了这些问题。

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

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

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

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

GitHub Universe、Copilot 和 VS Code

如果您今年能够观看或参加 GitHub Universe，您会看到 GitHub Copilot 是焦点。Copilot 出现在 开幕主题演讲 和分组会议中，例如 GitHub Copilot：当今和未来的 AI 结对程序员。

VS Code 团队一直在努力将 Copilot 集成到编辑器中，您可以在最近的 VS Code 中追求“极致智能” 博客文章中了解团队在 GitHub Universe 之前的进展。该文章详细介绍了 Copilot Chat 代理的开发，它们充当代码库和技术的主题专家，并描述了扩展作者如何能够向 VS Code 贡献他们自己的自定义代理。

辅助功能

可访问视图

上一次迭代，我们引入了在按下按键时自动关闭辅助功能视图的功能，以实现 UI 组件与其辅助功能视图之间的无缝流。在某些情况下，此行为可能不尽如人意，现在可以通过 accessibility.accessibleView.closeOnKeyPress 设置禁用。

如果您发现自己在终端和终端的辅助功能视图之间切换，您可能希望启用 terminal.integrated.accessibleViewFocusOnCommandExecution，这会在终端中执行命令后自动打开辅助功能视图。

键盘焦点显示工具提示

为了改善键盘用户体验，现在对于具有自定义悬停的项目（例如活动栏和状态栏项目），在键盘焦点上会显示工具提示。

Tooltip for Extensions view icon in the Activity Bar

语音检测超时

新设置 accessibility.voice.speechTimeout 控制在接受语音输入（例如对 Copilot Chat）之前等待静默的时间。默认情况下，语音输入会在静默 1.2 秒后自动提交。您可以将其设置为 0 以完全禁用接受语音输入。

工作台

浮动编辑器窗口

我们很高兴地宣布，在此版本中，您可以将编辑器从主窗口移动到自己的轻量级窗口中。在一个窗口中对编辑器所做的更改会立即应用于打开该编辑器的所有其他窗口。

创建浮动编辑器窗口最简单的方法是将编辑器从当前窗口拖出并将其放到桌面上的空白区域

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

新的 workbench.editor.dragToOpenWindow 设置可以禁用此行为。

还有新的全局和上下文命令可将编辑器和编辑器组移动或复制到它们自己的窗口中

  • 视图：将编辑器复制到新窗口 (workbench.action.editor.copyWithSyntaxHighlightingAction)
  • 视图：将编辑器移动到新窗口 (workbench.action.editor.moveEditorToNextWindow)
  • 视图：将编辑器组复制到新窗口 (workbench.action.editor.copyGroupToNextWindow)
  • 视图：将编辑器组移动到新窗口 (workbench.action.editor.moveGroupToNextWindow)
  • 视图：新建空编辑器窗口 (workbench.action.newWindow)

浮动窗口中的编辑器区域可以以您想要的任何复杂布局进行排列。由于终端和搜索结果都可以作为编辑器打开，因此您现在也可以在单独的窗口中拥有这些功能！

Terminal and Search as editors in a floating window

试用此新功能并报告您遇到的任何问题。请务必查看我们现有问题并对缺失功能投票。

文件资源管理器中原生粘贴支持

VS Code 现在支持将文件从操作系统的资源管理器原生粘贴到 VS Code 文件资源管理器中。

扩展自动更新控制

您现在可以选择要自动更新的扩展。如果您不想自动更新所有扩展，而是选择性地选择要自动更新的扩展，这将非常有用。您可以选择一个扩展或来自同一发布者的所有扩展。如果您选择自动更新来自同一发布者的所有扩展，则可以取消选择该发布者的单个扩展。

Choose extensions to auto update

您应该禁用自动更新（无）或为选定的扩展启用自动更新（选定扩展）才能使用此功能。

Auto update mode options with Selected Extensions checked

新配置文件图标

以下新配置文件图标可添加到您的配置文件中。

New Profile icons

  • VR
  • 钢琴
  • 咖啡
  • 蛇
  • 机器人
  • 游戏
  • 芯片
  • 音乐

设置编辑器搜索改进和错误修复

设置编辑器现在再次按匹配类型排序搜索结果，而不是仅按目录排序。换句话说，标题和关键字匹配会显示在顶部，因此您不必向下滚动即可找到匹配标题的设置。

Settings editor showing the windows.titleBarStyle setting appearing first when searching "title bar style"

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

设置编辑器仍按目录对设置进行排序以解决平局，这意味着扩展作者的 order 键在搜索查询（例如 @ext:）中受到尊重。

此迭代还修复了许多设置编辑器回归问题，包括由于网络问题导致设置编辑器无法加载以及在某些搜索查询中挂起的问题。

编辑器

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

您现在可以在编辑器中启用自动保存时的代码操作，并且编辑器：保存时的代码操作 (editor.codeActionsOnSave) 设置已迁移到相应的枚举值。当设置为 always 时，当您保存或通过窗口更改 (onWindowChange) 或焦点更改 (onFocusChange) 自动保存时，可以运行代码操作。要启用此功能，请勾选编辑器：保存时的代码操作 (editor.codeActionsOnSave) 并将每个代码操作的设置更改为 always。

设置值更新如下，之前的布尔值将被弃用，转而使用等效的字符串值。

选项包括

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

多文档高亮

多文档高亮通过新的提议的 MultiDocumentHighlightProvider API 获得了额外支持。现在 TypeScript 语言内置了语义出现高亮支持，可以通过将编辑器：出现高亮 (editor.occurrencesHighlight) 设置值从 singleFile 更改为 multiFile 来启用。对于 TypeScript 以外的语言，多文档出现会根据文本出现而非语义出现进行高亮，直到实现更多特定于语言的提供程序。

源代码管理

传入/传出更改

此里程碑中，我们在“源代码管理”视图中引入了一个新的“传入/传出”部分，用于显示当前分支与其远程分支的传入和传出更改。新部分显示了单个更改，包括更改的资源数量以及插入和删除，以及一个“所有更改”条目，总结了所有更改中的所有资源。可以使用 scm.showIncomingChanges 和 scm.showOutgoingChanges 设置控制新部分的可见性。这两个设置都支持以下值：always、auto（默认）和 never。

Incoming/Outgoing changes in the Source Control view

输入最大行数

以前，“源代码管理”输入会自动增长以显示最多 6 行文本，这对于大多数提交消息来说是足够的空间。但是，在某些情况下，更多空间会有帮助，并且有一个新设置 scm.inputMaxLines，它控制“源代码管理”输入的最大行数。

终端

粘性滚动

粘性滚动已在终端中实现！利用shell 集成提供的知识，视口顶部命令的提示会粘在终端顶部，类似于粘性滚动在编辑器中的工作方式。

Running 'ls' command in the terminal will show the 'ls' prompt at the top of the terminal

单击粘性滚动元素将滚动到终端缓冲区中的该部分。

此功能目前默认禁用，但可以通过设置 "terminal.integrated.stickyScroll.enabled": true 来启用。我们计划在未来默认启用此功能，届时您可以通过右键单击并将其关闭来选择退出。

命令高亮

现在，将鼠标悬停在终端中的命令上会在其左侧显示一个高亮条。这对于不清楚一个命令在哪里开始和另一个命令在哪里结束的普通终端提示非常有用。

Hovering a command will show a line to the left that highlights the command and its output

Shell 集成和命令导航改进

随着 Sticky Scroll 的引入，shell 集成得到了许多改进。特别是在 Windows 上运行的终端，从 shell 集成接收到的标记并不是完全可靠。现在有逻辑可以智能地扫描终端内容并在使终端命令可用之前调整标记。

Shell 集成现在也能够检测到提示的不同部分；提示及其输入。这决定了在使用 Sticky Scroll 时显示命令的哪一部分。这还将从提示顶部删除空行，这通常用于分隔输出并使终端更易于阅读。

现有的命令导航功能也受益，因为您可以导航到用于 Sticky Scroll 的更可靠的提示，而不是不太可靠的提示行。

之前

Before only a single line would be highlighted

之后

When navigating commands, the entire prompt is now highlighted

改进的下划线渲染

终端中的虚线和点划线现在以像素完美模式渲染

Dotted and dashed underlines are now pixel perfect

The underline improvements also work when zoomed in

Git 拉取快速修复

如果 Git 分支检出可以快进，则新的终端快速修复提供了运行 git pull 的选项。

任务

现在可以将 npm.packageManager 设置为 bun，以启用 Bun 脚本的检测和运行，该脚本定义在 package.json 中。

调试

JavaScript 调试器

可视化堆快照

V8 堆快照（保存为 .heapsnapshot）现在可以在 VS Code 中可视化。既有传统的表格视图，也有给定内存对象保持器的图形表示。

Graphical view of a heap snapshot showing references to a specific memory object

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

在调试任何 JavaScript 代码时，可以使用获取性能配置文件命令捕获堆快照。它们也可以通过浏览器 DevTools 中的内存选项卡捕获。

改进的事件侦听器断点视图

当调试 Microsoft Edge 或 Google Chrome 浏览器时显示的“事件侦听器断点”视图已得到改进。它现在是一个复选框列表，并支持根据 URL 暂停 XHR/fetch 请求。

Event Listener Breakpoints view with "XHR/fetch URL" checked and "Add new URL" option highlighted

使用 Rust 进行 WebAssembly 调试

VS Code 和 wasm-bindgen 都进行了更改，允许在 VS Code 中调试编译为 WebAssembly 的 Rust。有关更多信息，请参阅我们关于WebAssembly 调试的文档。

测试

现在“测试结果”视图终端支持“查找”控件。

语言

TypeScript 5.3

此版本包含 TypeScript 5.3。此重大更新增加了对导入属性、更好的类型收窄等的支持。它还包含新的语言工具功能和错误修复。

您可以在 TypeScript 博客中阅读有关 TypeScript 5.3 的更多信息。

node_module 符号排除在工作区符号搜索之外

默认情况下，转到工作区中的符号现在会排除 node_modules 中的符号。这使得更容易在代码中查找符号，而不会被已安装包中的符号淹没。

您可以通过设置 "typescript.workspaceSymbols.excludeLibrarySymbols": false 恢复到包含项目中所有符号的先前行为。

内联提示的跳转到定义

JavaScript 和 TypeScript 内联提示中的类型现在是交互式的。通过将鼠标悬停在类型上，并在 Windows 和 Linux 上按住 Ctrl 或在 macOS 上按住 Cmd 的同时单击，可以快速跳转到类型的定义

Inlay hint hover showing Go to Definition by using Ctrl/Cmd + click

自动导入时优先使用“type”

仅类型导入允许您导入类型，同时确保导入在运行时完全擦除。如果您喜欢始终默认使用 type 导入，您现在可以设置 "typescript.preferences.preferTypeOnlyAutoImports": true，并且自动导入将使用仅类型导入。此设置默认关闭。

远程开发

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

亮点包括：

  • 在开发容器中自动安装 GitHub Copilot 和 拉取请求和问题 扩展。
  • 更精细地控制哪些扩展安装在开发容器中。
  • 在本地开发容器和 WSL 会话中重用本地机器证书。

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

对扩展的贡献

GitHub Copilot

内联聊天 UI 改进

内联聊天提示历史记录现在在 VS Code 会话之间持久保存。查看上一个和下一个提示的键盘快捷键也已更改为 上 和 下，以与其他 VS Code 中的上一个和下一个项目快捷键对齐。

当内联聊天建议创建新文件时（例如使用 /test 斜杠命令时），您现在可以通过从“创建”下拉菜单中选择“创建为”来选择文件名和位置。

Create and Create As actions for newly suggested files from inline chat

最后，内联聊天有一个新的实验性轻量级 UI 模式。它提供更流畅的流式传输体验，并且仅按需渲染差异。您可以通过 "inlineChat.mode": "live3" 设置启用它。

Inline chat lightweight mode with diff on demand

修复的内联聊天显示摘要和后续操作

当使用内联聊天进行修复 (/fix) 时，您现在还会获得一个简短的修复内容摘要。如果仍然存在错误，您可以通过单击提供的后续操作来完善修复。

Inline chat with summary

内联聊天中的渐进式消息渲染

内联聊天现在使用与聊天视图相同的渐进式渲染

Inline chat progressive rendering

终端生成提交消息快速修复

上一个版本，在源代码管理视图输入框中添加了 Copilot 生成提交消息“闪光”。对于终端用户，现在有一个快速修复，可以在运行 git add... 命令后在终端中生成可编辑的提交消息。

终端代理和命令建议改进

所有与终端相关的功能都已移至 @terminal 代理。这样做是为了明确终端代理可能不会引入工作区信息，从而整合功能并使其更方便使用。

以下是旧提示到新提示的映射

旧 新
@workspace /terminal 如何列出文件？ @terminal 如何列出文件？
@workspace /explain #terminalSelection @terminal #terminalSelection
@workspace /explain #terminalLastCommand @terminal #terminalLastCommand

此外，此版本中的命令建议也得到了显著改进。终端命令建议现在了解操作系统和所使用的 shell。工作区信息也会根据 Copilot 是否认为问题与工作区相关而有条件地引入。工作区上下文收集应该会进一步改进，无论是在速度方面还是在引用内容方面。

Progress is displayed while fetching workspace details

请注意在此示例中，@terminal 代理如何知道在 microsoft/vscode 存储库中使用文件路径的形成方式

The terminal agent is capable of answering questions that need knowledge about file naming standards in the repository

还有方便的后续操作来解释建议的命令，这些命令以蓝色闪光链接的形式呈现在聊天输入框上方

The blue sparkle link just before the input box explains the suggestion

激活“解释”后续操作会提供建议命令的详细解释

The detailed explanation typically explains the command and each argument

在使用 GitHub 远程搜索私有仓库功能时进行身份验证升级对话框

如果您的用户帐户已启用，当您使用 @workspace 代理时，Copilot Chat 会使用远程搜索功能搜索您的工作区。为了使用私有仓库进行远程搜索，需要具有更多权限的身份验证令牌。如果尚无所需权限的令牌，系统会提示您请求附加权限

Authentication dialog when searching the workspace

您只会看到此对话框一次，将来对 @workspace 代理的查询将使用缓存的令牌。

更轻松地向 @workspace 发送请求

由于 @workspace 代理在许多 Copilot 查询中使用，我们希望确保它尽可能容易激活。您现在可以在聊天输入中键入一个问题，然后按 发送问题并自动预置 @workspace。

用 Copilot 解释 Rust 代码

当您要求 Copilot Chat 解释 Rust 代码并安装了 Rust 语言服务扩展（例如 rust-analyzer）时，它现在会从您的代码库中收集跨文件上下文。要查看 Copilot 解释，请在活动编辑器中选择一些代码，然后从上下文菜单中使用“Copilot > 解释此内容”或从内联聊天或聊天视图中使用 /explain。

Copilot > Explain This action in the editor context menu

代码块中的潜在漏洞检测

我们希望确保您了解 Copilot 生成的源代码可能存在的任何问题，因此我们现在正在通过代码漏洞检测模型运行聊天视图代码块中的代码，并标记任何检测到的问题。您可能一开始不会看到此功能，但我们将逐步将其推广到 Copilot Chat 用户，并调整检测到的漏洞类型。

当一个代码块被确定包含潜在漏洞时，它将在代码块底部进行标注。我们正在试用这个漏洞检测模型，因此在审查 Copilot 的建议和任何潜在漏洞时，请务必做出最佳判断。

Copilot code vulnerability warning displayed in the Chat view

Copilot 视频和直播会话

不要错过 YouTube 上最近的 VS Code Copilot 视频。了解 最新的 Copilot Chat 功能 以及 Copilot 如何“变得更智能”。

如果您还没有收看 VS Code 直播，您会想观看 1.84 发布派对中展示的 Copilot 演示。

Python

使用 Pylance 显示类型层次结构

现在，使用 Pylance 时，您可以更方便地探索和导航 Python 项目的类型关系。这在处理具有复杂类型关系的大型代码库时非常有用。

当您右键单击符号时，可以选择“显示类型层次结构”以打开类型层次结构视图。从那里，您可以导航符号的子类型以及超类型。

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

“运行”按钮菜单下的可配置调试选项

Python 调试器扩展现在在“运行”按钮菜单下有一个可配置的调试选项。当您选择“Python 调试器：使用 launch.json 调试”并且您的工作区中存在现有的 launch.json 时，它会显示所有可用的调试配置，您可以选择其中一个来启动调试器。如果没有配置，系统会提示您选择一个调试配置模板，用于为您的 Python 应用程序创建 launch.json 文件。

Python Debugger: Debug using launch.json option under the Run button menu

使用环境变量激活时支持停用命令

Python 扩展有一个新的激活机制，可以在默认终端中激活选定的环境，而无需运行任何显式激活命令。这目前是一个实验性标志，可以通过以下“用户”设置启用："python.experiments.optInto": ["pythonTerminalEnvVarActivation"]。

然而，这种激活机制最初的一个缺点是它不支持 deactivate 命令。我们收到了反馈，这对于某些用户的工作流程来说是重要的一部分，因此我们添加了在选定的默认终端是 PowerShell 或命令提示符时对 deactivate 的支持。我们计划在未来添加对其他终端的支持。

REPL 智能发送的警告消息和设置

当尝试通过 Shift+Enter 在包含无效或已弃用代码的 Python 文件上使用 智能发送 时，现在会显示警告消息和停用 REPL 智能发送的选项。用户可以通过“Python.REPL：启用 REPL 智能发送”(python.REPL.enableREPLSmartSend) 设置更改其 REPL 智能发送的用户和工作区特定行为。

Settings editor entry for Python REPL Smart Send

测试架构重写

Python 测试适配器重写实验已向 100% 的用户推出。目前，您可以通过在 settings.json 中添加 "python.experiments.optOutFrom" : "pythonTestAdapter" 来选择退出，但我们很快将放弃此实验性标志并采用此新架构。

GitHub 拉取请求和议题

GitHub 拉取请求和问题 扩展已取得更多进展，该扩展允许您处理、创建和管理拉取请求和问题。

  • PR 描述和“创建”视图中现在支持合并队列。
  • 新设置 "githubPullRequests.allowFetch": false 可防止运行 fetch。
  • 子模块支持得到了改进。

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

预览功能

树视图中的粘性滚动

在编辑器中粘性滚动成功的基础上，我们将此功能扩展到所有树视图，使用户能够更轻松地导航项目树。可以通过设置 workbench.tree.enableStickyScroll: true 来启用树视图的粘性滚动。为了确保粘性滚动不会占用过多空间，它最多只能占用视图高度的 40%。此外，用户可以通过配置 workbench.tree.stickyScrollMaxItemCount 来自定义粘性元素的最大数量，该数量默认为 7。

为了改善树导航体验，您可以选择一个粘性元素以直接跳转到树中的该元素，或按下父元素的 V 形箭头以隐藏其所有子元素。此外，在启用粘性滚动时，访问复选框和操作项更加容易。

多文件差异编辑器

此版本发布了多差异编辑器的预览。多差异编辑器允许您在一个可滚动视图中查看多个文件中的更改

要启用多差异编辑器，请设置 "multiDiffEditor.experimental.enabled": true。目前，多差异编辑器可用于审查本地更改、暂存更改、传入/传出更改以及来自拉取请求的更改。请注意，多差异编辑器尚未完成功能，可能无法在所有场景中正常工作。

韩语的替代字符过滤

对于工作台中使用过滤的各种功能，VS Code 现在还会搜索 QWERTY 键盘等效项，因为通常会不小心忘记切换语言输入法编辑器 (IME)。这类似于搜索引擎，但实时进行。例如，在韩语 IME 中键入 debug 会得到 ㅇ듀ㅕㅎ，这是没有意义的

Searching for a "ㅇ듀ㅕㅎ" command will now present results for "debug"

目前，这在从单词中间过滤时不起作用。

隐藏问题装饰

有一个新设置可以隐藏编辑器和整个工作台中的问题装饰（不包括问题视图）。默认情况下启用设置问题：可见性 (problems.visibility) 以显示所有问题。

当问题：可见性关闭时，某些问题 UI 设置会被禁用

  • 大纲 > 问题：徽章 (outline.problems.badges)
  • 大纲 > 问题：颜色 (outline.problems.colors)
  • 大纲 > 问题：已启用 (outline.problems.enabled)
  • 问题 > 装饰：已启用 (problems.decorations.enabled)

当问题：可见性关闭时，状态栏会显示警告。

Problems: Visibility off Status Bar item and hover

提议的 API

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

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

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

测试覆盖率

本次迭代我们恢复了测试覆盖率的工作，包括初步的 UI 集成和对长期提案的一些小更新。虽然 API 太长无法在此处包含，但我们认为它相当简单，欢迎您在问题 #123713 中提供对该提案的意见。

聊天代理

正如我们最近的博客文章《VS Code 中“极致智能”的追求》中提到的，我们正在开发一种模型，供扩展将聊天代理贡献给 Copilot Chat 视图。聊天代理 API 仍在提案中，但您现在可以尝试添加自己的聊天代理。订阅问题 #199908 以获取更新。

多文档高亮 API

正如上一版本所介绍的，VS Code 中现在支持多文档高亮。本次迭代，我们添加了一个提议的 MultiDocumentHighlightProvider API，用于注册多文档高亮提供程序。这增加了为特定编程语言提供语义出现高亮的能力。提供程序返回一个新的 MultiDocumentHighlight 结构，其中包含从 URI 到 DocumentHighlight 的映射。可以通过问题 #196354 跟踪反馈和进一步更新。

工程

新 CDN

我们正在将部署推广到新的 CDN 终端：vscode.download.prss.microsoft.com。对于系统管理员，请确保配置网络规则以允许来自此终端的流量。

macOS 10.13 和 10.14 支持已结束

VS Code 1.85 是最后一个支持 macOS 10.13 (macOS High Sierra) 和 10.14 (macOS Mojave) 的版本。有关其他信息，请参阅我们的常见问题。

值得注意的修复

  • 195796 设置编辑器不支持本地化后的文本搜索
  • 197319 vscode://file// 链接不再有效
  • 194094 鼠标移出选择器时不要关闭配置文件图标选择器
  • 197070 支持在自定义标题栏上定位调试工具栏

感谢

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

问题跟踪

对我们问题跟踪的贡献

拉取请求

对 vscode 的贡献

对 vscode-css-languageservice 的贡献

对 vscode-pull-request-github 的贡献