2020 年 2 月(版本 1.43)
更新 1.43.1: 此更新解决了这些 问题。
更新 1.43.2: 此更新解决了这些 问题。
下载:Windows: x64 | Mac: Intel | Linux: deb rpm tarball snap
欢迎使用 Visual Studio Code 2020 年 2 月发行版。此版本中有许多更新,我们希望您会喜欢,其中一些主要亮点包括
- 搜索编辑器 - 在全尺寸编辑器中搜索并保存您的全局搜索结果。
- 可拖动的分割条角 - 通过拖动分割条角轻松更改编辑器布局。
- Linux 屏幕阅读器支持 - VS Code 现在支持 Orca 屏幕阅读器。
- 迷你地图大小选项 - 用于适应或填充迷你地图垂直布局的新选项。
- 列选择模式 - 列模式切换允许您快速选择文本块。
- 在选择时显示空格 - 仅在选定的文本中呈现空格字符。
- 转换为模板字符串 - 将连接转换为 JavaScript/TypeScript 模板字符串。
- JS/TS 调用层次结构视图 - 查看对函数的所有调用或来自函数的所有调用,并深入查看调用者的调用者。
- 远程开发 - 支持 Windows 和 macOS SSH 主机,SSH 连接共享。
- 设置同步预览 - 设置同步允许您在机器之间共享设置和键绑定。
如果您想在线阅读这些发行说明,请访问 更新,地址是 code.visualstudio.com。
内部人员: 想尽快尝试新功能吗?您可以下载每晚的 内部人员 构建版本,并尽快尝试最新的更新。有关最新的 Visual Studio Code 新闻、更新和内容,请在 Twitter 上关注我们 @code!
工作台
搜索编辑器
经过几次在 内部人员 中的稳定迭代后,我们正在发布搜索编辑器,它允许您在全尺寸编辑器中查看工作区搜索结果,其中包含语法高亮显示和可选的周围上下文行。这是一段时间以来 强烈要求的功能。
以下是搜索单词“SearchEditor”的示例,匹配项前后各有两行文本作为上下文
主题:A Touch of Lilac,字体:Hasklig
在搜索编辑器中,可以使用转到定义操作导航到结果,例如 F12 在当前编辑器组中打开源位置,或 ⌘K F12(Windows,Linux Ctrl+K F12) 在侧边编辑器中打开位置。此外,双击可以有选择地打开源位置,可以使用 search.searchEditor.doubleClickBehaviour
设置进行配置。
您可以使用 搜索编辑器:打开新的搜索编辑器 命令打开新的搜索编辑器,或者使用搜索视图顶部的 打开新的搜索编辑器 按钮。或者,您可以使用添加到结果树顶部的 在编辑器中打开 链接,或 搜索编辑器:在编辑器中打开结果 命令,将现有结果从搜索视图复制到搜索编辑器。
注意:您可以尝试实验性的 搜索编辑器:应用更改 扩展,以将您在搜索编辑器中所做的编辑同步回源文件
可拖动的分割条角
您是否知道您可以通过抓取和拖动它们之间的交点来同时调整两个正交分割条的大小?这已经适用于编辑器分割条,现在也适用于编辑器和视图之间的边缘
主题:GitHub Sharp,字体:Fira Code
经过公证的 macOS 构建
用于 macOS 的 Visual Studio Code 现在已通过 Apple 公证,因此您不再会收到以下对话框
阅读 调查问题 和 Apple 的开发者文档,了解更多详细信息。
进度通知
指示长时间运行操作的通知从此版本开始行为略有不同
- 它们不再提供通用的 关闭 按钮,因为它给出了有关操作是否已取消的错误印象。您仍然可以按 Esc 键隐藏通知。
- 每当通知在操作仍在进行时被隐藏时,通知会在状态栏中指示其操作的进度。
后一项更改可帮助您了解在您关闭通知后,操作仍在后台继续运行(例如,长时间运行的保存操作)。
在选择 取消 按钮之前,操作仍在运行
主题:Dracula Official,字体:Fira Code
未命名编辑器
新的设置 workbench.editor.untitled.labelFormat
允许您控制未命名的编辑器是否应使用文件内容作为标题。可能的值为 content
或 name
。为以前的行为配置 'workbench.editor.untitled.labelFormat': 'name'
,其中未命名的编辑器将具有一个简短的标题,例如 未命名-1。
将文本粘贴到未命名的编辑器时,VS Code 现在会自动尝试从第一行文本中检测语言模式。例如,如果第一行包含典型的 XML 标头 <?xml version="1.0" encoding="UTF-8"?>
,则粘贴 XML 时会自动设置 XML 模式。
通过应用程序链接打开工作区
VS Code 支持通过协议链接打开文件(例如 vscode://file/<file-path>
)。在此里程碑中,我们将支持扩展到包括打开文件夹或工作区。
文件夹或工作区的语法与文件相同
vscode://file/<path>
vscode-insiders://file/<path>
欢迎视图
欢迎视图是工作台的新增功能,它允许视图为用户创建启动体验,以在没有任何有意义的内容要显示时创建内容或配置 VS Code。某些视图已经采用了此基础结构,例如文件资源管理器,它将提供打开文件夹或克隆 Git 存储库以帮助您入门。
主题:GitHub Sharp
源代码管理欢迎视图
得益于新的欢迎视图基础结构,源代码管理视图现在为某些情况提供了更好的体验,在这些情况下,它本来会显示为空白。例如,它现在可以引导用户打开文件夹或克隆存储库,或者在未检测到安装时安装 Git。
主题:GitHub Sharp
编辑器
迷你地图大小
有一个新的设置 editor.minimap.size
,它控制迷你地图如何使用垂直空间
- 当设置为
proportional
(默认值)时,每行在迷你地图中获得一定量的垂直空间,具体取决于editor.minimap.scale
。例如,在高 DPI 监视器上,配置的比例为1
(默认值)时,每行在迷你地图中获得 4 像素。因此,对于 100 行的文件,迷你地图中渲染的行的高度为 400 像素,对于 1000 行的文件,高度为 4000 像素。这意味着对于大型文件,迷你地图也会滚动,因为当前文件已滚动。 - 当设置为
fit
时,迷你地图的高度限制为永远不大于编辑器高度。因此,如果文件有很多行,则会对它们进行采样,并且迷你地图中只会渲染一部分,这样就无需滚动迷你地图。 - 当设置为
fill
时,迷你地图的高度始终是编辑器高度。对于大型文件,这也是通过对行进行采样来实现的,但对于小型文件,这是通过为每行保留更多垂直空间(拉伸行)来实现的。
这里,大小从 proportional
更改为 fit
,然后在较小的文件中,从 fit
更改为 fill
迷你地图背景和滑块颜色
现在有新的颜色用于自定义迷你地图及其滑块。新颜色之一是 minimap.background
,当颜色被定义为透明时(降低 #RRGGBBAA Alpha 通道),迷你地图将以透明方式呈现
{
"workbench.colorCustomizations": {
"minimap.background": "#00000055"
}
}
列选择模式
有一个新的全局切换,可以通过 选择 > 列选择模式 菜单项访问。进入此模式后,如状态栏所示,鼠标手势和箭头键将创建列选择
您还可以从状态栏禁用列选择模式。
在选择时呈现空格
editor.renderWhitespace
设置的默认值已从 none
更改为 selection
。现在默认情况下,空格字符将在突出显示的文本上呈现。
此处,制表符和空格字符显示在选定的区域中
Peek 中的定义链接
现在可以更好地控制 转到定义 鼠标手势的行为。默认情况下,通过鼠标执行的 转到定义 会打开一个单独的编辑器,但是如果新设置 editor.definitionLinkOpensInPeek
为 true
,则手势将在 Peek 视图中打开。
在折叠行的任意位置展开
新增了一个设置项:编辑器:在行尾点击后展开 (editor.unfoldOnClickAfterEndOfLine
),它控制了您在折叠行右侧的空白区域(...
之后)点击时的行为。当设置为 true
时,您可以在折叠行文本之后的任何位置点击,而无需担心是否精确选择了省略号(...
)。默认情况下,此选项处于关闭状态。
撤销跨多个文件的文本编辑
当撤销重命名或影响多个文件的代码操作时,VS Code 现在允许您撤销所有受影响文件中的更改。
撤销跨文件编辑时将显示提示
注意:目前尚不支持文件操作,例如重命名文件。例如,在 Java 中重命名类名(同时也会重命名文件名)尚不支持跨文件撤销。
具有不同颜色的多个标尺
现有的 editor.rulers
设置已扩展,允许定义具有自定义颜色的标尺。在下面的截图中,列 80 处有一个洋红色标尺,列 90 处有一个红色标尺。
{
"editor.rulers": [
{ "column": 80, "color": "#ff00ff" },
{ "column": 90, "color": "#ff0000" }
]
}
编辑器顶部和底部填充
现在可以使用 editor.padding.top
和 editor.padding.bottom
在编辑器的顶部或底部保留空白(像素数)。
这是顶部填充了 50 像素的编辑器。
{
"editor.padding.top": 50
}
滚动主要轴
当尝试使用现代触摸板垂直滚动时,经常会发生文件也水平滚动的情况。现在有一个新的设置 editor.scrollPredominantAxis
(默认设置为 true),它可以阻止“对角线”滚动。这会强制滚动手势要么垂直要么水平(基于最高的绝对滚动增量),但永远不会是对角线。
Linux 上的 Shift+Insert
在 1.42 版本中,Shift+Insert
被修改为从选择剪贴板粘贴。我们收到了大量反馈,认为这打破了现有的肌肉记忆,因此我们决定回滚,让 Shift+Insert
像以前一样从常规剪贴板粘贴。
辅助功能
Linux 屏幕阅读器支持
在社区的帮助下,我们一直在努力使 VS Code 在 Linux 上使用 Orca 屏幕阅读器时具有可访问性。Orca 和 Chromium 仍在积极开发屏幕阅读器支持,因此要使其完全正常工作,还需要做一些事情。
- 请确保使用 Orca 的最新 master 版本。说明可以在 问题 #91063 中找到。
- 请确保在 VS Code 中设置了
"editor.accessibilitySupport": "on"
。您可以使用设置来完成此操作,也可以运行 显示辅助功能帮助 命令并按下 Ctrl+E 来打开屏幕阅读器优化模式。
启用该设置后,VS Code 应该可以与 Orca 屏幕阅读器一起工作。
语言
TypeScript 3.8.3
VS Code 现在捆绑了 TypeScript 3.8.3。此重大更新带来了对新语言特性的支持,包括ECMAScript 私有字段、顶层 await 表达式和 export * as ns 语法,以及许多工具特性和改进。此更新还修复了许多重要的错误。
您可以在 TypeScript 博客上阅读更多关于 TypeScript 3.8 的信息。
转换为模板字符串重构
您可以对 JavaScript 和 TypeScript 使用新的 转换为模板字符串 重构,以快速将字符串连接转换为模板字符串。
JavaScript 和 TypeScript 的调用层次结构支持
TypeScript 3.8 在 JavaScript 和 TypeScript 中引入了 调用层次结构支持。
支持 http(s) @link JSDoc 内联标签
IntelliSense 现在为 http 和 https 链接渲染 JS Doc @link 内联标签。在下面的示例图片中,请注意 lightbulb menu
的 @link
是如何在悬停时渲染的。
URL 的 @link
对 JavaScript 和 TypeScript 都有效,并在悬停提示、建议详细信息和签名帮助中渲染为可点击的链接。
TypeScript 语义高亮显示
语义高亮显示现在默认对 TypeScript 和 JavaScript 启用。语义高亮显示由 TypeScript 语言服务器提供,并在基于 TextMate 语法的语法高亮显示之上进行。默认语法(TextMate)高亮显示器将许多标记分类为 variables
,现在它们被解析为命名空间、类、参数等等。
语义高亮显示由以下设置控制:
"editor.semanticHighlighting.enabled": true
JSON 模式
在将文件名与模式关联时,您现在还可以使用排除模式。排除模式以“!”开头。要匹配,至少需要匹配一个模式,并且最后一个匹配的模式不能是排除模式。
"json.schemas": [
{
"fileMatch": [
"/receipts/*.json",
"!/receipts/*.excluded.json"
],
"url": "./receipts.schema.json"
}
]
调试
UI 中更突出的“运行”
用户研究表明,新用户很难找到在 VS Code 中运行程序的方法。一个原因是,现有的“调试”功能与他们理解的“运行”程序无关。因此,我们正在使“运行”在 UI 中更加突出。
- 主菜单的 调试 已更改为 运行 菜单。
- 运行和调试 视图已更改为 运行 视图,相应的活动栏图标现在显示一个大的“播放”图标,并带有一个小的“bug”装饰。
调试控制台分组
VS Code 调试控制台现在支持输出分组。调试扩展可以指示何时应将调试控制台输出在公共父级下分组。目前,只有 Mock Debug 扩展实现了输出分组,但很快其他调试扩展也会跟进 - 最值得注意的是 JavaScript 调试器。
禁用调试控制台历史记录建议
现在可以通过新的 debug.console.historySuggestions
设置关闭调试控制台中的历史记录建议。默认情况下,历史记录建议处于启用状态。
集成终端
Unicode 11 支持
终端中字符的宽度现在默认为 Unicode 11 宽度。这对大多数人来说意味着表情符号将正确显示为宽字符。
更好的 Alt+Click 导航提示支持
终端有一个功能,允许您在单元格上 Alt+Click
,光标将导航到该单元格。在历史上,当在 shell 的提示符中时,这只在单行上起作用,即使它被换行了。这已得到改进,可以在完整的换行上工作。
主题:Sapphire
请注意,这可能在 Windows 上还不能正常工作,但 最近对 ConPTY 的更改 应该会在未来改进这一点。
任务
任务快速选择更新
当执行 运行任务 命令时显示的“任务快速选择”已更新,以显示哪些任务提供程序仍在运行。如果您不需要该提供程序的任务,停止检测 按钮将立即显示到目前为止已检测到的任务,因此您不必等待任何缓慢的任务提供程序。
主题:One Dark Pro,字体:Fira Code
任务实例限制
任务 "runOptions"
现在包含一个 "instanceLimit"
,它指定允许的任务实例数。默认的 "instanceLimit"
为 1。
promptString 密码输入
"promptString"
用户输入类型可以具有 "password": true
,这将使下拉输入框像密码一样模糊键入的内容。
预览功能
预览功能尚未准备好发布,但功能足以使用。我们欢迎您在开发过程中提供早期反馈。
设置同步
过去几个月,我们一直在努力支持跨机器同步 VS Code 设置、扩展和键盘快捷键(热门功能请求 #2743)。在这个里程碑中,我们很高兴地宣布,此功能已准备好在我们的下一个 1.44.0 Insider 版本中进行预览。您现在可以在所有机器的所有 VS Code 安装中同步您的首选项。您也可以在全新机器上以最少的努力使用您的个人首选项引导 VS Code。
以下视频演示了在新机器上本地应用扩展和设置
目前同步了设置、键盘快捷键、扩展程序和显示语言,但我们计划添加更多。您可以查看我们提出的 设置同步功能 列表。
默认情况下,机器设置(具有 machine
或 machine-overridable
范围)不会同步。您还可以使用设置编辑器或使用 sync.ignoredSettings
设置在此列表中添加或删除设置。
主题:GitHub Sharp
默认情况下,键盘快捷键按平台同步。如果您的键盘快捷键与平台无关,则可以通过禁用 sync.keybindingsPerPlatform
设置来跨平台同步它们。
所有内置和安装的扩展程序都会同步,包括其全局启用状态。您可以从“扩展”视图或使用 sync.ignoredExtensions
设置来跳过同步扩展。
主题:GitHub Sharp
设置同步支持在同步时检测设置和键盘快捷键中的冲突。冲突使用差异编辑器显示,左侧显示传入(远程)更改,右侧显示本地更改。您可以通过在右侧编辑器中编辑来解决冲突,并使用编辑器中提供的操作合并更改。
此处,远程 colorTheme
设置值通过接受远程操作来选择。
主题:GitHub Sharp,GitHub Sharp Dark
可以在日志(同步)输出视图中监视设置同步活动。所有本地首选项都会在同步期间更改时,在磁盘上备份最近 30 天的数据。您可以使用命令同步:打开本地备份文件夹转到备份位置并检索旧的首选项。
主题:GitHub Sharp
您可以随时关闭同步,可以在当前的 VS Code 实例上关闭,也可以在所有的 VS Code 安装上关闭。如果选择禁用所有同步,您的数据将从云端删除。
注意:设置同步使用 Microsoft 帐户来存储您的 VS Code 首选项以进行同步,因此您需要一个帐户才能使用此功能。有关更多信息,请参阅设置同步文档。
时间线视图
在此迭代中,我们继续改进了新的时间线视图。它现在在 Insiders 版本上默认启用,并且可以通过以下设置在稳定版上启用。
"timeline.showView": true
在时间线视图下方,显示文件的 Git 提交历史记录。
我们现在添加了分页支持(通过上面显示的加载更多操作),并在右侧添加了相对时间戳。扩展程序还可以向时间线视图以及各个时间线项贡献菜单项。在上面的屏幕截图中,内置的 Git 扩展程序正在贡献命令,复制提交 ID 和复制提交消息。
新的 JavaScript 调试器
本月,我们继续改进了新的 JavaScript 调试器。它默认安装在 Insiders 版本上,并且可以在 VS Code 稳定版中从 Marketplace 安装。您可以通过启用 debug.javascript.usePreview
设置,开始将其与现有的启动配置一起使用。以下是本月添加的一些新功能:
美化打印
主题:Earthsong,字体:Fira Code
调试器现在可以美化打印文件,这在处理缩小后的源文件时特别有用。当您步入或打开看起来已缩小的文件时,它会显示一个提示,并且您还可以通过调试:美化打印以进行调试命令手动触发美化打印。
您可以通过选择从不来关闭建议提示,或者将设置 debug.javascript.suggestPrettyPrinting
更改为 false
。
支持 Microsoft Edge 和 WebView2
我们现在支持启动新的 Microsoft Edge 浏览器,只需将您的调试类型从 chrome
或 pwa-chrome
更改为 pwa-msedge
即可尝试。它支持与 chrome
相同的所有配置设置。
随之而来的是对桌面 Windows 应用程序中的 WebView2 控件的支持。请查看我们的webview 演示,了解如何设置它。
远程调试
您现在可以在新的调试器中调试来自远程工作区(例如 GitHub Codespaces 或 远程 SSH)的浏览器源代码。要进行设置,请端口转发您的 Web 服务器(或使用简单的静态 Web 服务器),然后创建一个指向转发端口的 chrome
或 pwa-msedge
启动配置。
例如
{
"version": "0.2.0",
"configurations": [
{
"type": "pwa-msedge",
"request": "launch",
"name": "Debug my App",
"url": "https://127.0.0.1:5000" // <- debug an app forwarded on port 5000
}
]
}
当您启动调试会话时,浏览器将在您的计算机上打开,您可以像通常在 VS Code 中那样进行调试。
更多视图可移动
在上一个版本中,VS Code 只是让您体验了一把将视图重新定位到面板的功能。在这个版本中,此体验已扩展到更多视图。现在,您可以移动诸如调试/运行视图或新的时间线视图之类的视图。您还可以将视图移动到侧边栏中的其他视图中。例如,您可能希望将打开的编辑器视图移动到源代码控制视图中。您可以通过拖动视图并将其放置在活动栏或面板中的所需位置来完成所有这些操作。
下面的动画突出显示了将打开的编辑器视图移动到其他视图,然后移动到面板的过程。
主题:Horizon Bright,字体:Cascadia Code
我们还引入了一个新的命令,可以使用键盘更轻松地移动视图:视图:移动焦点视图 (workbench.action.moveFocusedView
)。
这是一个预览功能,因此如果您陷入了无法修复的状态,可以使用一个命令将所有视图重置回其原始位置:视图:重置视图位置 (workbench.action.resetViewLocations
)。
对扩展的贡献
远程开发
我们正在继续开发远程开发扩展程序,该程序允许您使用容器、远程计算机或 适用于 Linux 的 Windows 子系统 (WSL) 作为全功能的开发环境。
1.43 中的功能亮点包括:
- 通过应用程序链接打开远程工作区。
- 远程 - SSH:支持 Windows 和 macOS SSH 主机。
- 远程 - SSH:默认启用连接共享。
- WSL:请查看最近的在 WSL 2 中使用 Docker 博客文章。
您可以在远程开发版本说明中了解新的扩展功能和错误修复。
Vetur
用于 Vue.js 的 Vetur 扩展程序现在包括对模板插值的更好的自动完成功能。您可以在0.24.0 版本中找到更改日志。
扩展创作
调试器扩展 API
调试欢迎视图
如 欢迎视图内容 API 部分所述,debug
视图现在可以接受欢迎视图内容贡献。这些新增内容可以用于指导初学者使用简化运行或调试程序的特定功能。
为了使视图不被过多的欢迎视图内容贡献所干扰,我们建议仅为当前活动的语言启用单独的贡献。为了方便这一点,我们引入了一个新的上下文键 debugStartLanguage
,它被设置为上次使用调试器的活动编辑器语言。
例如,如果您的调试器以 Python 为目标,则仅当 debugStartLanguage == "python"
时,您才会贡献欢迎视图内容。如果您的调试器以多种语言为目标,则可以使用 OR 运算符 (||
) 来组合多个条件。
新的调试悬停 API
如今,VS Code 的调试悬停使用基于正则表达式的启发式方法来查找鼠标下的表达式,VS Code 调试器对其进行评估,然后在悬停中显示结果。由于正则表达式不可配置,因此并非所有语言都得到正确处理(或者没有尽可能充分地处理)。问题 #84044、#89603 和 #89332 描述了典型问题。
在此里程碑中,我们引入了新的扩展 API 来控制调试悬停的行为。
可以为语言注册一个 EvaluatableExpressionProvider
,以提供鼠标下的表达式,VS Code 调试器将针对活动调试会话对其进行评估。
这是来自 Mock debug 示例的简单示例,它显示了基于 getWordRangeAtPosition
API 的(简单)实现。
vscode.languages.registerEvaluatableExpressionProvider('markdown', {
provideEvaluatableExpression(
document: vscode.TextDocument,
position: vscode.Position
): vscode.ProviderResult<vscode.EvaluatableExpression> {
const wordRange = document.getWordRangeAtPosition(position);
if (wordRange) {
return new vscode.EvaluatableExpression(wordRange);
}
return undefined; // nothing evaluatable found under mouse
}
});
不再转义空格
VS Code 调试器 UI 不再转义或引用从调试扩展程序或调试适配器接收到的任何空格。例如,在 DAP 变量中或作为 DAP 输出事件接收到的所有字符串都按原样显示在 UI 中,不做任何修改。
这意味着现在由调试扩展程序或调试适配器决定是否需要在将数据发送到 VS Code 之前转义空格。更多详细信息可以在 issue #73845 中找到。
CodeAction.disabled
借助 CodeAction.disabled
属性,扩展程序现在可以告诉 VS Code 为什么给定的 CodeAction
对于用户的当前选择是不可能的。这对于重构特别有用。
这是在我们的代码操作示例扩展程序中使用 .disabled
的示例。
import * as vscode from 'vscode';
export class Emojizer implements vscode.CodeActionProvider {
public provideCodeActions(
document: vscode.TextDocument,
range: vscode.Range
): vscode.CodeAction[] | undefined {
const action = new vscode.CodeAction(
`Convert to ${emoji}`,
vscode.CodeActionKind.Refactor.append('emojize')
);
if (!this.isAtStartOfSmiley(document, range)) {
// Tell the user why our action is not available
action.disabled = { reason: 'Selection is not currently on a :)' };
return [action];
}
action.edit = new vscode.WorkspaceEdit();
action.edit.replace(
document.uri,
new vscode.Range(range.start, range.start.translate(0, 2)),
'😀'
);
return action;
}
}
如果用户尝试通过键绑定应用已禁用的代码操作,则 VS Code 将向用户显示 .disabled
错误消息。
此外,为了帮助发现,禁用的代码操作在重构和源操作上下文菜单中显示为淡入。
请注意,禁用的操作不会显示在顶层灯泡菜单中。
Terminal.exitStatus
扩展程序现在可以确定终端是否已退出,如果已退出,则可以使用哪个退出代码(如果有)。
window.onDidCloseTerminal(t => {
if (t.exitStatus && t.exitStatus.code) {
vscode.window.showInformationMessage(`Exit code: ${t.exitStatus.code}`);
}
});
向诊断错误添加链接
我们已将提议的诊断链接 API 升级为稳定版。
class Diagnostic {
...
/**
* A code or identifier for this diagnostic.
* Should be used for later processing, e.g. when providing [code actions](#_CodeActionContext).
*/
code?: string | number | {
/**
* A code or identifier for this diagnostic.
* Should be used for later processing, e.g. when providing [code actions](#_CodeActionContext).
*/
value: string | number;
/**
* A target URI to open with more information about the diagnostic error.
*/
target: Uri;
};
}
工作区编辑元数据
我们已最终确定 WorkspaceEditEntryMetadata
API。它允许扩展作者对工作区编辑的更改进行分类,特别是如果更改在应用之前需要审查。
调试适配器协议
在输出事件中支持分组
为了保持输出日志按相关消息分组,我们在 output
事件中添加了一个可选的 group
属性。group
的可能值有 start
和 startCollapsed
,分别用于打开展开或折叠的组,以及 end
用于关闭组。
注意:从这个版本开始,VS Code 支持此 DAP 增强功能。
允许通过完成项放置光标
在完成项中添加了可选的 selectionStart
和 selectionLength
属性。通过这些属性,可以在插入完成文本后控制客户端的当前选择(或插入符位置)。
注意:VS Code 尚未支持此 DAP 增强功能。计划在下一个版本中支持。
提案:进度事件
我们在向调试适配器协议添加进度事件的提案上取得了一些进展。如果您有兴趣,可以参与此DAP 功能请求的讨论。
语言服务器协议
语言服务器协议 3.16 版本的工作已开始。
新版本中包含以下提议的支持:
- 用于完成项的插入/替换编辑。
- 诊断的结构代码(例如链接支持)。
- 符号信息和文档符号的标签支持。
建议的扩展 API
每个里程碑都带有新的提议 API,扩展作者可以尝试使用它们。与往常一样,我们渴望得到您的反馈。这是您尝试提议 API 需要做的:
- 您必须使用 Insiders 版本,因为提议的 API 经常更改。
- 您的扩展的
package.json
文件中必须包含这一行:"enableProposedApi": true
。 - 将最新版本的 vscode.proposed.d.ts 文件复制到您的项目的源代码位置。
请注意,您不能发布使用提议 API 的扩展。下一个版本中可能会有重大更改,我们绝不希望破坏现有的扩展。
自定义编辑器 API
在此迭代中,我们继续致力于自定义编辑器 API 提案。值得注意的更改包括:
- 重命名 API 方法,使其更短且更一致。
- 通过引入
CustomTextEditorProvider
,简化了文本文件自定义编辑器的创建。此自定义编辑器使用 VS Code 的普通TextDocument
作为其数据模型,因此您无需自己实现save
、backup
和其他操作。这还可以轻松实现资源自定义编辑器和同一资源的文本编辑器之间的实时同步。 - 引入
CustomDocument
来存储二进制CustomEditor
使用的模型。每个资源有一个CustomDocument
,但用户可以在该资源上打开多个自定义编辑器。
请继续测试并在我们的 自定义编辑器 API 提案上分享反馈。尽管 API 的具体细节可能仍会更改,但我们相信当前的提案反映了我们希望尽快最终确定的内容。
CodeActionProviderMetadata.documentation
我们修订了我们之前关于标准化扩展如何为其代码操作贡献文档的提案。根据更新后的提案,现在使用 CodeActionProviderMetadata
类型的 documentation
属性提供文档。
例如,以下是我们内置的 JavaScript 和 TypeScript 扩展如何贡献文档的示例:
class TypeScriptRefactorProvider implements vscode.CodeActionProvider {
public static readonly metadata: vscode.CodeActionProviderMetadata = {
providedCodeActionKinds: [ vscode.CodeActionKind.Refactor ],
documentation: [
{
kind: vscode.CodeActionKind.Refactor,
// This command opens a webpage when executed
command: {
command: LearnMoreAboutRefactoringsCommand.id,
title: localize('refactor.documentation.title', "Learn more about JS/TS refactorings")
}
}
]
};
...
}
当用户请求重构时,文档将在主代码操作列表之后呈现。
Issue #86788 跟踪提案的状态。
欢迎视图内容 API
某些视图现在支持从扩展贡献的欢迎内容。有关更多信息,请参阅原始问题。
已采用此 API 的视图有:
explorer
- 文件资源管理器scm
- 源代码管理debug
- 运行/调试
例如,以下是 Git 扩展程序在 explorer
欢迎视图上提供的用于克隆存储库的欢迎视图内容:
主题:GitHub Sharp
OpenDialogOptions 和 SaveDialogOptions 标题
OpenDialogOptions
和 SaveDialogOptions
都具有提议的 title
属性。是否显示 title
取决于平台,但如果平台确实显示 title
,则会在“保存”或“打开”对话框上方显示。例如,内置命令工作区:将工作区另存为... 将标题设置为保存工作区。
工程
Electron 7.0 更新
在此里程碑中,我们完成了将 Electron 7 打包到 VS Code 中的探索。这是一个主要的 Electron 版本,附带 Chromium 78.0.3904.130 和 Node.js 12.8.1。
对于 HDR 显示器
我们正在跟踪 issue #88491 中 Windows 用户使用高动态范围 (HDR) 显示器时遇到的问题,其中 VS Code 看起来黯淡且无法使用。这是所有基于 Chromium 的应用程序在 78.0.3904.130 版本上都存在的问题,并且该问题已在更新版本的 Chromium 81 中修复。一旦我们升级到 Electron 9,VS Code 将获得此修复,并且存在技术原因导致无法将修复向后移植到 Chromium 78。
与此同时,我们为此问题提供了一个临时解决方法:
- 打开命令面板(⇧⌘P (Windows,Linux Ctrl+Shift+P))。
- 运行首选项:配置运行时参数命令。
- 此命令将打开一个
argv.json
文件以配置运行时参数。可能已经存在一些默认参数。 - 将
"disable-color-correct-rendering": true
编辑为"disable-color-correct-rendering": false
。 - 重新启动 VS Code。
注意:除非您遇到问题,否则请勿编辑此设置!
我们添加此默认运行时参数,以便我们可以覆盖 Chromium 的默认颜色校正为 sRGB,而是在 macOS 上使用显示颜色空间。这样做可以避免诸如 issue #84154 之类的问题,但不适用于 HDR 显示器。
"strict": true
当我们首次发布 VS Code 时,TypeScript 仍然是一种新的且快速发展的语言,它缺少一些您今天可能认为理所当然的有用类型安全检查,例如严格的空值检查。在过去的几年中,TypeScript 团队引入了许多使 TypeScript 编译器更加“严格”的选项。这些严格选项可以捕获许多常见的编程错误并消除整类错误。严格模式的优点已得到充分证明,我们一直希望为 VS Code 代码库启用严格模式。但是,考虑到它需要修复大约构成 VS Code 核心代码库的 50 万行源代码中的数千个错误,这似乎几乎是不可能的任务。
尽管如此,严格模式的价值非常大,以至于我们决定值得为之努力,即使这需要我们一段时间才能实现。因此,在过去的两年中,我们一直在逐步更新我们的代码库,使其符合严格模式。我们直接在我们的开发分支中逐步完成了所有这些工作,以便每个与严格模式相关的修复都使我们的代码库对每个人都更安全一点。启用严格的空值检查可能是这个过程中最复杂的部分,我们在博客文章中记录了我们如何完成此操作。
在此迭代中,我们最终完成了启用最后一个严格模式选项:strictFunctionTypes
。完成此操作后,一个相当反高潮的提交为我们的整个代码库启用了严格模式!
启用严格模式是一段漫长的旅程,VS Code 核心团队中的每个人和许多社区成员都为此做出了贡献。但是,通过逐步完成这项工作,我们能够从第一天起就从所有这些辛勤工作中受益。展望未来,严格模式应鼓励最佳编码实践,使重构更安全,并最终让我们以更少错误更快地交付!
改进的 CI 构建性能
VS Code 使用 Azure Pipelines 进行持续集成构建,并且我们最近大大提高了构建性能。您可以在改进 CI 构建时间博客文章中了解更多信息。
针对浏览器运行测试
在此里程碑中,我们通过利用 Playwright 库,使我们的所有测试(单元测试、集成测试、冒烟测试)都可以在浏览器中运行,这使我们在 Chrome、Firefox 和 Safari 等浏览器上的覆盖率更高。您可以参考我们的VS Code 测试 README 了解如何运行这些测试。
值得注意的修复
- 61491: SCM:视图窗格应改进“没有存储库”消息
- 74782: 调查:macOS 公证
- 82828: autoReveal 突出显示文件名,而无需始终将其移动到资源管理器中间
- 8641: macOS:允许鼠标按钮 4 和 5 导航历史记录
- 87767: VSCode 重新启动调试不再起作用
- 88038: 不要使用自动执行的调试器命令污染 shell 历史记录
- 89230: 当编辑器处于焦点时,“组”会被读取
- 89699: 后退/前进:保留选择
- 89989: Web:允许在新窗口中打开文件
- 90075: 资源管理器:支持悬空的符号链接
- 90240: 禅模式切换关闭后,行号不可见
- 90876: 列表项应具有角色“listitem”
- 91166: 当问题面板打开时,警报过于冗长。
- 91238: 组合键在集成终端中不起作用
感谢
最后但同样重要的是,非常感谢以下人员帮助使 VS Code 变得更好:
对我们的问题跟踪的贡献
- John Murray (@gjsjohnmurray)
- Andrii Dieiev (@IllusionMH)
- Alexander (@usernamehw)
- ArturoDent (@ArturoDent)
- Gama11 (@Gama11)
对 vscode
的贡献
- @alpalla: 修复 #32264 - 允许同一任务的 N 个实例 PR #89872
- Baibhav Vatsa (@BaibhaVatsa): 从 tsconfig.base.json 中移除冗余标志 PR #91050
- Bailey Herbert (@baileyherbert)
- @bepvte: 将 “贡献” 重命名为 “功能贡献” PR #89842
- @bolinfest
- Brett Cannon (@brettcannon): 修复命令文档中的复数形式 PR #89959
- Dor Mesica (@dormesica): 修复在终端中运行活动文件时没有用引号包裹的问题 PR #90847
- Evan Krause (@evangrayk): 修复在非编辑器 Webview 中撤消/重做失效的问题 PR #89961
- Ian MacFarlane (@eyeino): 在创建新的 git 分支时澄清语言 PR #90160
- John Murray (@gjsjohnmurray)
- lipgloss (@gloss-water): 主题化:为小地图不透明度添加工作台配置选项 PR #58324
- Michael Gubik (@gubikmic): 仅滚动主要轴 (防止滚动漂移) PR #70047
- Gustavo Cassel (@GustavoASC)
- @Helloimbob: 自动将 csh 脚本检测为 shell 脚本 PR #90960
- Jean Pierre (@jeanp413)
- Jonas Littorin (@jlittorin): 为类型为 "promptString" 的输入变量添加了密码属性。 PR #90482
- John Blackbourn (@johnbillion): 将 .envrc 文件视为 Shell 脚本 PR #90825
- Josh Goldberg (@JoshuaKGoldberg): 文档错误:insertSpaces 中缺少 ` PR #90374
- @LadyCailin: 当突出显示的行是作用域开始/结束时,向右缩进一个 PR #77762
- Maik Riechert (@letmaik): 文档:修复 package.json 字段名称 "extensionDependency" PR #90103
- Gordey (@lgordey): 设置 UI:为同步设置添加分隔符 PR #91461
- Alex SK (@lxsk): 修复 #21849:小地图:显示完整文档 PR #74425
- Dan (@mallardduck): 添加对具有不同颜色的多个标尺的支持 PR #88453
- Rasmus (@neonsea): 避免调试器命令污染 shell 历史记录 PR #88041
- @nrayburn-tech
- Przemek Adamczewski (@padamczewski): 修复:多光标复制行 n 次 (#_40646) PR #52645
- Peter Shinners (@PeterShinners): 针对
task.autoDetect
描述的语法修复 PR #90117 - PM Extra (@PMExtra): 修复 JsonValidation 的一个小错误 PR #91237
- Ron Buckton (@rbuckton): 修复差一错误的错字,以改进 TS 调用层次结构中文件的显示 PR #89822
- Robert Rossmann (@robertrossmann): 像任何其他滚动条一样设置差异编辑器的可滚动视口的样式 PR #89660
- Oğuzhan Eroğlu (@rohanrhu): 添加了记住 End 键状态行为 PR #88664
- Michael Scovetta (@scovetta): 修复 #90555 (resetLocal() 没有执行任何操作) PR #90556
- Sergio Schvezov (@sergiusens): Snap 修复 PR #91182
- Matthew Spencer (@sirmspencer): 添加用于关闭侧边栏的新操作 PR #90404
- Konstantin Solomatov (@solomatov): 修复扩展伪终端中的链接处理 PR #88458
- 태재영 (@TroyTae): 支持前言结尾使用三个点 PR #90122
- Victor Gomes (@vhpgomes): smartSelect 修复 PR #90736
- Waldemar Kornewald (@wkornewald): 显示更接近顶部 (居中主体,而不是签名) PR #80727
- @zhengjiaqi: 编辑器操作运行支持参数 PR #87677
- Jiayue. Zhang (@zjysdhr): 修复 #88294 在 commit 接口中添加 commitData PR #89005
对 vscode-eslint
的贡献
- Yosuke Ota (@ota-meshi): 添加对新的 eslint 建议 API 的支持 PR #814
- Krasimir Nedelchev (@kaykayehnn): 修复错字 PR #900
对 language-server-protocol
的贡献
- Lars Hvam (@larshp) 规范 3.15,修复错字 PR #912
- Maxim Reznik (@reznikmm):
- 修复 specification-3-15.md markdown 格式 PR #913
- 在 3.15 中删除额外的 foldingRangeProvider 定义 PR #914
- 在 3.15 中删除额外的 ExecuteCommandOptions 定义 PR #915
- 在 3.15 markdown 中将 ts 替换为 typescript PR #916
- 删除重复的 TextDocumentRegistrationOptions PR #917
- 向 3.15 添加选择范围相关功能 PR #918
- 向 3.15 添加 workspaceFolders/configuration/window PR #930
- Christian Tietze (@DivineDominion) 修复错字 PR #921
- Kun Ren (@renkun-ken) 修复错字 PR #922
对 vscode-js-debug
的贡献
- SantoJambit (@SantoJambit): 仅获取代码镜头根级别的 scripts 属性 PR #351
对 vscode-languageserver-node
的贡献
- @Razzeee 修复错字 PR #574
- Remy Suen (@rcjsuen): 修复语义令牌文件名称中的错字 PR #583
对 vscode-css-languageservice
的贡献
- Jorge del Casar (@jorgecasar): 添加对解析 SCSS 中的 @apply 规则的支持 PR #194
- Denis Malinochkin (@mrmlnc): 为 SCSS/Less 混合宏添加建议参与者的功能 PR #201
- Will Bender (@Ragnoroct): 修复规则集后的 scss 自动完成 PR #188
对 vscode-vsce
的贡献
- Robert Holt (@rjmholt): 添加 --noGitHubIssueLinking 以停止在打包步骤中展开问题链接 PR #424
对 localization
的贡献
有超过 800 名 Cloud + AI 本地化 社区成员正在使用 Microsoft 本地化社区平台 (MLCP),其中大约有 170 名活跃贡献者为 Visual Studio Code 做出贡献。我们感谢您的贡献,无论是提供新的翻译、为翻译投票,还是提出流程改进建议。
以下是贡献者的快照。有关该项目(包括贡献者姓名列表)的详细信息,请访问项目网站:https://aka.ms/vscodeloc。
- 中文(简体,中国) 顾轶之, 伊婷婷, Charles Dong, Justin Liu, 斌 项, ick, paul cheung, 陈世寰, 普鲁文, 张锐, 李志强, Joel Yang.
- 中文(繁体,台湾) 潘奕均, 高民 林.
- 丹麦语(丹麦) Lasse Stilvang.
- 荷兰语(荷兰) Koen Williame.
- 英语(英国) Martin Littlecott, Henry Dearn, carlos baltazar.
- 芬兰语(芬兰) Feetu Nyrhinen.
- 法语(法国) Thierry DEMAN-BARCELÒ, Antoine Griffard, Rodolphe NOEL, Younes ZOBAIRI.
- 德语(德国) Philip Kneifeld, Raphael Höser, nick rauch.
- 印地语(印度) KRISHNA TANDON, Alish Vagadiya.
- 匈牙利语(匈牙利) Levente Borbély.
- 印尼语(印度尼西亚) Eriawan Kusumawardhono, Riwut Libinuko.
- 意大利语(意大利) Luigi Bruno.
- 日语(日本) TENMYO Masakazu, Koichi Makino.
- 韩语(韩国) 강 성원, Hongju, 관우 정.
- 拉脱维亚语(拉脱维亚) Andris Vilde, Atis Straujums.
- 波兰语(波兰) Makabeus Orban, Mariusz Wachowski.
- 葡萄牙语(巴西) Marcondes Alexandre, Arthur Lima, Marcelo Fernandes, Roberto Fonseca, Yuri Dantas, Luiz Gustavo Nunes, Thiago Takehana.
- 葡萄牙语(葡萄牙) Diogo Barros.
- 罗马尼亚语(罗马尼亚) LaServici.
- 俄语(俄罗斯) Andrey Veselov, Vadim Svitkin, Дмитрий Кирьянов.
- 西班牙语(西班牙,国际排序) Ricardo Estrada Rdez, Alvaro Enrique Ruano.
- 泰米尔语(印度) Vijay Rajasekar, Selvakumarasamy G, Pandidurai R.
- 土耳其语(土耳其) Mehmet Yönügül.
- 越南语(越南) Hiếu Nguyễn, Van-Tien Hoang, Vương.