探索智能体开发 -

2022年1月（版本 1.64）

更新 1.64.1：此更新修复了这些 安全问题。

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

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

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

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

观看此版本新功能的亮点回顾，请访问 VS Code 团队的发布会。您可以在我们的 YouTube 频道上找到活动录像。

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

工作台

新侧面板

本里程碑中，我们引入了侧面板（Side Panel），这是工作台中的一个新区域，位于侧边栏（Side Bar）对面。您可以将侧边栏或底部面板中的视图放置在此处。与将底部面板移动到编辑器左右两侧不同，新侧面板与底部面板是共存的，因此您可以同时看到更多的视图集。

要使用侧面板，您需要将一些视图移动过去。基于我们投票率最高的功能请求之一，您可能希望将“大纲”视图从侧边栏移至侧面板。您可以通过拖放视图到侧面板来完成此操作。如果侧面板未打开，就像底部面板一样，将视图拖动到编辑器区域边缘即可将其弹出。

在下面的短视频中，大纲视图被拖到右侧并放置以创建侧面板。用户随后可以在侧边栏中切换视图（在此处打开全局搜索视图），同时保持大纲视图可见。

或者，您可以使用命令面板中的移动视图（Move View）命令，它会显示可用视图的下拉列表。选择视图后，您可以通过创建新的面板/侧边栏/侧面板条目，或者将其放置在资源管理器或源代码管理等现有位置来选择其位置。

Move View command view locations dropdown

通过抓取视图图标，视图可以在面板、侧边栏和侧面板之间拖放。您可以通过右键单击视图图标并选择重置位置（Reset Location），将视图重置回默认位置。

View context menu with Reset Location command

如果您想将所有视图重置回默认布局，可以从命令面板运行视图：重置视图位置（Views: Reset View Locations）。

替换面板位置

如上所述，新侧面板提供了与将面板移动到左侧或右侧类似的功能，但改进之处在于不会移动原始面板的全部内容。随着面板间视图的拖放功能，新侧面板正在取代移动底部面板的选项。

鉴于此，我们弃用了 workbench.panel.defaultLocation 设置以及移动面板（Move Panel）命令，转而支持类似的命令：

  • 将视图从面板移动到侧面板（Move Views From Panel To Side Panel） (workbench.action.movePanelToSidePanel)
  • 将视图从侧面板移动到面板（Move Views From Side Panel To Panel） (workbench.action.moveSidePanelToPanel)

旧的移动面板命令已重新映射到提供类似行为的新命令。即使有此映射，我们也建议您将快捷键更新为新命令。

在下面，整个底部面板被移动到侧面板，然后又移回了原始的面板位置。

面板对齐

为响应另一个热门功能请求，我们添加了一个名为“面板对齐（Panel Alignment）”的新布局选项。此选项允许您配置底部面板在窗口中的跨度。有四个选项：

  • 居中（Center） - 这是经典行为。面板仅跨越编辑器区域的宽度。
  • 左对齐（Left） - 面板将从窗口左边缘跨越到编辑器区域的右边缘。
  • 右对齐（Right） - 面板将从窗口右边缘跨越到编辑器区域的左边缘。
  • 两端对齐（Justify） - 面板将跨越整个窗口的宽度。

请注意，对于所有选项，活动栏（Activity Bar）都被视为窗口的边缘。

您可以在视图（View） > 外观（Appearance） > 对齐面板（Align Panel）菜单下配置这些选项，或者使用新的设置面板对齐方式为...（Set Panel Alignment to...）命令。

自定义布局控件

随着所有这些新布局选项的推出，我们一直在探索更好的方法来公开布局配置，以提高可发现性和易用性。这就是您可能会在标题栏中注意到新的实验性配置布局（Configure Layout）按钮的原因。仅当您的 window.titleBarStyle 设置为 custom（Windows 和 macOS 上的默认值）且 workbench.experimental.layoutControl.enabled 设置为 true 时，此按钮才会出现。按钮的可见性由实验控制，但如果您想手动启用它，可以在设置编辑器中应用这些设置值（⌘, (Windows, Linux Ctrl+,)）。

Configure Layout button on the title bar

菜单内容仍在开发中，但目前您应该可以看到切换侧边栏、面板和侧面板的功能。此外，您将看到一个新命令自定义布局（Customize Layout）的条目。这个新命令触发了一个新的交互式快速选择（Quick Pick）体验，允许您在一个地方控制布局配置的各个方面。

试用一下，如果您有任何反馈，请通过 issue #137633 告知我们。

设置编辑器

设置编辑器搜索现在在搜索时会匹配字符串值和枚举设置。

Settings editor pulling up results where the enum value matches the query

新的搜索算法还优先匹配全字，这意味着如果您同时安装了 Java 和 JavaScript 扩展，搜索“java”时 Java 设置会先出现。

Settings editor search showing Java results before JavaScript ones when searching "java"

最后，设置编辑器中的下拉菜单（例如 files.autoSave）和列表小部件（例如 files.associations）现在支持触摸屏设备。

设置同步

设置同步现在支持同步用户任务（User Tasks）。

Settings Sync User Tasks

默认的设置同步机器名称现在在 Web 版 VS Code 中包含浏览器和产品名称。

Settings Sync default machine name including browser and product names

资源管理器：确认并禁用撤销

文件资源管理器长期以来一直支持撤销堆栈以恢复文件和文件夹的编辑（重命名、剪切/复制/粘贴、移动、导入等）。一些用户认为此功能出乎意料，因此现在有一个设置可以禁用资源管理器中的撤销功能（explorer.enableUndo）。

此外，添加了一个新设置 (explorer.confirmUndo) 来配置资源管理器在执行撤销时提示确认的频率。默认情况下，资源管理器将比以前更频繁地提示，以确保不会意外发生破坏性的撤销，但这可以通过值 "light" 更改为旧行为，或者设置为 "verbose" 以在所有撤销操作前进行提示。

编辑器

音频提示

音频提示指示当前行是否具有某些标记，例如错误、断点或折叠的文本区域。

当主光标更改行或第一次向当前行添加标记时，会播放这些提示。启用屏幕阅读器时会自动启用音频提示，也可以通过将 audioCues.enabled 设置为 on 来手动开启。

未来会有更多的音频提示，我们将继续迭代声音设计。

Unicode 高亮改进

为了改进 11 月版本中引入的 Unicode 高亮显示功能，我们添加了新设置以更好地处理误报。

新设置 editor.unicodeHighlight.allowedLocales 可用于允许在一种或多种配置的区域设置中常见的字符。默认情况下，这包括当前 VS Code 显示语言和当前操作系统语言。目前，仅支持 vscode-loc 语言包中已翻译的区域设置。

editor.unicodeHighlight.includeStrings 设置控制是否应高亮显示字符串中的字符。默认值为 true，但可以设置为 false 以忽略字符串。

编辑器折叠限制

新设置 editor.foldingMaximumRegions 允许用户更改编辑器中显示的最大折叠范围数量。默认限制为 5000。请注意，数字过大会导致性能下降。

编辑器适应语言功能时序

扩展为几乎所有语言功能提供支持，包括折叠区域、代码透镜（CodeLens）、内联提示和语义标记等内置功能。这些功能不是由用户手势触发的，而是由输入触发，通常在超时之后。例如，CodeLens 会随着您的输入进行更新，语义标记也是如此。之前选择的超时值是固定的，或多或少是任意的。在此版本中，编辑器会根据观察到的时序进行自适应，从而使较慢的机器或网络连接不会被请求淹没，并且可以更好地利用更快的机器。

终端

自动回复

终端现在具有一项可选功能，可以在接收到特定的字符序列时自动回复。一个很好的例子是 Windows 批处理脚本在运行批处理脚本后按下 Ctrl+C 时出现的 Terminate batch job (Y/N)? 消息。要让终端在 Windows 上按下 Ctrl+C 时自动回复 Y 并回车 (\r)，请添加以下设置：

"terminal.integrated.autoReplies": {
  "Terminate batch job (Y/N)?": "Y\r"
}

主题：Sapphire

您可以为其他内容设置自定义回复，但这样做时要小心，因为您正在自动向进程发送文本。例如，您可以将其用于在提示时自动更新 Oh My Zsh：

"terminal.integrated.autoReplies": {
  "[Oh My Zsh] Would you like to check for updates? [Y/n]": "Y\r"
}

如果您使用 Clink 并启用了它们类似的功能，您可以在 Clink 或 VS Code 中通过将回复设置为 null 来禁用它，以避免两个功能冲突。 

"terminal.integrated.autoReplies": {
  "Terminate batch job (Y/N)": null
}

增强的 VT 支持

增加了对操作系统命令 (OSC) 4/10/11/12 转义序列的支持，使应用程序能够控制终端的主题颜色。

键盘导航链接

以前，终端中的链接导航需要使用鼠标。现在，可以通过以下命令仅使用键盘打开链接：

  • 终端：打开上一个网页链接... 例如， https://github.com/microsoft/vscode
  • 终端：打开上一个文件链接... 例如， /Users/user/repo/file.txt
  • 终端：打开检测到的链接... 查看所有链接（网页、文件、单词）

A Quick Pick is displayed with link results of type web, word, and file.

源代码管理

对存储库发现的更多控制

根据社区反馈，有两个新设置可以更好地控制发现 Git 存储库的过程并适应更多样化的文件夹结构。

  • git.repositoryScanMaxDepth - 控制扫描时使用的深度。
  • git.repositoryScanIgnoredFolders - 控制扫描期间应忽略的文件夹列表。

更改列表排序改进

新设置 (scm.defaultViewSortKey) 控制源代码管理视图中更改列表使用的默认排序键。排序键的选择也会针对每个文件夹/工作区进行记忆。

选项包括

  • name - 按文件名对更改进行排序。
  • path - 按文件路径对更改进行排序（默认）。
  • status - 按源代码管理状态对更改进行排序。

您需要重新加载 VS Code 窗口才能应用设置更改。

新的 Git 暂存命令

命令面板中添加了一个新命令Git：丢弃所有暂存（Git: Drop All Stashes...），允许用户清除所有暂存条目。与任何具有永久后果的 Git 操作一样，请谨慎使用此命令。

Git 输出 - Git 命令执行时间和持续时间

为了帮助追踪性能问题，Git 输出通道现在显示 Git 命令执行的时间以及命令的持续时间（不包括生成子进程所需的时间）。

Notebook

在渲染的 Markdown 和代码单元输出中查找文本

VS Code 现在支持在 Markdown 单元的渲染视图和代码单元的输出中查找文本。此功能默认禁用，因为需要渲染所有 Markdown 单元和输出，这在打开 Notebook 时可能会产生较高的开销。您可以通过从查找控件输入框的过滤器下拉菜单中选择选项（Markdown 预览、代码单元输出）来开启此功能。

目前，在输出中搜索文本存在一些限制。例如，您无法搜索由 VS Code 本身渲染的流式/文本输出。我们计划在下一次迭代中改进这一点。

单元格折叠 UI

Notebook 单元格左侧有一个蓝条，指示它们已获得焦点。此条目现在是交互式的 - 您可以单击顶部来折叠单元格输入，单击底部来折叠输出。

Markdown 单元格折叠提示

当 Markdown 单元格区域被折叠时，会出现一条带有折叠单元格数量的消息，以使其更明显地显示出某些单元格已被隐藏。

Folded Markdown cell hint

单元格执行提示

我们进行了一些更改，以使单元格正在执行以及哪个单元格正在执行变得更加明显。

首先，当单元格正在执行但未滚动到视图中时，编辑器窗格顶部将显示进度条。

其次，当单元格正在执行时，Notebook 工具栏中会添加一个新按钮转到正在运行的单元格（Go To Running Cell）。

第三，如果通过 notebook.outline.showCodeCells 和 notebook.breadcrumbs.showCodeCells 设置在“大纲”或“面包屑”中显示代码单元格，它们在执行时会显示一个动画运行图标。

调试

查看和编辑二进制数据

VS Code 的通用调试器现在支持查看和编辑二进制数据（又称“内存”）。可供内存查看和编辑的变量在变量（Variables）视图中显示一个内联二进制图标，选中它会打开 十六进制编辑器。

Binary data shown for a variable during a debug session

主题：Codesong

内存查看和编辑依赖于调试适配器协议（Debug Adapter Protocol）的内存相关功能，调试扩展必须实现这些功能才能在 VS Code 中启用相应的 UI。有关详细信息，请参阅下方的调试器扩展开发部分。在此版本中，只有内置的 JavaScript 调试器支持查看和编辑二进制数据，但我们预计其他调试扩展很快也会跟进。

JavaScript 调试

排除调用者在断点处暂停

有时您可能设置了断点或添加了调试器语句，但只想在特定代码路径调用时才暂停。DOM 事件处理程序（如 mousemove）就是一个很好的例子。在此版本中，JavaScript 调试器添加了“排除调用者（Exclude Caller）”以在断点或调试器语句处暂停的功能。

当在某个位置暂停时，您可以右键单击调用堆栈（CALL STACK）视图中的帧，然后选择排除调用者（Exclude Caller）命令。将显示一个新的已排除的调用者（EXCLUDED CALLERS）视图，允许您查看和管理已排除的调用者；之后，如果已排除的调用者出现在其调用堆栈中的任何位置，您的程序将不会在该断点位置暂停。

Linux 上的 Edge 支持

Microsoft Edge 调试现在可通过 edge 调试类型在 Linux 上使用。

语言

Markdown 路径智能感知

内置的 Markdown 扩展现在包含用于链接和图像的路径智能感知。

Path suggestions in a Markdown link

路径建议的工作方式与 CSS 和 HTML 文件中的路径智能感知类似。以 / 开头的路径相对于当前工作区解析，而以 ./ 开头或没有任何前缀的路径则相对于当前文件解析。当您输入 / 时，路径建议会自动显示，或者可以通过 ⌃Space (Windows, Linux Ctrl+Space) 手动调用。

路径智能感知还可以帮助您链接到当前文件内或另一个 Markdown 文件内的标题。以 # 开头路径，可以看到该文件中所有标题的补全建议（根据您的设置，您可能需要使用 ⌃Space (Windows, Linux Ctrl+Space) 来查看它们）。

Header section suggestions in a Markdown link

您可以使用 "markdown.suggest.paths.enabled": false 禁用路径智能感知。

Markdown 删除线支持

VS Code 现在支持在 Markdown 编辑器和内置 Markdown 预览中渲染 ~~删除线~~ 文本。

Strikethrough rendering the Markdown editor and preview

删除线是通过在文本两端加上两个波浪号字符来书写的。

虽然 VS Code 的所有内置主题都支持删除线，但市场中的某些主题可能需要更新才能在编辑器中正确渲染删除线文本。

TS 4.5.5

VS Code 现在捆绑了 TypeScript 4.5.5。

此小版本更新修复了一些重要的崩溃和工具错误。

JS/TS 代码片段包裹

许多 JavaScript 和 TypeScript 代码片段已更新，以支持包裹选定的文本。

要使用包裹功能，请先选择一些文本，然后运行插入代码片段（Insert Snippet）。现在，if 或 forof 等代码片段不会替换选定的文本，而是使用选定的文本作为新语句的主体。

HTML 等号后自动插入引号

当在 HTML 属性后输入 = 时，语言服务现在会自动插入引号并将光标置于引号之间。设置 html.completion.attributeDefaultValue 允许您指定引号的类型（单引号或双引号），默认为双引号。

该功能可以通过设置 "html.autoCreateQuotes": false 禁用。

JSON 清除模式缓存命令

新命令清除模式缓存（Clear schema cache）可以清除之前下载的模式缓存。

LaTeX 支持

已添加基础的 LaTeX 语言支持，包括语法高亮和自动闭合配对。

LaTeX snippet

Web 版 VS Code

远程仓库

GitHub 存储库

在 Web 版 VS Code 中创建的提交现在会签名并标记为已验证（Verified）。此外，维护人员现在可以在使用 Web 版 VS Code 时，提交至从分支（fork）提交的拉取请求。这得益于新的 GitHub GraphQL createCommitOnBranch API。

此外，源代码管理视图现在支持多选。

主题：One Monokai

以前，仅在将 GitHub 存储库克隆到本地或远程机器后，才支持创建空提交。现在，您还可以使用GitHub 存储库：提交空提交（GitHub Repositories: Commit Empty）命令在 Web 版 VS Code 中创建空提交。

还添加了一项新配置，用于启用自动下载指定大小以下的存储库完整内容，从而启用全存储库文本搜索和转到引用（Go to Reference）等高级功能。设置 remoteHub.experimental.fs.maxAutoDownloadSize 控制存储库大小限制，超出该限制时，尝试下载完整内容前会显示提示。默认情况下，maxAutoDownloadSize 未设置，以确保在未经提示的情况下永不下载。

Azure Repos

Azure Repos 支持已从 GitHub Repositories 扩展移出，成为其自己的专用扩展，该扩展也可以安装在桌面上。

采用预发布扩展

Web 版 VS Code 现在捆绑了 GitHub Pull Request and Issues 和 GitHub Repositories 扩展的预发布版本。

PWA 和离线支持

Web 版 VS Code 已采用 PWA 模型，现在可以作为 PWA 安装在宿主操作系统上。得益于这一采纳，现在也可以启用某些离线功能。用户访问过 vscode.dev 或 insiders.vscode.dev 后，即可在离线时使用它来编辑本地文件。

Install VS Code PWA prompt

对扩展的贡献

Python

改进的解释器快速选择器

为了更容易选择所需的解释器，Python 扩展现在在选择解释器（Select Interpreter）快速选择器中按类型对解释器进行分组。

Interpreters grouped in interpreter picker

我们还正在尝试将状态栏中的活动/选定解释器移动到右侧，可能移至语言状态中，因此如果看不到，请检查右侧的 Python 状态。

添加对 'conda run' 的支持

为了改善我们对 Anaconda 用户的支持，我们实现了对 conda run 的支持，使用了 --no-capture-output 参数，该参数不会捕获之前导致错误的内容。此功能已实现用于执行 Lint、测试和格式化函数。

有一个已知漏洞 issue #10972，在 Windows 上使用特殊字符的参数运行 Lint 和测试时会导致错误。这是由于 conda run 读取带有特殊字符的参数的方式导致的，因此它会影响您在 settings.json 中指定的任何命令行参数。

Anaconda 团队正在处理此问题，并希望很快能发布修复程序。新版本发布后，您可以在 Conda 网站上更新您的 Anaconda 版本。

智能选择和更好的折叠支持

通过 Pylance 语言服务器，Python 代码选择和折叠也得到了改进。

使用键盘选择 Python 代码所需的按键次数更少，因为在定义选择范围时会考虑代码的语义信息。

主题：Horizon Extended

至于折叠，以前区域仅由缩进定义，这对于某些情况（例如多行字符串）并不理想。现在，折叠区域会适当地考虑语义信息，并支持 #region 注释。

Jupyter

远程 Jupyter 服务器

Jupyter 扩展现在不再要求您在切换本地和远程 Jupyter 服务器时重新加载 VS Code。此外，扩展现在在内核选择器中同时显示本地和远程内核。

十六进制编辑器

十六进制编辑器 经过了重大架构重构。值得注意的是，在大多数情况下，它现在能够打开任何大小的文件而不会出现性能问题。此外，其布局宽度现在可配置，并具有更强大的“查找/替换”实现。后续迭代中将持续进行改进。

远程开发

远程开发扩展的工作仍在继续，它允许您使用容器、远程机器或 适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。

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

GitHub 拉取请求和议题

针对 GitHub Pull Requests and Issues 扩展的工作仍在继续，该扩展允许您处理、创建和管理拉取请求和议题。查看该扩展 0.36.0 版本的更新日志以查看亮点。

预览功能

终端 Shell 集成

终端现在具有实验性的 Shell 集成，使 VS Code 能够洞察终端内正在发生的情况（以前这是未知的）。当使用设置 "terminal.integrated.enableShellIntegration": true 启用时，运行 Shell 集成脚本的参数将尽可能注入到您的终端配置中。脚本本身主要将不可见的序列注入到您的提示符中，从而为 VS Code 提供诸如提示符、命令和命令输出的位置，每个命令的当前工作目录 (cwd) 以及每个命令的退出代码等信息。

利用这些信息，我们可以通过多种方式增强现有功能：

  • 快速检测 cwd - 以前这仅在 macOS 和 Linux 上可行，并且需要启动进程或查询文件系统来获取该信息。现在这在 Windows 上也起作用。cwd 用于链接检测和在拆分终端选项卡时继承 cwd 等功能中。
  • 改进命令跟踪功能 - 此功能之前就存在，但仅在 macOS 上有默认键盘绑定 (Cmd+Up/Down)，并且使用了一种朴素的方法根据按下 Enter 的时间来猜测行在哪里。

Shell 集成启用了以下新功能：

  • 运行最近的命令 - 由于我们知道运行了哪些命令，我们可以公开一个命令，允许您在快速选择器中查看并再次运行它们。 最近的命令显示在快速选择器中，包括有关当前工作目录以及它们运行时间的信息
  • 转到最近的目录 - 与上面类似，我们还允许导航到过去的目录。 最近的目录按频率降序显示在快速选择器中
  • 相对 cwd 的链接支持 - 我们现在知道终端缓冲区中每一行的 cwd，因此我们可以支持在激活位置相对于 cwd 打开终端中的链接。以前，单击链接时，会打开一个快速选择器，其中包含任何包含匹配该名称的文件夹的结果。现在，将打开确切的文件匹配项。 在 cwd 为 vscode 的终端中，echo 输出了 package.json。单击文件名将打开 vscode/package.json。目录更改为 template-string-converter，然后再次输出 package.json。单击文件名将打开 template-string-converter/package.json。

我们的目标是在功能可靠性足够高时默认开启 Shell 集成。我们采取的参数注入方法是尽可能不显眼。例如，我们不像某些终端那样自动修改您的 Shell 初始化脚本，而是拦截进程的创建、检查参数，并在确信终端可以运行它们的情况下注入 Shell 集成参数。希望在无需用户进行任何配置的情况下使其正常工作，并且不干扰您现有的 Shell 设置。

目前支持的 Shell 是 Windows 上的 pwsh，以及 Linux 和 macOS 上的 pwsh、bash 和 zsh。

如前所述，这是一个实验性功能，目前还有些粗糙，存在一些已知问题：

  • 尚不支持 $PS2 行续行。但是，pwsh 中的行续行是可以工作的。
  • 尚不支持右侧提示。
  • 已知 zsh 脚本有时无法激活。
  • 远程 VS Code 窗口支持有限。

文件资源管理器文件嵌套

资源管理器现在对以逻辑嵌套布局显示同一目录中的文件提供了实验性支持。这有助于直观地将相关文件组合在一起并将文件折叠到“根”文件中以减少杂乱。已添加几个新设置来控制此行为：

  • explorer.experimental.fileNesting.enabled：控制是否启用文件嵌套。
  • explorer.experimental.fileNesting.expand：控制文件嵌套默认是否显示为展开。
  • explorer.experimental.fileNesting.patterns：控制文件如何嵌套。

例如，在许多存储库中，.ts 文件位于其派生的 .js、.d.ts 和/或 .js.map 文件旁边。虽然长期以来可以通过 files.exclude 完全隐藏派生文件，但能够快速访问派生文件会很方便，现在使用嵌套可以实现这一点。

下面，资源管理器正在使用默认的 explorer.experimental.fileNesting.patterns 配置来嵌套 .js 和 .js.map 文件，当展开相应的 .ts 文件时会显示它们。

Explorer with some collapsed and expanded nests

主题：GitHub Light

扩展创作

语言默认图标

语言贡献者可以为语言定义图标。 

{
  "contributes": {
    "languages": [
      {
        "id": "latex",
        // ...
        "icon": {
          "light": "./icons/latex-light.png",
          "dark": "./icons/latex-dark.png"
        }
      }
  ]

如果当前文件图标主题仅具有该语言的通用文件图标，则显示此图标。

此外，像 Minimal 或 None 这样不显示文件图标的文件图标主题将不会使用语言图标。如果文件图标主题具有针对扩展名或文件名的图标，则将优先使用这些图标。

文件图标主题可以通过在主题文件中定义 showLanguageModeIcons: true|false 来自定义新行为。

  • showLanguageModeIcons: true 会显示默认语言图标，即使主题未指定文件图标。
  • showLanguageModeIcons: false 会阻止使用默认语言图标。

QuickPickItem 分隔符

扩展作者现在有能力在快速选择器中添加分隔符。这对于对项目进行分组或在项目之间添加一点空格非常有用。

Quick Pick separators

要将分隔符添加到现有的快速选择器中，请将一个新的 QuickPickItem 添加到您现有的项目列表中，但在 QuickPickItem 上指定 kind 属性，并将其设置为 QuickPickItemKind.Separator。

在上面的示例中，您需要将以下对象添加到您的项目列表中： 

{
    label: 'APIs',
    kind: QuickPickItemKind.Separator
}

如果您未指定 kind 属性，或者将其设置为 QuickPickItemKind.Default，则该项目将被视为普通的 QuickPickItem。

vscode.workspace.createFileSystemWatcher 现在支持任何路径

现有的 vscode.workspace.createFileSystemWatcher API 已得到改进，允许您传入任何用于文件监视的文件或文件夹路径，即使它位于工作区之外。以前，文件监视器仅限于工作区中打开的文件夹。

根据您传入该方法的 glob 模式，监视器将是递归的（例如 **/*.js）或非递归的 (*.js)。递归监视器需要更多资源，因此我们建议尽可能使用简单的 glob 模式。

示例

// Watch a folder non-recursively
vscode.workspace.createFileSystemWatcher(new vscode.RelativePattern(vscode.Uri.file(<path to folder outside workspace>), '*.js'));

// Watch the active text editor file
vscode.workspace.createFileSystemWatcher(new vscode.RelativePattern(vscode.window.activeTextEditor.document.uri, '*'));

注意：作为此更改的一部分，我们对现有文件监视器进行了行为更改。仅使用 glob 模式指令的文件监视器（例如 vscode.workspace.createFileSystemWatcher('**')）将不再接收工作区外发生更改的文件的事件。它将仅接收工作区内路径的文件事件。如果用户没有打开工作区，则通过此方法将不再传递任何事件。这样做是为了确保扩展程序不会收到工作区外的意外事件。

vscode.TerminalLocation

您可以使用新的 TerminalLocation API 指定创建扩展终端的位置。

这通过提供 parentTerminal、在编辑器区域和面板之间进行选择等，来实现创建拆分终端。

onWill 事件的取消令牌

VS Code API 公开了参与文件操作的事件，例如 onWillRenameFiles。这种参与可能是长时间运行的，因此用户可以取消它。在此版本中，扩展程序可以通过相应事件上的取消令牌（例如 FileWillRenameEvent#token）观察用户端的取消操作。这使扩展程序也能取消昂贵的后续操作。

Git 扩展 API

  • 添加了新的 Repository.add 方法，以启用暂存文件的能力。
  • 添加了 Repository.tag 和 Repository.deleteTag 方法，以启用创建和删除标签的能力。

onTaskType 激活事件

提供任务的扩展可以通过使用新的 onTaskType:foo 激活事件来限制其不必要的激活。这比在 onCommand:workbench.action.tasks.runTask 上激活是一种改进，因为对于任务提供扩展来说，workbench.action.tasks.runTask 通常太急切了。

调试器扩展创作

VS Code 现在实现了调试适配器协议的内存相关功能

在此版本中，VS Code 开始通过支持 调试适配器协议 的以下内存相关功能来支持查看和编辑二进制数据：

  • VS Code 遵循 DAP 变量上的 memoryReference 属性，并通过向调试适配器传递客户端功能 supportsMemoryReferences 来声明这一点。
  • 如果 VS Code 从调试适配器接收到功能 supportsReadMemoryRequest，它将启用用于查看二进制数据的 UI，并将发出 readMemory 请求以检索数据。
  • 如果 VS Code 从调试适配器接收到功能 supportsWriteMemoryRequest，它将启用用于编辑二进制数据的 UI，并将发出 writeMemory 请求以存储数据。
  • VS Code 处理 memory 事件，并通过向调试适配器传递客户端功能 supportsMemoryEvent 来声明这一点。

语言服务器协议

新的 语言服务器协议 的下一个版本及其相应的 npm 模块已经发布。该版本包含 Notebook 文档的提议实现。规范部分可以在此处阅读。

建议的扩展 API

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

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

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

禁用终端持久性

创建终端时，您可以通过在 TerminalOptions 或 ExtensionTerminalOptions 中设置 disablePersistence 来选择退出重启和重新加载时的终端持久性。 

export interface TerminalOptions {
  disablePersistence?: boolean;
}

内联提示 API

在此向所有对内联提示 API 感兴趣的人致意。它已接近完成，并增加了对交互式标签部分的支持。这些允许您将源代码位置绑定到提示，进而启用代码导航等功能。此外，现在支持命令。此提案的最新状态和开发情况位于：vscode.proposed.inlayHints.d.ts

语言状态 API

语言状态项 API 计划最终确定。请尝试一下并为 vscode.proposed.languageStatus.d.ts 提供反馈。

测试提案

我们正在提出一种实现测试“刷新”处理程序的官方方式，请查看 vscode.proposed.testRefresh.d.ts。这将允许扩展程序统一使用 VS Code 中的标准“刷新”按钮，而无需实现自己的按钮。

此外，我们建议 TestItem 在 vscode.proposed.testSortText.d.ts 中具有 sortText 属性。

内联补全：自动括号补全

当扩展提供内联补全项时，它可以将其属性 completeBracketPairs 设置为 true。如果设置，VS Code 会尝试在将内联补全显示给用户之前，通过关闭或删除它们来修复补全文本中的无效括号。

树拖放提案支持拖入编辑器

树拖放提案即将完成，现在当 TreeDragAndDropController 支持 "resourceurls" MIME 类型时，支持从树视图拖动到编辑器中。详细信息可在 issue #141418 中获得。请尝试一下并为 vscode.proposed.treeViewDragAndDrop.d.ts 提供反馈。

评论时间戳

评论 API 在 Comment 上有一个新的 timestamp 属性。随 API 而来的是一个用于控制评论时间戳显示方式的新设置：comments.useRelativeTime。请尝试一下并为 vscode.proposed.commentTimestamp.d.ts 提供反馈。

工程

vscode-bisect 工具

一个新的用于对已发布的 VS Code Insiders 版本（Web 和桌面）进行二分查找（bisect）的工具可用，以帮助诊断问题。 

npx vscode-bisect

与 git bisect 类似，vscode-bisect 将启动一系列过去已发布的 Insiders 构建，询问构建是否重现了问题。最终结果是引入问题的一系列提交。该实例将使用专用的全新文件夹存储用户数据，以免影响您的主要开发环境。

从源代码运行 Web 版和服务器版 Code

从源代码运行 Web 版 VS Code 和 VS Code Server 的脚本已移至 scripts 文件夹。

  • ./scripts/code-web.sh|bat 从源代码启动 Web 版 Code（又名“无服务器”），并在其上打开浏览器。使用 --help 查看更多选项。
  • ./scripts/code-server.sh|bat 从源代码启动 VS Code Server。添加 --launch 以额外在浏览器中打开 Web UI。使用 --help 查看更多选项。
  • ./scripts/test-web-integration.sh|bat 用于远程 Web 测试。
  • ./scripts/test-remote-integration.sh|bat 用于远程测试。

扩展

在此里程碑中，我们通过最小化 VS Code 对服务的查询次数改进了市场交互。

值得注意的修复

  • 91286 限制客户端上的设置同步活动
  • 117648 使用扩展 sass 通过 emmet 展开“gtc”时的结果很奇怪。
  • 134466 不存在的调试器配置
  • 135677 悬停在设置 UI 链接上时显示 # 在开头
  • 138072 在全局存储中存储最近打开的工作区
  • 138805 打开大型二进制文件时读取完整内容
  • 138850 磁盘文件更改后打开的编辑器可能会变为空
  • 139880 调试：按下 F5 时被要求保存文件
  • 140003 任务无法从不同工作区文件夹中的启动配置引用
  • 140129 双击 settings.json 文件导致每次都会打开新标签页
  • 140560 VS Code 停止调试 API 的问题
  • 140967 Comment.body 渲染为 Markdown，即使对于纯字符串也是如此

感谢

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

Web 扩展

扩展作者启用作为 Web 扩展运行代码的扩展（下表日期范围为 2021 年 12 月 7 日至 2022 年 1 月 31 日）

问题跟踪

对我们问题跟踪的贡献

拉取请求

对 vscode 的贡献

对 vscode-css-languageservice 的贡献

对 vscode-eslint 的贡献

对 vscode-extension-samples 的贡献

对 vscode-html-languageservice 的贡献

对 vscode-js-debug 的贡献

  • @zkx5xkt: 修复：DebugSessionTunnels。远程/本地端口使用位置错误 PR #1163

对 vscode-pull-request-github 的贡献

对 vscode-textmate 的贡献

对 vscode-vsce 的贡献

对 debug-adapter-protocol 的贡献

对 monaco-editor 的贡献

对 node-jsonc-parser 的贡献

English 한국어 中文(简体) 中文(繁體)
© . This site is unofficial and not affiliated with Microsoft.