2021 年 5 月 (版本 1.57)
更新 1.57.1:本次更新解决了这些问题。
工作区信任功能解决了 CVE-2021-34529。
下载:Windows:x64 Arm64 | Mac:通用 Intel Apple 芯片 | Linux:deb rpm tarball Arm snap
欢迎来到 Visual Studio Code 2021 年 5 月版本。此版本中有许多更新,我们希望您会喜欢,其中一些主要亮点包括
- 工作区信任 - 浏览不熟悉的源代码时,可额外提高代码执行安全性。
- 新的入门体验 - 帮助您快速设置和了解 VS Code。
- 远程仓库 - 无需本地克隆仓库即可浏览和编辑代码。
- 终端选项卡 - 选项卡可让您轻松创建、管理和分组多个已打开的终端。
- Edge 浏览器调试 - 将 Microsoft Edge 开发人员工具直接集成到 VS Code 中。
- JSDoc @link 支持 - 在注释中添加 @link 标签以实现快速符号导航。
- 非代码文件的“转到定义” - 快速跳转到图像和样式表。
- Notebook API 定稿 - 用于 VS Code 中原生 Notebook 支持的 Notebook API。
- VS Code 在 Build 2021 博客文章 - 观看包含 VS Code 的点播会话。
如果您想在线阅读这些发行说明,请访问 code.visualstudio.com 上的更新。
观看本版本新功能的亮点,请观看 VS Code 团队的发布派对。您可以在我们的 YouTube 频道上找到活动录像。
Insider 版本:想尽快试用新功能吗?您可以下载每日Insider版本,并在更新可用时立即尝试最新功能。
工作台
工作区信任
Visual Studio Code 非常重视安全性,并希望帮助您安全地浏览和编辑代码,无论其来源或作者如何。工作区信任功能让您决定项目文件夹是否允许或限制自动代码执行。
注意:如有疑问,请将文件夹保留在受限模式下。您可以随时稍后启用信任。
安全的代码浏览
公共仓库和文件共享上有如此多的源代码可用,这真是太棒了。无论是什么编码任务或问题,可能已经有了一个很好的解决方案。但是,使用开源代码和工具确实存在风险,您可能会面临恶意代码执行和漏洞利用的风险。
当工作区在受限模式下打开时,工作区信任通过阻止自动代码执行,在处理不熟悉的源代码时提供了额外的安全层。
注意:如果要禁用工作区信任功能,可以将
security.workspace.trust.enabled
设置为false
。仅当您确信自己了解正在处理的文件的来源和完整性时,才禁用工作区信任。
受限模式
当工作区信任对话框提示时,如果您选择不,我不信任作者,VS Code 将进入受限模式以防止代码执行。工作台将在顶部显示一个横幅,其中包含链接,可通过工作区信任编辑器管理您的文件夹,以及了解更多,将您带到工作区信任用户指南。
您还将在状态栏中看到一个受限模式徽章。
受限模式尝试通过禁用或限制多个 VS Code 功能(任务、调试、工作区设置和扩展)的操作来防止自动代码执行。
要查看受限模式下禁用的完整功能列表,您可以通过横幅中的管理链接或单击状态栏中的受限模式徽章来打开工作区信任编辑器。
信任工作区
如果您信任项目的作者和维护者,您可以信任本地计算机上的项目文件夹。例如,信任来自 github.com/microsoft 或 github.com/docker 等知名 GitHub 组织的仓库通常是安全的。当您打开新文件夹时,初始的工作区信任提示允许您信任该文件夹及其子文件夹。
您还可以调出工作区编辑器并快速切换文件夹的信任状态。有几种方法可以调出工作区编辑器对话框。
在受限模式下
- 受限模式横幅管理链接
- 受限模式状态栏项
您还可以随时使用
- 来自命令面板的工作区:管理工作区信任命令 (⇧⌘P (Windows、Linux Ctrl+Shift+P))
- 来自活动栏中管理齿轮的管理工作区信任
选择文件夹
当您信任一个文件夹时,它会被添加到工作区信任编辑器中显示的受信任的文件夹和工作区列表中。
您可以手动从此列表中添加、编辑和删除文件夹,并且突出显示为粗体的活动文件夹将启用信任。
您还可以选择信任父文件夹。这将对父文件夹和所有子文件夹应用信任。如果您在某个文件夹下有许多包含受信任内容的文件夹,这会很有帮助。
启用扩展
如果您想使用受限模式,但您最喜欢的扩展不支持工作区信任,会发生什么?如果某个扩展有用且功能正常,但没有积极维护并且没有声明其工作区信任支持,则可能会发生这种情况。为了处理这种情况,您可以使用 extensions.supportUntrustedWorkspaces
设置覆盖扩展的信任状态。
注意:请谨慎覆盖扩展的工作区信任支持。扩展作者可能有充分的理由在受限模式下禁用其扩展。
您可以在下面看到 Prettier 扩展的用户 settings.json
条目。
"extensions.supportUntrustedWorkspaces": {
"esbenp.prettier-vscode": {
"supported": true,
"version": "6.4.0"
},
},
您可以使用 supported
属性启用或禁用工作区信任支持。version
属性指定适用的确切扩展版本,如果您想为所有版本设置状态,可以删除版本字段。
如果您想了解有关扩展作者如何评估和确定在受限模式下限制哪些功能的更多信息,您可以阅读工作区信任扩展指南。
设置
以下是可用的工作区信任设置
security.workspace.trust.enabled
- 启用工作区信任功能。默认值为 true。security.workspace.trust.startupPrompt
- 是否在启动时显示工作区信任对话框。默认值是每个不同的文件夹或工作区只显示一次。security.workspace.trust.emptyWindow
- 是否始终信任空窗口(未打开文件夹)。默认值为 true。security.workspace.trust.untrustedFiles
- 控制如何处理工作区中的松散文件。默认值是提示。extensions.supportUntrustedWorkspaces
- 覆盖扩展工作区信任声明。可以是 true 或 false。
要了解有关工作区信任的更多信息,您可以阅读工作区信任用户指南。
新的入门体验
在过去几个迭代中,我们一直致力于刷新 VS Code 的欢迎页面,我们很高兴地宣布,从本次迭代开始,我们的新欢迎页面(入门)默认对所有用户启用。在这种新体验中,VS Code 的核心和已安装的扩展都可以向欢迎页面贡献“教程”,这些教程旨在帮助您开始使用 VS Code 本身或新的扩展。例如,Luna Paint 扩展提供了一个教程,其中包含帮助理解图像编辑器每个组件的指南。
此外,一旦您完成(或关闭)所有教程,VS Code 会重新排列内容,使通过单击即可访问的最近工作区数量增加一倍。
设置
workbench.startupEditor
- 控制启动时显示默认编辑器。新值gettingStarted
替换了旧的默认值welcome
。其他可用选项包括readme
、gettingStartedInEmptyWorkbench
、newUntitledFile
或none
。workbench.welcomePage.walkthroughs.openOnInstall
- 是否在安装时自动打开扩展贡献的教程。
新页面将被称为入门,直到我们完全淘汰现有欢迎页面。
远程仓库
远程仓库扩展在 1.56 版中作为内置预览功能引入,现已公开发布,但它不再内置于 VS Code 中,因此您需要从 VS Code Marketplace 安装它。
快速回顾一下,远程仓库扩展允许您直接在 VS Code 中即时浏览、搜索、编辑和提交到任何 GitHub 仓库,而无需克隆或在本地拥有该仓库。
在此次迭代中,我们主要专注于错误修复和发布扩展的完善,但我们确实添加了一些新功能。您现在可以在远程资源管理器中查看您的远程仓库,以快速打开或比较您可能有的任何未提交的更改。此外,您可以将来自同一仓库的更改应用到当前远程仓库,从而允许您快速轻松地将未提交的更改从一个分支移动到另一个分支。
主题:紫水晶暗色主题
要了解有关远程仓库的更多信息,您可以查看远程仓库博客文章和YouTube 视频。
改进的编辑器跨窗口拖放功能
此版本改进了将编辑器拖到其他窗口的支持。您现在可以将差异编辑器、自定义编辑器和整个编辑器组拖到另一个窗口,以在那里打开编辑器。
主题:GitHub 亮色主题
注意:如果您经常使用此功能,请确保启用自动保存 (files.autoSave
),以便一个窗口中的更改自动反映在另一个窗口中。
当没有编辑器打开时,移除 Cmd+W / Ctrl+W 快捷键以关闭窗口
我们收到了反馈,用户在使用 Cmd+W
/ Ctrl+W
快速关闭最后一个编辑器后,VS Code 窗口(实例)突然关闭,对此感到沮丧。团队内部的快速调查也显示,许多人已经取消了此快捷键的窗口关闭功能,因此我们继续移除了在没有编辑器打开时关闭窗口的 Cmd+W
/ Ctrl+W
快捷键。
您可以通过在用户 keybindings.json
文件中按以下方式配置来轻松恢复快捷键
macOS
{
"key": "cmd+w",
"command": "workbench.action.closeWindow",
"when": "!editorIsOpen && !multipleEditorGroups"
}
Windows/Linux
{
"key": "ctrl+w",
"command": "workbench.action.closeWindow",
"when": "!editorIsOpen && !multipleEditorGroups"
}
注意:在所有平台上,都有一个专门用于关闭窗口的快捷键
- macOS:
Cmd+Shift+W
- Linux:
Alt+F4
- Windows:
Alt+F4
Notebook 布局自定义
本月我们添加了多个 Notebook 布局设置,允许用户根据自己的工作流程自定义 Notebook 编辑器。默认开启的自定义项包括
Notebook 工具栏
我们在编辑器中添加了 Notebook 工具栏,您可以在其中轻松访问插入单元格、运行所有单元格或切换内核等操作。通过将 notebook.globalToolbar
设置为 false
可以禁用该工具栏。
输出工具栏
“清除单元格输出”操作和选择不同输出渲染器或 MIME 类型的按钮现在合并到单元格输出旁边的单个...省略号菜单中。这可以通过将 notebook.consolidatedOutputButton
设置为 false
来禁用。
侧边栏中的焦点单元格高亮
VS Code 现在支持在单元格的侧边栏区域渲染焦点单元格高亮,这有助于在 Notebook 包含许多单元格时识别哪个单元格处于焦点状态。设置 notebook.cellFocusIndicator
可以是 gutter
(新的默认值)或 border
以高亮显示整个单元格边框。
鼠标悬停时显示折叠图标
Markdown 单元格上的折叠图标现在在鼠标悬停时可见,而不是一直可见。您可以通过将 notebook.showFoldingControls
设置为 mouseover
(默认值)或 always
来自定义此行为。
本月实现的 Notebook 布局设置的完整列表如下
notebook.cellFocusIndicator
: 为单元格添加了选项,通过单元格侧面的彩色条(gutter
)指示其焦点状态,类似于 Jupyter。notebook.cellToolbarVisibility
: 决定单元格工具栏何时显示,是在单元格获得焦点时,还是在鼠标悬停时。默认情况下,仅在单元格获得焦点时显示。notebook.compactView
: 启用后,单元格以更紧凑的样式渲染,减少了空白区域。默认情况下启用。notebook.consolidatedOutputButton
: “清除单元格输出”操作和选择不同输出渲染器或 MIME 类型的按钮已合并到单元格输出旁边的单个...省略号菜单中。可以使用此设置禁用新菜单。notebook.consolidatedRunButton
: 新增了两个操作,执行上方单元格和执行单元格及下方。它们将默认显示在单元格工具栏中,但启用此设置会将它们移到执行按钮旁边的新上下文菜单中。notebook.dragAndDropEnabled
: 禁用单元格的拖放功能。您仍然可以使用命令(默认情况下是 Alt+Up/Alt+Down)重新排列单元格。notebook.globalToolbar
: 在 Notebook 编辑器顶部添加一个工具栏。notebook.insertToolbarLocation
: 控制插入新单元格的按钮是出现在单元格之间、工具栏中、两者兼有还是隐藏。notebook.showCellStatusBar
: 此设置有一个新选项visibleAfterExecute
,它将在单元格执行前隐藏单元格状态栏以节省空间。一旦执行,它将变为可见,以便用户可以查看执行详细信息。notebook.showFoldingControls
: 控制 Markdown 标题上出现的折叠箭头是始终可见还是仅在鼠标悬停时可见。notebook.editorOptionsCustomizations
: 允许用户在 Notebook 中自定义单元格编辑器设置。
下图显示了其中一些设置的效果(顶部工具栏、侧边栏高亮、输出...按钮)
更新的快速选择与建议小组件颜色
我们更新了快速选择和建议小组件中的焦点状态,以更好地与我们的树小组件样式对齐。这引入了一些控制焦点前景的新颜色标记
list.focusHighlightForeground
quickInputList.focusForeground
editorSuggestWidget.selectedForeground
图标主题:Fluent 图标
更新了 macOS Touch Bar 图标
我们更新了 macOS Touch Bar 图标,使其与我们更新的图标样式保持一致。
默认视图
调试时
Webview 上下文菜单
VS Code 现在支持在 webview 中显示一个简单的上下文菜单,例如 Markdown 预览、发行说明和扩展详细信息页面。
此上下文菜单目前包含复制和粘贴文本的操作。我们将来可能会向菜单中添加更多操作。
如果此上下文菜单干扰了您扩展中的 webview,您可以通过在 contextmenu
事件上调用 preventDefault
来阻止其显示。
document.body.addEventListener('contextmenu', e => {
e.preventDefault(); // cancel the built-in context menu
});
编辑器
建议预览
启用新设置 editor.suggest.preview
后,所选建议或代码片段的预览将显示在光标位置。
主题:深色+ (默认深色)
隐藏已弃用的建议
有一个新设置 editor.suggest.showDeprecated
,其默认值为 on
,但当设置为 off
时,建议将不再显示标记为已弃用的项目。
集成终端
终端选项卡
终端选项卡在 1.56 版中作为预览功能引入,现在已默认启用。新的选项卡视图默认情况下仅在至少有两个终端时显示。对于单个终端,选项卡将“内联”到面板标题中。这也引入了终端状态的概念,例如任务是否正在运行、成功或失败。
以下是本次发布的一些亮点
- 选项卡的颜色可以更改,以便快速导航和区分。
- 选项卡可以拖放以进行重新排列。
- 将终端组中的选项卡拖到空白区域将使其从组中移除(取消拆分终端,也可通过上下文菜单获得)。
- 将选项卡拖到主终端区域允许加入一个组(也可通过上下文菜单获得)。
- 点击选项卡、+ 按钮或单个选项卡时,按住 Alt 键现在会拆分终端。同样适用于中键单击以关闭终端。
- 除非选项卡列表足够大,否则不会显示内联操作,以避免意外拆分/关闭终端。
- 当关闭终端只剩一个时,选项卡列表在鼠标离开视图之前不会隐藏。
如果您不喜欢新的用户体验,可以通过设置 "terminal.integrated.tabs.enabled": false
来恢复下拉菜单,我们计划继续将其作为未来的一个选项来支持。
终端配置文件改进
此版本中的终端配置文件系统有许多改进,以下是一些亮点
- 如果终端在启动 VS Code 时恢复,
defaultProfile
将被遵守,并将用于任务和调试。 - IntelliSense 现在在
settings.json
中适用于icon
和defaultProfile
。 overrideName
现在适用于默认配置文件。defaultProfile
现在可以在工作区设置中设置。这也受新的工作区信任功能控制。- 如果使用
defaultProfile
和shell
或shellArgs
设置,现在将要求您将已弃用的设置迁移到配置文件系统。 color
现在可以在配置文件上设置。
标题序列支持
设置 terminal.integrated.experimentalUseTitleEvent
已升级为稳定版,名为 terminal.integrated.titleMode
。默认情况下,此设置将为 executable
,它根据检测到的前台进程命名终端。
当此项设置为 sequence
时,标题将基于 shell 设置的内容。这需要 shell 支持才能工作,一个示例是 oh-my-zsh 的默认提示符,它显示有关会话的附加信息。
改进了干净环境启动
设置 terminal.integrated.inheritEnv
自 v1.36 版起就已可用,但其实现存在一些缺陷,例如在 Linux 上可能因权限问题而失败,在 macOS 上可能无法按预期工作。
由于 VS Code 设置其底层环境的方式得到了改进,现在可以访问其启动时的初始环境,这是大多数终端的工作方式。当 inheritEnv
设置为 true
时,VS Code 将使用初始环境,而当 false
时,则使用来源的“shell 环境”。此设置可以帮助终端更像一个常规终端。但是,如果您的配置文件/rc 配置设置不正确,您可能会遇到问题。
Windows 上原生换行支持
终端中的换行功能驱动着任务问题匹配器和链接检测。过去,Windows 终端使用启发式方法来标记换行,因为模拟 Unix pty 的仿真技术不支持换行。这在最新版本的 Windows 上发生了变化,当更新到 Windows 10 21376+(目前仅限 Insiders 版本)时,此启发式方法将被禁用,并且换行应该像在 Windows Terminal 中一样正常工作。
任务
任务状态显示在终端选项卡上
任务的状态现在显示在其终端选项卡中。对于后台任务,状态仅在有相关问题匹配器时显示。
自动关闭任务终端
任务 presentation
属性新增了 close
属性。将 close
设置为 true
将导致终端在任务退出时关闭。
{
"type": "shell",
"command": "node build/lib/preLaunch.js",
"label": "Ensure Prelaunch Dependencies",
"presentation": {
"reveal": "silent",
"close": true
}
}
调试
JavaScript 调试
与往常一样,完整的更改列表可以在 vscode-js-debug 更改日志中找到。
Edge 开发人员工具集成
JavaScript 调试器与 Microsoft Edge 开发人员工具集成,为浏览器调试提供 DOM、样式和网络检查器,可通过调试工具栏中新的“检查”图标访问。
下面的短视频演示了选择“检查”按钮并在 Edge DevTools 中导航元素。
主题:Codesong
如果您尚未将 Microsoft Edge 用于浏览器调试,您可以通过在 launch.json
中将 "type": "chrome"
或 "type": "pwa-chrome"
替换为 "type": "pwa-msedge"
来切换到它。这也在 Blazor 应用程序中受支持,只需在其启动配置中设置 "browser": "edge"
即可。
支持源映射中重命名的标识符
JavaScript 调试器现在支持源映射中重命名的标识符,这是一项长期以来要求的功能。这在调试缩小代码时特别有用。
主题:Codesong
变量视图、监视视图和调试控制台 REPL 中都支持重命名的变量。您可以通过查看其生成的源映射文件中是否存在非空的“names”数组来检查您的工具是否发出了重命名。
在“断点”视图中显示命中断点
当命中断点时,VS Code 现在会在“断点”视图中选择并显示它。这应该使理解是哪个确切的断点导致程序中断变得更容易。
目前只有 JS-debug 扩展支持此功能,但我们预计其他调试扩展也将很快跟进。
语言
TypeScript 4.3.2
VS Code 现在附带 TypeScript 4.3.2。此重大更新包括许多 TypeScript 语言改进,以及对 JavaScript 和 TypeScript 工具的许多改进和错误修复。
您可以在 TypeScript 博客上阅读有关 TypeScript 4.3 的更多信息。
JSDoc @link 支持
VS Code 现在支持 JavaScript 和 TypeScript 注释中的 JSDoc @link 标签。这些标签允许您在文档中创建可点击的符号链接。
JSDoc @link
标签的写法是:{@link symbolName}
。您还可以选择指定要渲染的文本来代替符号名称:{@link class.property Alt text}
。
@link
在悬停提示、建议和签名帮助中都受支持。我们还更新了 VS Code 扩展性类型声明文件 vscode.d.ts
以使用 @link
。
导入语句中的补全
JavaScript 和 TypeScript 中的自动导入功能在您接受建议时会自动添加导入。在 VS Code 1.57 中,它们现在在编写导入语句本身时也起作用。
如果您需要手动添加导入,这可以节省时间。
非 JS/TS 文件的“转到定义”
许多现代 JavaScript 打包器和框架使用 import
语句来导入图像和样式表等资产。我们现在支持通过转到定义导航这些导入。
这在您使用 Ctrl
/Cmd
单击导航代码时可能最有用。
排序导入源操作
JavaScript 和 TypeScript 的排序导入代码操作会对您的导入进行排序。但是,与组织导入不同,它不会删除任何未使用的导入。
您还可以通过设置在保存时启用导入排序
"editor.codeActionsOnSave": {
"source.sortImports": true
}
推断函数返回类型快速修复
TypeScript 的推断函数返回类型重构会向函数添加显式返回类型注解。
如果您想添加更明确的类型,这会很有用。此重构还可以在您想将返回类型提取为命名类型/接口,或者需要修改函数的返回类型时节省时间。
提示禁用 TS Server 日志记录
如果您的 TypeScript 服务器日志记录长时间启用,VS Code 现在会提示您。
日志记录会显著影响性能,因此最好将其禁用,除非您正在积极诊断问题。
对扩展的贡献
远程开发
远程开发扩展的工作仍在继续,它允许您使用容器、远程计算机或 适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。
1.57 版的功能亮点包括
- 控制转发端口的所需协议。
- 可选监视转发端口冲突。
- 开发容器支持工作区信任安全功能。
- 更好地检测开发容器中的环境变量。
您可以在远程开发发行说明中了解新的扩展功能和错误修复。
扩展开发
Notebook API
我们已经完成了大部分 Notebook API 的开发。该 API 分为三个独立的部分
NotebookSerializer
API,结合notebooks
贡献点,使 VS Code 能够打开、修改和保存 Notebook 文档。- Notebook 渲染器,用于显示单元格输出。它们通过扩展的
package.json
文件中的notebookRenderer
贡献点添加。 NotebookController
API,用于生成代码单元格的输出。
一个简单的 Notebook 序列化器和一个 echo 控制器的示例。序列化器使用 JSON.parse
和 stringify
,并对空文件进行特殊处理。控制器返回单元格文本的大写变体——一次是纯文本,一次是 HTML。
// serialize/deserialize notebook
vscode.workspace.registerNotebookSerializer(
'echobook',
new (class implements vscode.NotebookSerializer {
// serializer is relying on JSON.parse/stringify
deserializeNotebook(content: Uint8Array) {
return JSON.parse(new TextDecoder().decode(content) || '{"cells":[]}');
}
serializeNotebook(data: vscode.NotebookData) {
return new TextEncoder().encode(JSON.stringify(data));
}
})()
);
// notebook controller
vscode.notebooks.createNotebookController(
'myId',
'echobook',
'Echo',
(cells, _notebook, controller) => {
for (let cell of cells) {
// execution means to echo in upper-case, once as plain text and once as html
const execution = controller.createNotebookCellExecution(cell);
execution.start();
const echo = cell.document.getText().toUpperCase();
const textItem = vscode.NotebookCellOutputItem.text(echo, 'text/plain');
const htmlItem = vscode.NotebookCellOutputItem.text(`<b>${echo}</b>`, 'text/html');
const output = new vscode.NotebookCellOutput([textItem, htmlItem]);
execution.replaceOutput(output);
execution.end(true);
}
}
);
该示例静态注册了 *.echobook
文件的 Notebook 类型。此外,每当打开此类 Notebook 时,VS Code 都会发出 onNotebook:echobook
激活事件。
"contributes": {
"notebooks": [{
"type": "echobook",
"displayName": "Echobook",
"selector": [{
"filenamePattern": "*.echobook"
}]
}]
}
状态栏项 'id' 和 'name' 属性
我们最终确定了 StatusBarItem
标识符和名称属性的 API。标识符可以从 createStatusBarItem
方法的新重载中传入,而 name
属性可以在 StatusBarItem
本身动态更改。
这些新属性用于状态栏上的上下文菜单,以便为单个条目提供名称,并允许用户显示和隐藏条目。如果您不提供这些属性,菜单会将来自一个扩展的所有状态条目聚合到一个条目下。
如果您的扩展贡献了状态栏,请考虑更新到新的 API。
在新终端中打印消息
使用 window.createTerminal
创建终端时,现在可以通过 TerminalOptions.message
设置一条消息,该消息将打印在终端的顶部。此消息支持 ANSI 转义序列以启用文本样式。
vscode.window.createTerminal({
name: `My terminal`,
message: '\x1b[3;1mSome custom message\x1b[0m'
});
内联值的新主题颜色
添加了新颜色以主题化调试器内联值
editor.inlineValuesBackground
: 调试器内联值前景文本的颜色editor.inlineValuesForeground
: 调试器内联值背景的颜色。
提醒一下,内联值在调试期间显示,适用于已注册内联值提供程序的调试扩展,或者当设置 debug.inlineValues
为 true
时。
vscode-webview.d.ts
新发布的 @types/vscode-webview
包添加了 VS Code 在 webview 内部暴露的 API 的类型定义。
您可以通过 npm install --save-dev @types/vscode-webview
安装这些类型。如果您的项目中未识别 webview 类型,请尝试将其添加到 jsconfig
/ tsconfig
的 typeAcquisition
部分。
"typeAcquisition": {
"include": [
"@types/vscode-webview"
]
}
或在您的代码中添加三斜线引用
///<reference types="@types/vscode-webview"/>
改进的 webview 数组缓冲区传输
在以前的 VS Code 版本中,向 webview 发送或从 webview 接收类型化数组有一些奇怪的地方
- 类型化数组,例如
UInt8Array
,序列化效率低下。当您需要传输数兆字节的数据时,这可能会导致性能问题。 - 发送的类型化数组在接收端不会被重新创建为正确的类型。如果您发送一个
UInt8Array
,接收方会得到一个通用对象,该对象具有UInt8Array
的数据值。
虽然这两个问题都是错误,但如果不破坏依赖现有行为的扩展,我们也无法修复它们。与此同时,新编写的扩展没有任何理由会想要当前令人困惑和低效的行为。
因此,我们决定保留现有扩展的现有行为,但将新扩展转移到更正确的行为。这是通过查看扩展的 package.json
中的 engines
值来完成的。
"engines": {
"vscode": "^1.57.0",
}
如果扩展目标是 VS Code 1.57+,那么类型化数组应该在接收端重新创建,并且大型类型化数组与 webview 之间的传输效率应该更高。
调试会话上的 parentSession
一段时间前,VS Code 添加了对分层调试会话的支持,但扩展 API 中未公开有关层次结构的信息。为了解决这个问题,DebugSession
接口上新增了一个属性,该属性引用父会话(如果有的话)。会话的父级永远不会改变。
export interface DebugSession {
/**
* The parent session of this debug session, if it was created as a child.
* @see DebugSessionOptions.parentSession
*/
readonly parentSession?: DebugSession;
// ...
改进了 VS Code Insiders 版本定位
在使用提议 API 的扩展时,新的 Insiders 版本可能会发布破坏性更改。为了为用户提供更无缝的过渡,您现在可以使用日期标签精确地定位 Insiders 版本。例如,将 engines.vscode
设置为 ^1.56.0-20210428
将定位 2020 年 4 月 28 日 0:00 UTC 或之后创建的任何 VS Code 1.56(或更高版本)构建。这允许您在即将发布的 Insiders 版本发布之前安全地发布逾期扩展更新。
"engines": {
"vscode": "^1.56.0-20210428",
}
树悬停支持命令 URI
当 TreeItem
具有受信任的 Markdown 工具提示时,该工具提示可以包含格式为 [这是一个链接](command:workbench.action.quickOpenView)
的命令。这遵循 Markdown 中支持命令链接的所有其他位置的相同格式。
提议的扩展 API
每个里程碑都带来了新的提议 API,扩展作者可以尝试它们。一如既往,我们希望得到您的反馈。以下是尝试提议 API 所需的操作
- 您必须使用 Insider 版本,因为提议的 API 经常更改。
- 您必须在扩展的
package.json
文件中包含以下行:"enableProposedApi": true
。 - 将最新版本的 vscode.proposed.d.ts 文件复制到您的项目源代码位置。
您不能发布使用提议 API 的扩展。在下一次发布中可能会有破坏性更改,我们绝不希望破坏现有扩展。
测试
我们原计划在此次迭代中完成测试 API 的第一部分,但由于其他正在进行的功能数量众多而被推迟。虽然本次迭代中测试 API 没有破坏性更改,但我们继续在其编辑器体验方面取得进展。例如,Peek 视图获得了分屏视图,允许您浏览当前和过去测试运行的结果。
主题:Codesong
测试新增了一组以 Ctrl+; 开头的组合键,Peek 视图现在更好地支持 Markdown 消息,并且修复了许多错误。
如果您使用 Test Explorer UI 扩展进行测试,您可以切换设置 testExplorer.useNativeTesting
以切换到新的原生 UI。在下一次迭代中,我们计划增加此设置的社会化,并开始与合作伙伴扩展团队一起采用。
终端配置文件贡献
此 API 将使扩展能够贡献终端配置文件系统。扩展需要做几件事才能使其正常工作。首先在 package.json
中贡献配置文件。
"contributes": {
"terminal": {
"profiles": [
{
"title": "Profile from extension",
"id": "my-ext.terminal-profile",
"icon": "lightbulb"
}
]
},
}
然后在新 onTerminalProfile
激活事件上激活扩展
"activationEvents": [
"onTerminalProfile:my-ext.terminal-profile"
]
最后,在激活事件中注册提供程序
vscode.window.registerTerminalProfileProvider('my-ext.terminal-profile', {
provideProfileOptions(token) {
return {
name: 'Profile from extension',
shellPath: 'cmd.exe'
};
}
});
如果启用了提议的 API,则扩展贡献的配置文件应显示在配置文件列表中。
终端选项中的 iconPath 支持
标准 iconPath
类型在 TerminalOptions
和 TerminalExtensionOptions
上受支持,用于设置终端的图标,该图标显示在终端的选项卡上。
readonly iconPath?: Uri | { light: Uri; dark: Uri } | ThemeIcon;
更改伪终端的标题
新事件 Pseudoterminal.onDidChangeName
启用了对基于伪终端的终端的控制。
const writeEmitter = new EventEmitter<string>();
const nameEmitter = new EventEmitter<string>();
const pty = {
onDidWrite: writeEmitter.event,
open: () => writeEmitter.fire('Type to change the title of the terminal'),
close: () => {
/* noop*/
},
handleInput: (data: string) => nameEmitter.fire(data)
};
const terminal = vscode.window.createTerminal({
name: `My Terminal`,
pty
});
terminal.show();
允许文件系统提供程序声明文件为只读
文件系统提供程序现在可以通过 FileStat
上的新 permissions
属性,通过将该属性的值设置为 FilePermission.Readonly
,将单个文件标记为只读。只读文件不可编辑。
注意:如果所有文件都应视为只读,您可以在调用 registerFileSystemProvider
时使用现有的 isReadonly
选项。
在 asExternalUri 中支持工作区 URI
现有的 vscode.env.asExternalUri
API 现在支持处理工作区 URI。这允许扩展作者创建系统范围的 URI,直接打开给定的工作区。
例如
const uri = await vscode.env.asExternalUri('file:///Users/john/work/code');
生成的 uri
可以由操作系统打开,VS Code 将打开该工作区。
工程
Electron 沙盒支持的进展
此里程碑,我们继续使 VS Code 窗口准备好启用 Electron 的沙盒和上下文隔离功能。
具体来说
- 我们从更多用于渲染器的代码中移除了 Node.js 依赖项。
- 我们继续研究完全放弃
webview
的使用,转而为我们的自定义视图和编辑器切换到iframe
。
文档
VS Code 在 Build 2021
如果您错过了 Microsoft Build 2021 开发者活动,您仍然可以观看点播会话。查看Visual Studio Code at Build 2021博客文章,我们整理了一份我们认为 VS Code 用户会感兴趣的会话列表。
浏览器调试
新的主题VS Code 中的浏览器调试描述了对 Edge 和 Chrome 浏览器的内置调试支持。您可以配置 VS Code 以启动新的浏览器调试会话(通过调试:打开链接命令)或附加到正在运行的浏览器。
PyTorch
有一个新主题,介绍了如何在 VS Code 中使用 PyTorch 机器学习框架。在VS Code 中的 PyTorch 支持文章中,您将学习如何使用 PyTorch 和 TensorFlow 数据类型扩展 Jupyter Notebooks。
值得注意的修复
- 71966:经常出现整个窗口挂起
- 85332:Windows:文件删除时冻结
- 95077:终端“单词”链接提供程序不支持换行
- 108804:在打开窗口之前不要等待 shell 环境解析
- 120004:VS Code 集成终端中奇怪的字母间距
- 125035:调试控制台筛选文本应在重新加载后保留
- iOS/iPadOS:对 iOS/iPadOS 平台进行了多项修复
感谢
最后但同样重要的是,衷心感谢以下本月为 VS Code 做出贡献的人
对我们问题追踪的贡献
- John Murray (@gjsjohnmurray)
- Andrii Dieiev (@IllusionMH)
- Nicholas Rayburn (@nrayburn-tech)
- Alessandro Fragnani (@alefragnani)
- ArturoDent (@ArturoDent)
对 vscode
的贡献
- @Ashray123 (Ashray Jha):修改了 Markdown 预览嵌套列表样式 PR #124445
- @barbaravaldez (Barbara Valdez):拖放 API 的初始实现 PR #122239
- @CommaNet (Melvin):更新 README.md PR #124654
- @danielgary (Daniel Gary):将 wmic 调用替换为 windows-process-tree PR #123895
- @DonJayamanne (Don Jayamanne):转换 DTO 时保留执行摘要 PR #124549
- @eltociear (Ikko Ashimine):修复 files.ts 中的拼写错误 PR #124693
- @gjsjohnmurray (John Murray)
- 允许 FileSystemProvider 将文件统计为只读 (#_73122) PR #111237
- 修复 #123831 处理调试适配器中 ErrorResponse 消息中的命令 URL PR #123833
- @habibkarim (Habib Karim):实现 Pseudoterminal.onDidChangeName PR #115276
- @hantatsang (Sang):修复欢迎视图链接缺少悬停颜色 PR #121835
- @huszkacs (Csaba Huszka):修复安卓屏幕键盘退格键问题。 PR #124288
- @inidaname (Hassan Sani):为 Markdown 预览中的表格添加底部间距 PR #124385
- @jeanp413 (Jean Pierre)
- 修复 pascalCase 片段格式化程序无法处理数字 PR #122796
- 添加在终端选项卡上拖放文件的支持 PR #123429
- 修复百分比编码的 Markdown 链接解码不正确 PR #123584
- 修复进程资源管理器不显示扭曲箭头 PR #123910
- 修复进程资源管理器列表样式不工作 PR #123919
- 修复终端查找小组件不应覆盖选项卡 PR #124317
- 修复更新终端面板操作时监听器泄漏 PR #124741
- 重新加载时保留 repl 筛选值 PR #125221
- @kabel (Kevin Abel):实现 GitHub Enterprise 身份验证提供程序 PR #115940
- @leilapearson (Leila Pearson):Explorer 的新排序顺序词典选项设置 PR #97272
- @mzainuddin51 (Mohammad Zainuddin):修复问题 #123772 的不正确链接 PR #124203
- @nrayburn-tech (Nicholas Rayburn)
- 添加内联调试值的颜色自定义 PR #123065
- 修复问题报告器在提交时不关闭并防抖提交 PR #123340
- 向建议添加 showDeprecated 选项,筛选出已弃用的选项 PR #123351
- 如果 tsserver 日志开启超过 7 天,添加通知 PR #124149
- 如果只有一个组,则隐藏终端选项卡选项 PR #124480
- @plankp (Paul Teng):添加模式匹配 'in' PR #121941
- @rtzoeller (Ryan Zoeller):为 Make 语言注册 .mak 扩展 PR #122614
- @shskwmt (Shunsuke Iwamoto):修复 #116335:将文件路径文本发送到拖放的终端区域 PR #116621
- @suzmue (Suzy Mueller):修复异常时调试调用堆栈显示设置 PR #123726
- @tejasvi (Tejasvi S. Tomar):改进 TextEditor.setDecorations 的文档 PR #122785
- @ValeraS (Valeriy):修复:使用 addListener 而不是 addEventListener 来观察媒体查询列表 PR #121557
- @vibhavsarraf (Vibhav):规范化终端单词链接中的路径 PR #123246
- @wendellhu95 (Wendell):测试:为事件 Relay 添加测试 PR #119070
对 vscode-css-languageservice
的贡献
- @jeanp413 (Jean Pierre):修复带点后缀的文件名的链接解析 PR #241
对 vscode-eslint
的贡献
- @edupsousa (Eduardo Pereira de Sousa):将严重性“off”添加到 eslint.rules.customizations PR #1243
- @karlhorky (Karl Horky):为 Node.js 的系统版本文档说明“node” PR #1247
对 vscode-js-debug
的贡献
- @danielgary (Daniel Gary):990 - 支持使用启动配置名称作为终端标题 PR #991
- @lhchavez:功能:允许 debugServerMain.ts 的调用者指定主机 PR #1006
对 vscode-languageserver-node
的贡献
- @yanmofeixi:向客户端未准备好错误添加更多信息 PR #764
对 vscode-pull-request-github
的贡献
- @IllusionMH (Andrii Dieiev):删除了 TSLint 建议和残留提及 PR #2758
对 vscode-vsce
的贡献
- @jedwards1211 (Andy Edwards):使用 ignore npm 包而不是自定义代码处理 .vscodeignore PR #418
- @oliversalzburg (Oliver Salzburg):修复:缺少错误响应处理 PR #564
对 language-server-protocol
的贡献
- @DanTup (Danny Tuppeny):澄清 textDocument/selectionRange 如何处理某些缺失结果 PR #1272
- @HO-COOH:更新 specification-3-16.md PR #1259
- @narnaud (Nicolas Arnaud-Cormos)
- @NTaylorMullen (N. Taylor Mullen)
对 monaco-languages
的贡献
- @akonatala (apoorva konatala):更新 cameligo 语言支持 PR #137
- @anark:为 liquid 语言添加别名和 mime 类型 PR #136
- @mattvague (Matt Vague):修复 liquid 不正确的文件名 PR #135
对 monaco-typescript
的贡献
- @paranoidjk (paranoidjk):修复:支持 extraLib 文件的“转到定义” PR #79