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

2022 年 1 月 (版本 1.64)

更新 1.64.1:此更新解决了这些安全问题

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

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


欢迎使用 Visual Studio Code 2022 年 1 月版。此版本中有许多我们希望您会喜欢的更新,其中一些主要亮点包括:

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

在 VS Code 团队的发布派对上观看此版本新功能的亮点录像,可在我们的 YouTube 频道上找到。

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

工作台

新侧边面板

在此里程碑中,我们引入了侧边面板,这是工作台中侧边栏对面的一个新区域,您可以在其中放置侧边栏或底部面板中的视图。与将底部面板移动到编辑器的左侧或右侧不同,新侧边面板与底部面板同时工作,因此您可以一次看到更多组视图。

要使用侧边面板,您需要将一些视图移动到其中。根据我们投票最多的功能请求之一,您可能希望将大纲视图从侧边栏移动到侧边面板。您可以通过将视图拖放到侧边面板中来完成此操作。如果侧边面板未打开,就像底部面板一样,将视图拖到编辑器区域的边缘,它会弹出。

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

或者,您可以使用命令面板中的移动视图命令,该命令将显示可用视图的下拉列表。选择视图后,您可以通过创建新的面板/侧边栏/侧边面板条目或将视图放置在现有位置(如资源管理器或源代码管理)来选择位置。

Move View command view locations dropdown

可以通过抓取视图图标在面板、侧边栏和侧边面板之间拖放视图。您可以通过右键单击视图图标并选择重置位置来将视图的位置重置为默认值。

View context menu with Reset Location command

如果您想将所有视图重置回默认布局,您可以从命令面板运行视图:重置视图位置

替换面板位置

如上所述,新侧边面板提供了与将面板移动到左侧或右侧类似的功能,但通过不移动原始面板的全部内容来改进此功能。除了视图在面板之间拖放之外,新侧边面板正在取代移动底部面板的选项。

因此,我们已弃用workbench.panel.defaultLocation设置以及移动面板命令,转而使用类似命令。

  • 将视图从面板移动到侧边面板workbench.action.movePanelToSidePanel
  • 将视图从侧边面板移动到面板workbench.action.moveSidePanelToPanel

旧的移动面板命令已重新映射到提供类似行为的新命令。即使有此映射,我们仍建议您将键盘绑定更新为新命令。

下面,整个底部面板被移动到侧边面板,然后移回原始面板位置。

面板对齐

针对另一个流行的功能请求,我们添加了一个名为“面板对齐”的新布局选项。此选项允许您配置底部面板在窗口中跨越的距离。有四个选项:

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

请注意,对于所有选项,活动栏都被视为窗口的边缘。

您可以在视图 > 外观 > 对齐面板菜单中配置这些选项,或使用新的将面板对齐到... 命令。

自定义布局控制

有了所有这些新的布局选项,我们一直在探索如何更好地公开布局配置,以提高可发现性和易用性。这就是为什么您可能会在标题栏中注意到一个新的实验性配置布局按钮。这仅在您的window.titleBarStyle设置为custom(Windows 和 macOS 上的默认值)且workbench.experimental.layoutControl.enabled设置为true时出现。该按钮的可见性由一项实验控制,但如果您想手动启用它,您可以通过在设置编辑器中应用这些设置值来完成 (⌘, (Windows, Linux Ctrl+,))。

Configure Layout button on the title bar

菜单的内容仍在开发中,但目前您应该能够切换侧边栏、面板和侧边面板。此外,您还将看到一个新命令自定义布局的条目。这个新命令会触发一个新的交互式快速选择体验,允许您在一个地方控制布局配置的所有方面。

试用一下,如果您有任何反馈,请在问题 #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)现在支持触摸屏设备。

设置同步

设置同步现在支持同步用户任务。

Settings Sync User Tasks

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 会随着您的打字而更新,语义标记也是如此。选择的超时值是固定的,并且或多或少是任意的。在此版本中,编辑器会适应观察到的时间,以便较慢的机器或网络连接不会因请求而过载,并且可以更好地利用较快的机器。

终端

自动回复

终端现在具有一项可选功能,可在收到特定字符序列时自动回复。一个很好的例子是,在运行批处理脚本时按Ctrl+C后,Windows 批处理脚本消息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并启用其类似功能,您可以通过将回复设置为null来在 Clink 或 VS Code 中禁用它,以避免这两个功能相互冲突。

"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 操作一样,请谨慎使用此命令。

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

为了帮助跟踪性能问题,Git 输出通道现在显示 Git 命令执行的时间以及命令的持续时间,不包括启动子进程所需的时间。

Notebook

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

VS Code 现在支持在 Markdown 单元格的渲染视图和代码单元格的输出中查找文本。此功能默认禁用,因为它需要渲染所有 Markdown 单元格和输出,这在打开笔记本时可能会成本高昂。您可以通过从查找控制输入框上的筛选器下拉列表中选择选项(Markdown 预览代码单元格输出)来打开此功能。

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

单元格折叠 UI

笔记本单元格左侧有一个蓝色条,表示它们处于焦点状态。此条现在是交互式的 - 您可以单击顶部部分以折叠单元格输入,单击底部部分以折叠输出。

Markdown 单元格折叠提示

当 Markdown 单元格区域被折叠时,将出现一条消息,其中包含折叠单元格的数量,以使其更明显地显示某些单元格已隐藏。

Folded Markdown cell hint

单元格执行提示

我们做了一些更改,以便在单元格执行时以及哪个单元格正在执行时更明显。

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

其次,当单元格正在执行时,笔记本工具栏中会添加一个新按钮转到正在运行的单元格

第三,如果代码单元格通过notebook.outline.showCodeCellsnotebook.breadcrumbs.showCodeCells设置在大纲或面包屑中可见,则它们在执行时将显示动画运行图标。

调试

查看和编辑二进制数据

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

Binary data shown for a variable during a debug session

主题:Codesong

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

JavaScript 调试

排除调用者在断点处暂停

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

在某个位置暂停时,您可以右键单击“调用堆栈”视图中的帧,然后选择“排除调用者”命令。将显示一个新的“排除的调用者”视图,允许您查看和管理排除的调用者,之后,如果排除的调用者出现在其调用堆栈中的任何位置,您的程序将不会在断点位置暂停。

Linux 上的 Edge 支持

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

语言

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 代码片段已更新,支持环绕选定文本。

要使用环绕功能,首先选择一些文本,然后运行插入代码片段。例如,ifforof等代码片段现在将使用选定的文本作为新语句的主体,而不是替换选定的文本。

HTML 等号后自动插入引号

在 HTML 中属性后键入=时,语言服务现在会自动插入引号并将光标放在引号之间。设置html.completion.attributeDefaultValue允许您指定引号类型(单引号或双引号),默认使用双引号。

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

JSON 清除架构缓存命令

新命令清除架构缓存清除以前下载的架构的缓存。

LaTeX 支持

已添加 LaTeX 基本语言支持。这包括语法高亮显示和自动关闭配对。

LaTeX snippet

Web 版 VS Code

远程仓库

GitHub 存储库

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

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

主题:One Monokai

以前,只有将 GitHub 存储库克隆到本地或远程机器后才支持创建空提交。您现在还可以使用GitHub 存储库:提交空提交命令在 VS Code 网页版中创建空提交。

还添加了一个新配置,用于在给定大小以下时自动下载存储库的完整内容,以启用高级功能,例如整个存储库文本搜索和转到引用。设置remoteHub.experimental.fs.maxAutoDownloadSize控制在尝试下载完整内容时显示提示之前的存储库大小限制。默认情况下,未设置maxAutoDownloadSize,以便在没有提示的情况下从不下载。

Azure Repos

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

已采用预发布扩展

VS Code 网页版现在捆绑了GitHub Pull Request and IssuesGitHub Repositories扩展的预发布版本。

PWA 和离线支持

VS Code 网页版已采用 PWA 模型,现在可以作为 PWA 安装在宿主操作系统上。由于这种采用,现在还可以启用一些离线功能。一旦访问过vscode.devinsiders.vscode.dev,用户现在甚至可以在离线时使用它来编辑本地文件。

Install VS Code PWA prompt

对扩展的贡献

Python

改进的解释器快速选择

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

Interpreters grouped in interpreter picker

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

添加对“conda run”的支持

为了改善对Anaconda用户的支持,我们已经实现了对conda run的支持,使用--no-capture-output参数,该参数不会捕获过去导致错误的输出。此功能用于执行 Linter、测试和格式化功能。

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

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

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

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

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

主题:Horizon Extended

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

Jupyter

远程 Jupyter 服务器

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

十六进制编辑器

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

远程开发

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

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

GitHub 拉取请求和议题

GitHub 拉取请求和问题扩展仍在开发中,它允许您处理、创建和管理拉取请求和问题。查看扩展 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 的终端中,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"
        }
      }
  ]

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

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

文件图标主题可以通过在主题文件中定义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.tagRepository.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 模块已发布。该版本包含笔记本文档的拟议实现。规范部分可在此处阅读:此处

建议的扩展 API

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

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

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

禁用终端持久性

创建终端时,您可以通过在TerminalOptionsExtensionTerminalOptions中设置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 中统一使用标准“刷新”按钮,并避免实现自己的按钮。

此外,我们建议TestItemvscode.proposed.testSortText.d.ts中具有sortText属性。

内联补全:自动括号补全

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

树形拖放提案支持拖放到编辑器中

树形拖放提案即将完成,现在当TreeDragAndDropController支持"resourceurls" MIME 类型时,支持从树形视图拖放到编辑器中。详细信息可在问题 #141418 中找到。请试用并为vscode.proposed.treeViewDragAndDrop.d.ts提供反馈。

评论时间戳

评论 API 在Comment上新增了timestamp属性。除了 API 之外,还有一个新设置来控制评论时间戳的显示方式:comments.useRelativeTime。请试用并为vscode.proposed.commentTimestamp.d.ts提供反馈。

工程

vscode-bisect 工具

一个新的工具可用于二分法查找已发布的 VS Code Insiders 版本(网页版和桌面版),以帮助诊断问题。

npx vscode-bisect

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

从源代码运行 Code Web & Server

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

  • ./scripts/code-web.sh|bat从源代码启动 Code for the Web(又称“无服务器”),并在浏览器中打开它。使用--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 对服务进行的查询次数来改善 Marketplace 交互。

值得注意的修复

  • 91286 限制客户端的设置同步活动
  • 117648 使用 Emmet 扩展 Sass 展开“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 的贡献

vscode-pull-request-github 的贡献

vscode-textmate 的贡献

vscode-vsce 的贡献

debug-adapter-protocol 的贡献

monaco-editor 的贡献

node-jsonc-parser 的贡献