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 月版。此版本中有许多我们希望您会喜欢的更新,其中一些主要亮点包括:
- 新侧边面板 - 通过新侧边面板一次显示更多视图。
- 设置编辑器搜索 - 搜索现在优先匹配完整单词。
- 音频提示 - 当光标移动到折叠区域、错误和断点时发出提示音。
- Unicode 高亮显示改进 - 避免在高亮显示受支持语言中的字符。
- 自动终端回复 - 创建对常见终端提示的自动回复。
- 笔记本 UI 改进 - 搜索 Markdown 和输出单元格中的文本。
- 调试二进制数据视图 - 调试时查看和编辑二进制数据。
- Markdown 路径智能感知 - 快速插入相对文件路径和标题链接。
- JS/TS 环绕代码片段 - 将选定的代码插入代码片段中。
- VS Code 网页版 - 支持 vscode.dev 和 github.dev 中的已签名 GitHub 提交。
如果您想在线阅读这些发行说明,请访问 code.visualstudio.com 上的更新页面。
在 VS Code 团队的发布派对上观看此版本新功能的亮点录像,可在我们的 YouTube 频道上找到。
内测版:想尽快尝试新功能?您可以下载每晚的内测版构建,并尽快尝试最新的更新。
工作台
新侧边面板
在此里程碑中,我们引入了侧边面板,这是工作台中侧边栏对面的一个新区域,您可以在其中放置侧边栏或底部面板中的视图。与将底部面板移动到编辑器的左侧或右侧不同,新侧边面板与底部面板同时工作,因此您可以一次看到更多组视图。
要使用侧边面板,您需要将一些视图移动到其中。根据我们投票最多的功能请求之一,您可能希望将大纲视图从侧边栏移动到侧边面板。您可以通过将视图拖放到侧边面板中来完成此操作。如果侧边面板未打开,就像底部面板一样,将视图拖到编辑器区域的边缘,它会弹出。
在下面的短视频中,大纲视图被拖到右侧并放下以创建侧边面板。用户可以在侧边栏中切换视图(此处打开全局搜索视图),同时保持大纲视图可见。
或者,您可以使用命令面板中的移动视图命令,该命令将显示可用视图的下拉列表。选择视图后,您可以通过创建新的面板/侧边栏/侧边面板条目或将视图放置在现有位置(如资源管理器或源代码管理)来选择位置。
可以通过抓取视图图标在面板、侧边栏和侧边面板之间拖放视图。您可以通过右键单击视图图标并选择重置位置来将视图的位置重置为默认值。
如果您想将所有视图重置回默认布局,您可以从命令面板运行视图:重置视图位置。
替换面板位置
如上所述,新侧边面板提供了与将面板移动到左侧或右侧类似的功能,但通过不移动原始面板的全部内容来改进此功能。除了视图在面板之间拖放之外,新侧边面板正在取代移动底部面板的选项。
因此,我们已弃用workbench.panel.defaultLocation
设置以及移动面板命令,转而使用类似命令。
- 将视图从面板移动到侧边面板(
workbench.action.movePanelToSidePanel
) - 将视图从侧边面板移动到面板(
workbench.action.moveSidePanelToPanel
)
旧的移动面板命令已重新映射到提供类似行为的新命令。即使有此映射,我们仍建议您将键盘绑定更新为新命令。
下面,整个底部面板被移动到侧边面板,然后移回原始面板位置。
面板对齐
针对另一个流行的功能请求,我们添加了一个名为“面板对齐”的新布局选项。此选项允许您配置底部面板在窗口中跨越的距离。有四个选项:
- 居中 - 这是经典行为。面板仅跨越编辑器区域的宽度。
- 左侧 - 面板将从窗口的左边缘跨越到编辑器区域的右边缘。
- 右侧 - 面板将从窗口的右边缘跨越到编辑器区域的左边缘。
- 两端对齐 - 面板将跨越窗口的完整宽度。
请注意,对于所有选项,活动栏都被视为窗口的边缘。
您可以在视图 > 外观 > 对齐面板菜单中配置这些选项,或使用新的将面板对齐到... 命令。
自定义布局控制
有了所有这些新的布局选项,我们一直在探索如何更好地公开布局配置,以提高可发现性和易用性。这就是为什么您可能会在标题栏中注意到一个新的实验性配置布局按钮。这仅在您的window.titleBarStyle
设置为custom
(Windows 和 macOS 上的默认值)且workbench.experimental.layoutControl.enabled
设置为true
时出现。该按钮的可见性由一项实验控制,但如果您想手动启用它,您可以通过在设置编辑器中应用这些设置值来完成 (⌘, (Windows, Linux Ctrl+,))。
菜单的内容仍在开发中,但目前您应该能够切换侧边栏、面板和侧边面板。此外,您还将看到一个新命令自定义布局的条目。这个新命令会触发一个新的交互式快速选择体验,允许您在一个地方控制布局配置的所有方面。
试用一下,如果您有任何反馈,请在问题 #137633 中告诉我们。
设置编辑器
设置编辑器搜索现在在搜索时会查找字符串和枚举设置中的字符串值匹配项。
新的搜索算法还会优先匹配完整单词,这意味着如果同时拥有 Java 和 JavaScript 扩展,则在搜索“java”时会首先显示 Java 设置。
最后,设置编辑器中的下拉列表(例如files.autoSave
)和列表小部件(例如files.associations
)现在支持触摸屏设备。
设置同步
设置同步现在支持同步用户任务。
VS Code 网页版中的默认设置同步机器名称现在包含浏览器和产品名称。
资源管理器:确认并禁用撤消
文件资源管理器长期以来一直支持撤消堆栈来还原文件和文件夹编辑(重命名、剪切/复制/粘贴、移动、导入等)。一些用户认为此功能出乎意料,因此现在有一个设置可以在资源管理器中禁用撤消(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
- 终端:打开检测到的链接... 以查看所有链接(网页、文件、单词)
源代码管理
对存储库发现的更多控制
根据社区反馈,有两个新设置可以更好地控制 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 单元格区域被折叠时,将出现一条消息,其中包含折叠单元格的数量,以使其更明显地显示某些单元格已隐藏。
单元格执行提示
我们做了一些更改,以便在单元格执行时以及哪个单元格正在执行时更明显。
首先,当单元格正在执行但未滚动到视图中时,编辑器窗格顶部将显示一个进度条。
其次,当单元格正在执行时,笔记本工具栏中会添加一个新按钮转到正在运行的单元格。
第三,如果代码单元格通过notebook.outline.showCodeCells
和notebook.breadcrumbs.showCodeCells
设置在大纲或面包屑中可见,则它们在执行时将显示动画运行图标。
调试
查看和编辑二进制数据
VS Code 的通用调试器现在支持查看和编辑二进制数据(又称“内存”)。在“变量”视图中,可用于内存查看和编辑的变量会显示一个内联二进制图标,选择它会打开十六进制编辑器。
主题:Codesong
内存查看和编辑依赖于调试适配器协议的内存相关功能,调试扩展必须实现这些功能才能在 VS Code 中启用相应的 UI。有关详细信息,请参见下面的调试器扩展编写部分。在此版本中,只有内置的 JavaScript 调试器支持二进制数据的查看和编辑,但我们预计其他调试扩展将很快跟进。
JavaScript 调试
排除调用者在断点处暂停
有时您可能会设置断点或添加调试器语句,但只希望在从特定代码路径调用时暂停。DOM 事件处理程序(如mousemove
)就是一个很好的例子。在此版本中,JavaScript 调试器添加了“排除调用者”在断点或调试器语句处暂停的功能。
在某个位置暂停时,您可以右键单击“调用堆栈”视图中的帧,然后选择“排除调用者”命令。将显示一个新的“排除的调用者”视图,允许您查看和管理排除的调用者,之后,如果排除的调用者出现在其调用堆栈中的任何位置,您的程序将不会在断点位置暂停。
Linux 上的 Edge 支持
现在可以通过edge
调试类型在 Linux 上使用Microsoft Edge 调试。
语言
Markdown 路径智能感知
内置的 Markdown 扩展现在包含链接和图像的路径智能感知。
路径建议的工作方式类似于 CSS 和 HTML 文件中的路径智能感知。以/
开头的路径相对于当前工作区解析,而以./
开头或没有任何前缀的路径相对于当前文件解析。路径建议在您键入/
时自动显示,也可以通过使用⌃Space (Windows, Linux Ctrl+Space)手动调用。
路径智能感知还可以帮助您链接到当前文件或另一个 Markdown 文件中的标题。以#
开头路径以查看文件中所有标题的完成情况(根据您的设置,您可能需要使用⌃Space (Windows, Linux Ctrl+Space)才能看到这些)。
您可以使用"markdown.suggest.paths.enabled": false
禁用路径智能感知。
Markdown 删除线支持
VS Code 现在支持在 Markdown 编辑器和内置 Markdown 预览中渲染~~删除线~~
文本。
删除线通过用两个波浪号字符包裹文本来书写。
虽然所有 VS Code 的内置主题都支持删除线,但市场中的某些主题可能需要更新才能在编辑器中正确渲染删除线文本。
TS 4.5.5
VS Code 现在捆绑了 TypeScript 4.5.5。
此小更新修复了一些重要的崩溃和工具错误。
JS/TS 环绕代码片段
许多 JavaScript 和 TypeScript 代码片段已更新,支持环绕选定文本。
要使用环绕功能,首先选择一些文本,然后运行插入代码片段。例如,if
或forof
等代码片段现在将使用选定的文本作为新语句的主体,而不是替换选定的文本。
HTML 等号后自动插入引号
在 HTML 中属性后键入=
时,语言服务现在会自动插入引号并将光标放在引号之间。设置html.completion.attributeDefaultValue
允许您指定引号类型(单引号或双引号),默认使用双引号。
可以通过设置"html.autoCreateQuotes": false
禁用此功能。
JSON 清除架构缓存命令
新命令清除架构缓存清除以前下载的架构的缓存。
LaTeX 支持
已添加 LaTeX 基本语言支持。这包括语法高亮显示和自动关闭配对。
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 Issues和GitHub Repositories扩展的预发布版本。
PWA 和离线支持
VS Code 网页版已采用 PWA 模型,现在可以作为 PWA 安装在宿主操作系统上。由于这种采用,现在还可以启用一些离线功能。一旦访问过vscode.dev或insiders.vscode.dev,用户现在甚至可以在离线时使用它来编辑本地文件。
对扩展的贡献
Python
改进的解释器快速选择
为了更容易选择所需的解释器,Python 扩展现在在选择解释器快速选择中按类型对解释器进行分组。
我们还在尝试将活动/选定的解释器移动到状态栏右侧,可能在语言状态内部,因此如果不可见,请检查右侧的Python状态。
添加对“conda run”的支持
为了改善对Anaconda用户的支持,我们已经实现了对conda run
的支持,使用--no-capture-output
参数,该参数不会捕获过去导致错误的输出。此功能用于执行 Linter、测试和格式化功能。
存在一个已知错误问题 #10972,它会导致在 Windows 上使用参数中的特殊字符运行 linting 和测试时出错。这是由于conda run
读取带有特殊字符的参数的方式,因此它可能会影响您在settings.json
中指定的任何命令行参数。
Anaconda 团队正在处理此问题,并希望很快发布修复程序。新版本发布后,您可以在Conda 网站上更新您的 Anaconda 版本。
智能选择和更好的折叠支持
通过Pylance 语言服务器,Python 代码选择和折叠也得到了改进。
使用键盘选择 Python 代码所需的击键次数更少,因为在定义选择范围时会考虑代码的语义信息。
至于折叠,以前区域仅由缩进定义,这对于某些情况(例如多行字符串)并不理想。现在折叠区域适当考虑了语义信息,并且还支持#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 打开链接。以前,当单击链接时,会打开一个快速选择,其中包含任何包含该名称匹配项的文件夹的结果。现在,将打开确切的文件匹配项。
目标是当功能的可靠性足够好时,默认开启 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
文件展开时显示。
主题: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 分隔符
扩展作者现在可以将分隔符添加到快速选择中。这对于分组项目或在项目之间添加一些空间很有用。
要将分隔符添加到现有快速选择中,请向现有项目列表添加一个新的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 模块已发布。该版本包含笔记本文档的拟议实现。规范部分可在此处阅读:此处。
建议的扩展 API
每个里程碑都会带来新的提议 API,扩展作者可以尝试这些 API。一如既往,我们希望得到您的反馈。以下是尝试提议 API 的步骤
- 查找您要尝试的提议并将其名称添加到
package.json#enabledApiProposals
。 - 使用最新的vscode-dts并运行
vscode-dts dev
。它会将相应的d.ts
文件下载到您的工作区中。 - 您现在可以根据该提议进行编程。
您不能发布使用提议 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
。如果设置为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 日之间)
- Tabulate (a5hk)
- Powder (Alexey Osipov)
- VCDrom (Aliaksei Chapyzhenka)
- Reveal Button (Andreas Weber)
- Digital Solutions (Andrew Tacon)
- lorem ipsum (aroary)
- Convert Selection (ArturoDent)
- Custom Language Properties (ArturoDent)
- Find and Transform (ArturoDent)
- Launch Configs (ArturoDent)
- Instant Documentation (atanasster)
- Couper Configuration (Avenga Germany GmbH)
- Argdown (Christian Voigt)
- ES7+ React/Redux/React-Native snippets (dsznajder)
- fantasy.markdown-all-in-one-for-web (fantasy)
- fink (fink)
- GitLens (Insiders) (GitKraken)
- Select by Indent (haberdashPI)
- Selection Utilities (haberdashPI)
- Python-Factory Web Search (HyunseungLee)
- Custom Element Scanner (alpha) (JanKretschmer)
- tomato extensions (jingjingwu)
- vscode-position (jtr)
- KCL for vscode.dev (kcl_extension_publisher)
- KL Language support (Kevlanche)
- Systemd Helper (Liu Yue)
- bett3r icons (Lucas)
- xpro-snippets (Maratib Ali Khan)
- Projen (MarkMcCulloh)
- Rainbow CSV (mechatroner)
- Blogview (mkizka)
- CodeSandpack (Mojojoji)
- Abracadabra, refactor this! (Nicolas Carlo)
- Office Script Extension (office-script)
- Better Fountain (Piers Deseilligny)
- Dothttp Http Client (Prasanth)
- 小说 (Public Theta)
- bojodog (RanolP)
- JSON Validate (rioj7)
- Remove Comments (rioj7)
- Everforest (sainnhe)
- Gruvbox Material (sainnhe)
- JetSet for VSCode (Sudhay)
- MathJax for Markdown (TANIGUCHI Masaya)
- WebEnv-Client (Theboys619)
- Graphviz Interactive Preview (tintinweb)
- LLL (tintinweb)
- Vyper (tintinweb)
- Sourcegraph - preview (TJ Kandala)
- Keyboard Macro Beta (tshino)
- WakaTime (WakaTime)
- MSCode (WebXT ES)
- DigitalJS (Yichao Yu)
- Better Snippets (zardoy)
- Fix All JSON (zardoy)
- Zardoy Experiments (zardoy)
问题跟踪
对我们问题跟踪的贡献
- John Murray (@gjsjohnmurray)
- Andrii Dieiev (@IllusionMH)
- ArturoDent (@ArturoDent)
- Simon Chan (@yume-chan)
- heartacker (@heartacker)
- Lemmingh (@Lemmingh)
拉取请求
对 vscode
的贡献
- @btidor (Benjamin Tidor): 修复文本搜索结果中的
undefined
PR #141522 - @ckline-tryptic (Christopher M Kline): 在 git 扩展 API 中公开“tag”和“deleteTag” PR #123815
- @DanielRosenwasser (Daniel Rosenwasser): TS/JS 代码片段中的“环绕” PR #138565
- @dnicolson (Dave Nicolson): 添加 bisect 消息的单数形式 PR #137626
- @eltociear (Ikko Ashimine): 编辑器 - 修复拼写错误 PR #140320
- @Enzime (Michael Hoang): ripgrep: 不对 PCRE2 使用已弃用的标志 PR #139721
- @gjsjohnmurray (John Murray)
- 修复 #118617 引用没有上游分支时使用“remote”一词 PR #120467
- 更正
screencastMode.keyboardShortcutsFormat
设置的描述 (#_138644) PR #138645 - 显示
editor.hover.delay
的最大值和最小值 (#_140215) PR #140216 - 支持 SQL 中的
--#region
和--#endregion
(#_141257) PR #141264
- @iamkun: 重构:移除重复的 if 语句 PR #140085
- @imphil (Philipp Wagner): 更新 ripgrep 二进制文件以包含 ppc64le 和 s390x PR #140028
- @jeanp413 (Jean Pierre)
- 使用 workbench.extensions.installExtension 安装带版本的扩展 PR #136314
- 修复 Firefox 上打开并关闭终端后 Ctrl + Shift + {Left, Right, Home, End} 失效的问题 PR #139615
- 修复 vscode web 中更改键盘布局失效的问题 PR #140295
- 修复连接令牌解析 PR #140532
- @jlelong (Jerome Lelong)
- 基本 LaTeX 内置扩展 PR #138395
- 更新 latex 语言语法和配置 PR #140801
- @jzyrobert (Robert Jin): 更新 html-language-features 以使用 doQuoteComplete PR #137080
- @KapitanOczywisty: 修复 PHP update-grammar.js PR #140619
- @KendallDoesCoding (Kendall Pinto): 创建 prs 部分 PR #141130
- @KhaledSamir (Khaled): 更正了用于检测转义百分号的正则表达式。 PR #139437
- @lostintangent (Jonathan Carter): [Markdown] 添加对 GitHub 主题图像的支持 PR #137820
- @Mai-Lapyst: 为语言贡献添加默认文件图标支持 PR #118846
- @MaxGrekhov (Max Grekhov): 打开的编辑器:按完整路径排序 PR #133790
- @nrayburn-tech (Nicholas Rayburn): 添加源代码管理视图排序到存储 PR #123232
- @OPY-bbt (张岩): 修复(suggest): 仅在焦点标签中显示 readmore 图标 PR #139792
- @orta (Orta Therox): 允许扩展能够通过命令向 typescript 扩展的 tsserver 发出请求 PR #138279
- @PieterBranderhorst: 超过最大折叠数时通知用户,并使最大折叠数可配置。 PR #140480
- @samestep (Sam Estep): 添加选项,不向 rg 传递 --no-ignore-parent PR #140022
- @SeriousBug (Kaan Genç): hasCustomMarkdownPreview 在上下文菜单中禁用 markdown 预览按钮 PR #139241
- @ShafinKhadem (Nafiur Rahman Khadem): 在片段结尾添加撤消/重做停止 PR #140096
- @slidoooor (Hans)
- 修复当获取缓存令牌时,为相同的 markdown 生成不同的 html 内容 PR #138935
- 修复线条重叠几像素的问题 (#_139311) PR #139575
- 测试:每次测试运行前添加自动保存 PR #141254
- @smcenlly (Simon McEnlly): 测试:为 TestItem 添加新的 API
sortText
属性 PR #132099 - @SMSadegh19 (Mohammad Sadegh Salimi): 添加对 readme markdown 预览的 RTL 语言支持。 PR #139644
- @SNDST00M (M.U.N.I.N): 添加
FontStyle.Strikethrough
支持 PR #139413 - @somebee (Sindre Aarsaether): 修复编辑器通过 transform 缩放时装饰和鼠标点击测试的问题 PR #139282
- @stevenjoezhang (Mimi): 修复 terminal.integrated.cwd 与预定义变量的问题 PR #137023
- @Timmmm (Tim): 修复 parseAddress 正则表达式 PR #140977
- @TwitchBronBron (Bronley Plumb): 修复 InstallAnotherVersionAction 的性能问题 PR #136992
- @WaqasAliAbbasi (Waqas Ali): 防止 markdown 代码块和跨度中的链接高亮显示 PR #140816
- @wengj9 (James Weng): 将扩展信息添加到片段选择器 PR #138880
- @Yash621 (Yash Goel): code-insiders --status 导致错误 PR #140152
- @zardoy (Vitaly): 使
showInformationMessage
、showWarningMessage
、showErrorMessage
上的类型严格,项目为字符串 PR #137672
对 vscode-css-languageservice
的贡献
- @fyangstudio (yangfan): 功能:支持新的解析导入 at-rules PR #255
- @romainmenke (Romain Menke): css color:添加对 hue rad|grad|turn 的支持 PR #257
- @Semigradsky (Dmitry Semigradsky): 支持区分大小写的属性选择器 PR #259
对 vscode-eslint
的贡献
- @edupsousa (Eduardo Pereira de Sousa): 允许用户忽略服务器错误。 PR #1375
对 vscode-extension-samples
的贡献
- @laurentlb (Laurent Le Brun): 修复 comment-sample 中的“取消”按钮 PR #492
对 vscode-html-languageservice
的贡献
- @zuochenxue (ZuoChenxue): docs: 更正错别字 PR #118
对 vscode-js-debug
的贡献
对 vscode-pull-request-github
的贡献
对 vscode-textmate
的贡献
- @SNDST00M (M.U.N.I.N): 实现
FontStyle.Strikethrough
PR #159
对 vscode-vsce
的贡献
- @hangxingliu (Liu Yue): fix: docker 基础镜像需要更新到最新的
node:14-alpine
PR #651 - @joerohde (Joe Rohde): feat: 用于验证入口点的健全性检查 PR #669
- @ritwickdey (Ritwick Dey): fix: 没有 js 标签的入口点验证 PR #676
对 debug-adapter-protocol
的贡献
- @Calindro: 添加 Emulicious 调试器 PR #230
- @cdaringe (Christopher Dieringer): docs(implementors): 添加 OCaml PR #228
- @ko1 (Koichi Sasada): 添加
VSCode rdbg Ruby Debugger
PR #232
对 monaco-editor
的贡献
- @blutorange (Andre Wachsmuth): 实现 #2383 添加 FreeMarker 模板语言的语法模式 PR #2847
- @forensicmike (forensicmike1): 在克隆和运行示例的分步命令行说明中添加“cd monaco-editor” PR #2894
- @juan-carlos-diaz: 修复 #2851 正确高亮 Shell 语言的属性和标识符(带破折号) PR #2871
- @philipturner (Philip Turner)
- @rcjsuen (Remy Suen): 支持 Markdown 语法中的带连字符的 HTML 标签 PR #2864
- @resistdesign (Ryan Graff): doc: (samples) 简化浏览器 ESM Parcel 构建 PR #2832
- @ValeraS (Valeriy)
对 node-jsonc-parser
的贡献
- @Marcono1234
- @P0lip (Jakub Rożek): findNodeAtLocation 不处理不完整的属性对 PR #44