2019 年 11 月(版本 1.41)
更新 1.41.1:此更新解决了这些 问题。
下载:Windows: x64 | Mac: Intel | Linux: deb rpm tarball snap
欢迎使用 Visual Studio Code 2019 年 11 月版本。此版本中有许多更新,我们希望您会喜欢,其中一些主要亮点包括:
- 资源管理器中的紧凑文件夹 - 默认情况下折叠单个子文件夹。
- 在差异视图中编辑左侧 - 现在您可以在差异视图中编辑两个文件。
- 在键入时更新搜索结果 - 全局搜索结果在您键入时更新。
- 问题面板改进 - 按问题类型筛选并将输出限制为活动文件。
- 迷你地图突出显示错误和内容更改 - 快速定位文件中的问题和更改。
- 终端最小对比度 - 设置首选对比度以提高可见性。
- HTML 标签中的 HTML 镜像光标 - 在匹配的 HTML 标签中自动使用多光标。
- JS/TS 中的可选链 - 使用
?.
运算符简化处理嵌套结构。 - 提取接口重构 - 快速将内联类型提取到 TypeScript 接口。
- 开发容器扩展 - 更好地支持在 Docker 容器中打开存储库。
如果您想在线阅读这些发行说明,请访问 更新,网址为 code.visualstudio.com。
内部人员:想尽快看到新功能吗?您可以下载每日 内部版本,并尽快尝试最新的更新。有关最新的 Visual Studio Code 新闻、更新和内容,请在 Twitter 上关注我们 @code!
工作台
资源管理器中的紧凑文件夹
在文件资源管理器中,我们现在以紧凑的形式呈现单个子文件夹。在这种形式中,单个子文件夹将压缩在组合的树元素中。例如,对于 Java 包结构很有用。
设置 explorer.compactFolders
控制此行为。默认情况下,此设置已开启。
在差异中编辑左侧
如果您比较两个可编辑的编辑器(例如,从文件资源管理器中比较两个文件或运行全局搜索和替换),则左侧现在也可以编辑和保存(⌘S (Windows, Linux Ctrl+S))。
注意:如果您厌倦了按 ⌘S (Windows, Linux Ctrl+S),您可以启用自动保存(文件 > 自动保存)。
从预览编辑器保存
如果您调出“预览”视图并在其中键入内容,如果焦点位于该嵌入式编辑器内,现在可以通过 ⌘S (Windows, Linux Ctrl+S) 保存更改。
问题面板
更多过滤器
问题面板中添加了更多预定义过滤器。现在,您可以按类型(错误、警告和信息)筛选问题,还可以查看范围限定为当前活动文件的问题。
主题:GitHub Sharp Dark,字体:FiraCode
在状态栏中显示当前问题
您现在可以配置 VS Code 以在状态栏中显示当前问题消息。这允许您在活动文件中查看所选问题的摘要,而无需任何额外的键盘或鼠标手势。
注意:启用此功能需要启用设置 problems.showCurrentInStatus
。
主题:GitHub Sharp Dark,字体:FiraCode
灵活的过滤器框布局
问题面板中的过滤器框现在会根据面板的位置和大小调整其位置。
主题:GitHub Sharp Dark,字体:FiraCode
改进的字体渲染(Windows,Linux)
当我们在上一个里程碑中更新到 Electron 6 时,许多用户报告说他们的字体渲染出现了倒退。具体来说,字体渲染不如以前平滑。我们立即在编辑器中解决了此问题,并且该修补程序在 1.40 恢复版本中可用。但是,工作台中的其他区域仍然存在字体渲染不太理想的问题。
在此版本中,我们改进了工作台更多部分(适用于 Windows 和 Linux)中的字体渲染。下面的屏幕截图显示了前后对比(放大以显示差异)。特别是,工作台的许多树和列表元素都使用灰度抗锯齿进行渲染,现在它们使用子像素抗锯齿进行渲染。
之前(左)和之后(右)
我们计划进一步改进工作台中更多部分的字体渲染。您可以查看此文本渲染问题查询来查看进度。
远程场景的更快读/写文件性能
对于文件系统是远程且延迟较高的情况,读取和写入文件(从文本编辑器)现在应该更快(例如,在浏览器中使用 VS Code 连接速度较慢时,或者连接到不在同一区域的远程主机时)。我们切换到基于流的读取和写入实现,这大大减少了通信开销。
搜索
在键入时更新搜索结果
在全文搜索中,结果现在将在您键入时更新。这在构建复杂的正则表达式查询等情况下特别有用,在这些情况下,对查询的快速反馈可以帮助您编写正则表达式。
在这里,即时反馈有助于构建用于采用 TypeScript 的可选链语法的正则表达式查找和替换查询
主题:Noctis Hibernus,字体:Hasklig
注意:可以通过将 search.searchOnType
设置为 false
来禁用此功能,并且可以通过 search.searchOnTypeDebouncePeriod
调整键入和搜索之间的延迟,默认值为 300 毫秒。
将光标添加到搜索结果
我们添加了一个命令,用于将光标添加到文本搜索的所有匹配项。将焦点放在“搜索”视图中的文件的搜索结果上时,您可以按 ⇧⌘L (Windows, Linux Ctrl+Shift+L) 来同时编辑该文件中所有匹配项。这与在查找小部件中搜索单个编辑器时使用的键盘快捷键相同。
默认情况下展开所有搜索结果
以前,如果全文搜索在单个文件中返回 10 个以上的结果,则它将折叠在“结果”树中。但是,这有时会使查找特定结果变得困难,因此在此版本中,所有结果都将展开。
您可以将 search.collapseResults
设置为 auto
以恢复旧行为。
编辑器
迷你地图中的错误、警告和内容更改装饰
错误和警告现在在迷你地图(代码概述)中以内联方式突出显示。您可以使用新的 minimap.errorHighlight
和 minimap.warningHighlight
主题颜色更改这些装饰的颜色。
在下面您可以看到迷你地图突出显示了一个细微的缺少逗号的错别字
内容更改装饰也会显示在迷你地图的装订线中
您可以使用以下颜色修改内容更改颜色
minimapGutter.addedBackground
minimapGutter.modifiedBackground
minimapGutter.deletedBackground
您可以使用 scm.diffDecorations
设置更改源代码管理装饰的可见性,该设置具有以下值
all
- 在所有位置显示源代码管理差异装饰。gutter
- 仅在左侧编辑器装订线中显示。minimap
- 仅在迷你地图装订线中显示。overview
- 仅在概述标尺中显示。none
- 不显示差异装饰。
代码导航备用命令
当在定义处选择转到定义时,VS Code 过去没有任何作用。在此版本中,可以改为执行备用命令。例如,可以将转到定义映射为运行转到引用。
这是通过 editor.gotoLocation.alternativeDefinitionCommand
设置进行自定义的。例如,你可以将转到定义的替代命令设置为转到声明,反之亦然。如果你喜欢旧的行为,可以将此设置留空。
速览、转到和查找所有命令
每个 速览 命令现在都有一个对应的 转到 命令。例如,现在有 速览实现 和 转到实现。速览视图不会更改当前编辑器,允许快速就地查看源代码。
下面的视频展示了如何使用 速览实现 在速览视图中查看 ICommandService
接口的所有实现。
主题:GitHub Sharp,字体:FiraCode
相比之下,转到实现 用于导航,让你快速跳转到某个实现。
下面的视频(使用 "editor.gotoLocation.multipleImplementations": "goto"
设置)通过重复按 F12 来导航到 ICommandService
接口的所有实现。
主题:GitHub Sharp,字体:FiraCode
最后但同样重要的是,与 查找所有引用 命令类似,现在有了 查找所有实现。它将实现显示为编辑器侧面的稳定列表。例如,在执行影响接口所有实现的重构时,可以将其用作 TODO 列表。
主题:GitHub Sharp,字体:FiraCode
面包屑和大纲视图的语言特定过滤
在上一个里程碑中,我们添加了从大纲视图和面包屑导航中过滤特定类型(如变量)的功能。此版本改进了此功能,并允许进行语言特定的过滤,例如不显示 TypeScript 变量,但显示 JavaScript 变量。
下面你可以看到 value
常量如何显示在 JavaScript 文件的大纲视图中,但不在 TypeScript 版本中显示。
主题:GitHub Sharp,字体:Fira Code
macOS 上的 IntelliSense 键盘快捷键
IntelliSense 通常通过 Ctrl+空格键 触发。但是,在 macOS 上,当配置了多个输入源时,此键盘快捷键会被操作系统占用。这通常会导致混乱,并让用户认为 IntelliSense 已损坏。
现在有两种方法可以解决此问题
- 使用我们为 macOS 添加的新 Alt+Escape 键盘快捷键。
- 通过 偏好设置 > 键盘 > 快捷键 > 输入源,在 macOS 偏好设置中禁用通过 Ctrl+空格键 切换输入源。
屏幕阅读器输出
有一个新的设置 editor.accessibilityPageSize
,用于控制屏幕阅读器一次可以读出的编辑器中的行数。请注意,对于大于默认值 10 的数字,这会影响性能。
如果你使用屏幕阅读器的 全部朗读 命令,我们建议将 editor.accessibilityPageSize
设置为 100 或 1000。在下一个里程碑中,我们将考虑更改此设置的默认值。
新的括号匹配选项
现在可以配置 "editor.matchBrackets": "near"
,以便在光标位于括号的任一侧时才高亮显示匹配的括号,从而获得旧的行为。默认值为 always
,它会高亮显示包围当前光标位置的匹配括号。
新的自动缩进选项
设置 editor.autoIndent
现在可以采用不同的值。此设置会影响多个功能,例如按下 Enter、按下 Tab,或在缩进和取消缩进代码行时。你可以将此设置视为一个 “滑块”,它会变得越来越主观。
"none"
:按下 Enter 将插入\n
,仅此而已。"keep"
:按下 Enter 将保留当前行的缩进。"brackets"
:以上所有内容,以及围绕特定于语言的括号的特殊逻辑。"advanced"
:以上所有内容,并尊重通过onEnterRules
定义的特定于语言的规则。"full"
(默认):以上所有内容,并尊重通过indentationRules
定义的特定于语言的规则。
代码操作菜单键盘快捷键
代码操作和重构菜单现在会显示 自定义键盘快捷键,如果存在的话。
集成终端
最小对比度
在终端中使用颜色的应用程序可能很棘手,它们可以使用以下颜色来显示文本
- 默认前景色
- 终端主题定义的 16 种颜色调色板
- 一组 240 种固定颜色
- 任何 RGB 颜色(1600 万种)
问题是应用程序不知道默认背景色或前景色是什么,以及它与应用程序使用的颜色是否具有良好的对比度。为了解决这个问题,终端现在可以动态更改文本的前景色,以满足指定的对比度。
将前景色设置为所需的对比度,范围从 1 到 21
// 4.5 is recommended for baseline website accessibility
"terminal.integrated.minimumContrastRatio": 4.5
终端颜色将增加或减少亮度,直到达到对比度或前景色变为 #000000
或 #ffffff
。
主题:Sapphire,字体:Hack
新的实验性 WebGL 渲染器
终端现在可以使用一个新的基于 WebGL 的渲染器,与旧的基于画布的方法相比,性能提高了高达 900%*。
你可以通过此设置选择使用新的渲染器
"terminal.integrated.rendererType": "experimentalWebgl"
速度的提高归因于很多因素,但以下是重点
- WebGL 允许我们更直接地与 GPU 通信,而不是通过 Web 平台的
CanvasRenderingContext2D
API。 - 渲染器几乎只处理数字和类型化数组,它们速度非常快。对象和数组的创建也保持在最低限度,以避免不必要的垃圾回收。
- 所有字符现在都缓存在纹理图集中,而不仅仅是具有有限样式集的 ASCII 字符。这意味着重复绘制相同的字符会快得多。
我们观察到,使用画布渲染器时,帧的渲染会根据用户的硬件/环境而发生巨大变化。每个帧通常需要 1 毫秒到 40 毫秒不等,但在极端情况下可能会达到 200 毫秒以上,其中硬件问题是一个因素。到目前为止,WebGL 似乎更加一致,通常在 0.2 毫秒到 2 毫秒的范围内。
可靠性是我们期望在集成后改进的一件事。对于画布渲染器,如果 GPU/画布出现问题,浏览器会尝试变得聪明并回退到在 CPU 上进行渲染,但我们永远不希望这种情况发生,因为我们有一个基于 DOM 的渲染器,它更适合这种情况。使用 WebGL,它应该按预期工作,或者严重失败(无法获取 WebGL 上下文),在这种情况下,我们可以回退到 DOM 渲染器。
由于渲染花费的时间少得多,CPU 可以腾出时间来专注于解析传入的数据,从而可以渲染更多帧并更快地运行命令。以下性能数据是通过在 vscode 存储库中运行 ls -lR
生成的
新的渲染器还修复了画布渲染器的一个严重错误,即当字符大于单元格大小时,字符的侧面会被裁剪。此问题在 Linux 上使用下划线的某些字体时最为常见。
* 有关基准测试的更多信息,请访问 xtermjs/xterm.js#1790
源代码管理
Git:git.ignoredRepositories 中的相对路径
git.ignoredRepositories
设置现在支持相对路径,当你在配置工作区设置并且想要忽略 VS Code 中的某些存储库时,这非常有用。
Git:采用 FileSystemProvider
Git 扩展现在使用 FileSystemProvider API,除了修复某些编码问题外,它还提供了一种更高效、更可靠的方式来暴露 Git 存储库中文件的旧版本。
语言
HTML 镜像光标
现在,当你在编辑 HTML 标签时,VS Code 会添加一个“镜像光标”。此行为由 html.mirrorCursorOnMatchingTag
设置控制,该设置默认启用。
此功能的工作方式是,当你的光标移动到 HTML 标签名称范围时,会将一个 多光标 添加到匹配的标签。就像在多光标模式下一样,你可以使用逐字删除或逐字选择。当你的光标移出标签名称范围时,镜像光标会被删除。
一个特殊情况是在光标位于开始标签的末尾时输入 空格,例如在类似 <div
|></div
|>
的 div
末尾。在这种情况下,VS Code 会删除结束标签名称后插入的空格并退出镜像光标模式,以便你可以继续编辑 HTML 属性。
主题:Nord,字体:Input Mono
HTML 重命名标签
你现在可以使用 F2 在 HTML 中重命名开始/结束标签对。
自动完成的 CSS 属性的排名
CSS 自动完成现在根据属性的流行度对其进行排名
使用情况数据来自 ChromeStatus.org。
Sass 模块支持
Sass 最近引入了一个 新的模块系统。
我们添加了对 SCSS 文件中 Sass 模块的语法高亮显示支持以及语言功能支持。语言功能包括
- 自动完成
@use
和@forward
。 @use
和@forward
路径的路径完成。- 自动完成 Sass 内置模块,如
sass:math
和sass:color
。 @use
和@forward
导入路径的文档链接。
JSON
为了避免大型 JSON 文件出现性能问题,JSON 语言支持现在对其计算的折叠区域和文档符号(用于大纲视图和面包屑)的数量设置了上限。默认情况下,该限制为 5000 项,但你可以使用 json.maxItemsComputed
设置更改该限制。
TypeScript 3.7
VS Code 现在搭载了 TypeScript 3.7.3。 这次重大更新带来了一些 TypeScript 语言的改进 - 包括可选链、空值合并和断言函数 - 以及一些针对 JavaScript 和 TypeScript 的新工具功能。 与往常一样,此版本还包含许多重要的错误修复。
您可以在TS 3.7 博客文章中阅读有关 TypeScript 3.7 功能的更多信息。
对 JavaScript 和 TypeScript 的可选链支持
得益于 TypeScript 3.7,VS Code 现在开箱即用地支持 JavaScript 和 TypeScript 的可选链。这包括语法高亮和 IntelliSense。
此外,当您接受可选属性的补全时,VS Code 可以自动插入 ?.
自动插入 ?.
取决于是否启用了严格的 null 检查。 可以使用 "typescript.suggest.includeAutomaticOptionalChainCompletions"
或 "javascript.suggest.includeAutomaticOptionalChainCompletions"
设置禁用自动 ?.
插入。
为 TypeScript 提取接口重构
新的 提取到接口 重构让您可以快速将内联类型提取到接口,以便它可以重复使用。
在下面您可以看到 'Neural' 接口已从 'keyes' 中提取出来
适用于 JavaScript 和 TypeScript 的分号格式化选项
新的 javascript.format.semicolons
和 typescript.format.semicolons
格式化设置让您控制格式化程序如何处理 JavaScript 和 TypeScript 文件中的分号。
有效的分号格式设置值是
ignore
- 不添加或删除分号(默认)。insert
- 在语句末尾插入分号。remove
- 删除不必要的分号。
未调用函数检查
如果忘记在条件语句中调用函数,VS Code 现在会提醒您。
请考虑以下 TypeScript 代码片段
import * as fs from 'fs';
fs.stat('/path/to/file', function(err, stats) {
if (stats.isDirectory) {
handleDirectory(stats);
}
});
上面的示例使用 Node.js fs.stat
API 来获取有关文件的信息。 但是有一个错误! .isDirectory
实际上是一个函数,而不是一个属性! 这意味着将在每个文件上调用 handleDirectory
,而不仅仅是目录,因为函数 isDirectory
已定义并求值为 true
。
请注意,只有在启用了严格的 null 检查时,您才会看到此诊断。
调试
调试启动视图
我们引入了一个新的调试启动视图,以便用户可以更轻松地在新工作区中启动和配置调试。 根据活动文件,我们将选择适当的调试扩展,并使其可以调试或运行您的应用程序。 对于更详细的调试和运行配置,最好还是配置 launch.json
文件。
在下面,您可以看到快速启动调试 Express JavaScript 应用程序,然后在需要更多控制时创建 launch.json
文件。
在调用堆栈视图中,将框架重启作为内联操作
为了提高 重启框架 操作的可发现性,现在在悬停时,在调用堆栈视图中有一个内联操作可见。 在命中断点后,重启框架是重新运行前面的源代码的便捷方法。 如果调试扩展不支持重启框架,则不会显示此操作。
调试控制台显示输入和输出
为了更好地在调试控制台中区分输入和输出,我们在左侧添加了输入 >
和输出 <
装饰。
内联断点显示
新设置 debug.showInlineBreakpointCandidates
控制在调试时是否在编辑器中显示内联断点候选装饰。 默认情况下,它们是可见的。
预览功能
预览功能尚未准备好发布,但其功能足以使用。 我们欢迎您在它们开发过程中提供早期反馈。
搜索编辑器
在此里程碑中,我们已经开始致力于在专用编辑器中显示搜索结果。 这提供了更多空间来查看搜索结果,并允许您同时维护多个搜索结果集合。
在此版本中,在搜索编辑器中,您可以
- 使用 转到定义 系列命令导航到结果,包括 预览定义 和 在侧面打开定义。
- 重新运行搜索以更新结果列表。
- 查看结果周围的源代码行。
- 将结果持久保存到磁盘,以便以后引用甚至在源代码管理中跟踪。
我们将在未来的版本中继续添加功能并提高可用性。
主题:A Touch of Lilac,字体:Hasklig
注意: 您可以通过将 search.enableSearchEditorPreview
设置为 true
来预览此功能。
调用层次结构视图
调用层次结构 API 在稳定版中可用,并且语言扩展作者正忙于实现它,因此我们添加了调用层次结构视图。 这补充了 预览调用层次结构 视图,并与 查找所有引用 和 查找所有实现 共享相同的侧边栏视图。 一旦语言扩展支持调用层次结构 API,您就可以从上下文菜单或命令面板中选择 显示调用层次结构 来查看该视图
主题:GitHub Sharp,字体:FiraCode
调用层次结构视图允许您从符号中深入研究调用者和调用。 它突出显示活动编辑器中的调用,允许从任何子项重新设置视图的父级,并且它保留先前运行的历史记录。
JavaScript 调试器
我们正在为 Node.js 和 Chrome 开发一个新的调试器。 您可以安装 nightly 扩展 js-debug-nightly
,并通过更新您的设置以添加,将其用作直接替换
{
"debug.chrome.useV3": true,
"debug.node.useV3": true
}
您无需更改现有的启动配置即可使用新的调试器。
该调试器带来了一系列新功能,例如调试和单步执行 webworker 的功能
主题:Earthsong,字体:Fira Code
...无需额外配置或标志即可调试 npm 脚本...
...等等! 如果您遇到问题,请提交问题。
扩展贡献
远程开发
在远程开发扩展上继续进行工作,该扩展使您可以使用容器,远程计算机或适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。
1.41 中的功能亮点包括
- 开发容器:更轻松地在容器中试用示例存储库(例如vscode-remote-try-python)。
- 开发容器:创建容器时提高了性能,以及
devcontainer.json
的新选项。 - WSL:支持基于 Windows 10 ARM 的 PC(例如 Surface Pro X)。
- 远程资源管理器现在可以将可用视图的范围限定为特定的远程类型。
您可以在远程开发发行说明中了解新的扩展功能和错误修复。
您还可以阅读有关使用 VS Code 检查容器的最新博客文章,并尝试更新的在 VS Code 中使用 C++ 和 WSL 教程。
ESLint
对ESLint 扩展的改进
- 更好地支持 ESLint 6.x - 在大多数情况下,使用 ESLint 6.x 时无需配置工作目录。
- 改进的 TypeScript 检测 - 一旦在 ESLint 中正确配置了 TypeScript,就不再需要通过 VS Code 的
eslint.validate
设置进行其他配置。 HTML 和 Vue.js 文件也是如此。 - Glob 工作目录支持 - 具有复杂文件夹结构并且需要通过
eslint.workingDirectories
自定义工作目录的项目现在可以使用 glob 模式,而不是列出每个项目文件夹。 例如,code-*
将匹配所有以code-
开头的项目文件夹。 此外,该扩展现在默认更改工作目录。 您可以使用新的!cwd
属性禁用此功能。 - 改进的保存时自动修复 - 保存时自动修复现在是 VS Code 的保存时代码操作基础结构的一部分,并且在一轮中计算所有可能的修复。 它通过
editor.codeActionsOnSave
设置进行自定义。 该设置支持 ESLint 特定的属性source.fixAll.eslint
。 该扩展还遵循通用属性source.fixAll
。
下面的设置打开了包括 ESLint 在内的所有提供程序的自动修复
"editor.codeActionsOnSave": {
"source.fixAll": true
}
相反,此配置仅针对 ESLint 启用它
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
}
您还可以通过以下方式选择性地禁用 ESLint
"editor.codeActionsOnSave": {
"source.fixAll": true,
"source.fixAll.eslint": false
}
vscode-scss
vscode-scss 扩展为 SCSS 变量、mixin 和函数提供跨文件语言支持。 在这个里程碑中,我们帮助其开发了新版本 0.8.0。
新版本改进了
- 更好的导入路径解析
- 自动完成颜色变量的颜色预览
- 更好的性能
扩展创作
Figma 设计工具包
我们创建了一个Figma 设计工具包,以更好地帮助扩展作者为他们的扩展设计体验。 查看 GitHub 上的工具包存储库,其中包含有关如何访问和使用工具包的说明。
下面是一些包含的组件的示例
所有组件都应该是可调整大小和可编辑的。
如果您遇到任何问题或对某些组件有任何要求,请在工具包存储库中创建一个问题,以便我们对其进行分类和跟踪。
调试图标颜色标记
我们为调试视图添加了一组新的颜色标记。
调试工具栏
debugIcon.startForeground
debugIcon.continueForeground
debugIcon.disconnectForeground
debugIcon.pauseForeground
debugIcon.restartForeground
debugIcon.stepBackForeground
debugIcon.stepIntoForeground
debugIcon.stepOutForeground
debugIcon.stepOverForeground
debugIcon.stopForeground
主题:Min Dark,字体:Input Mono
调试断点
debugIcon.breakpointForeground
debugIcon.breakpointDisabledForeground
debugIcon.breakpointUnverifiedForeground
debugIcon.breakpointStackframeForeground
debugIcon.breakpointCurrentStackframeForeground
主题:Min Dark,字体:Input Mono
工作区文件事件
当文件和文件夹更改时,会发生新的事件
vscode.workspace.on[Will|Did]CreateFile
vscode.workspace.on[Will|Did]RenameFile
vscode.workspace.on[Will|Did]DeleteFile
当从资源管理器或通过 vscode.workspace.applyEdit(WorkspaceEdit)
API 从扩展创建,重命名或删除文件时,会触发事件,但当磁盘上的文件更改或通过 vscode.workspace.fs
API 修改文件时不会触发。
这些事件的一个可能的用例是语言服务器,它可能会在重命名文件之前更新文件的内容,或在删除/创建文件后更新项目文件。
SnippetString
SnippetString
类型现在具有用于选择元素的构建器方法。
严格的 getWordRangeAtPosition
现在,TextDocument.getWordRangeAtPosition
API 的限制更加严格。它不再忽略导致空字符串匹配的无效正则表达式,而是会抛出错误。
已弃用的 extensionKind 字符串类型
扩展作者可以使用 package.json
中的 extensionKind
属性来指示扩展在远程情况下应该在哪里运行。在 (1.40) 版本中,此值可以是字符串或数组。从这个版本开始,此属性仅支持数组值,使用字符串类型已被弃用。有关更多信息,请参阅远程开发文档。
将 DAP 源转换为 URI
VS Code 扩展 API 在引用可以在编辑器中打开的资源时使用文档 URI,而 调试适配器协议 则基于 Source 描述符。在这个里程碑中,我们添加了一个连接这两个世界的 API。函数 debug.asDebugSourceUri
从 DAP Source 对象创建一个 URI。这使得将 DAP Source 打开到 VS Code 编辑器中变得很简单。
export async function openDAPSource(
session: vscode.DebugSession,
source: DebugProtocol.Source
) {
const uri = vscode.debug.asDebugSourceUri(source, session);
vscode.window.showTextDocument(vscode.workspace.openTextDocument(uri));
}
提议的扩展 API
每个里程碑都会有新的提议 API,扩展作者可以尝试使用它们。与往常一样,我们渴望收到您的反馈。以下是您试用提议 API 所需执行的操作
- 您必须使用 Insiders 版本,因为提议的 API 经常更改。
- 您必须在扩展的
package.json
文件中包含此行:"enableProposedApi": true
。 - 将最新版本的 vscode.proposed.d.ts 文件复制到项目源代码位置。
请注意,您不能发布使用提议 API 的扩展。下一个版本可能会有重大更改,我们绝不希望破坏现有扩展。
CodeAction.disabled
VS Code 鼓励扩展使用 Code Actions 实现重构功能。然而,用户可能很难发现扩展支持哪些重构,也很难理解为什么特定选择不可用给定的重构。CodeAction.disabled
API 提案旨在帮助扩展使其重构更易于发现。
CodeAction
上提议的 .disabled
属性是一个人类可读的字符串,描述了为什么给定的代码操作不可能进行。这是在我们的 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 = '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
错误消息
此外,为了帮助提高可发现性,禁用的代码操作在 **重构** 和 **源操作** 上下文菜单中会显示为淡化。
请注意,禁用的操作不会显示在顶层灯泡菜单中。
如果您的扩展使用代码操作,请告诉我们,CodeAction.disabled
是否对您有用并且能够实现。
自定义编辑器的编辑功能
在此迭代中,我们继续致力于 自定义编辑器提案。提醒一下,自定义编辑器是基于 webview 的视图,可以代替 VS Code 的普通文本编辑器用于特定文件类型。从 VS Code 1.41 开始,自定义编辑器现在可以与 VS Code 的撤消/重做和保存功能集成,这实现了许多有趣的用例,包括将它们用作可视化和所见即所得的编辑器。
您可以在 vscode.proposed.d.ts 中找到当前的 API 提案,我们还整理了一些 非常简单的扩展示例,演示了如何将自定义编辑器用于文本和二进制文件。
如果您对自定义编辑器感兴趣,请分享您对当前提案的反馈,并告知我们您是否能够实现它。
语义令牌提供程序
我们为 语义令牌提供程序添加了新的提议 API。新的 API 允许扩展提供额外的令牌信息,供编辑器用来丰富基于 TextMate 的语法高亮显示。
每个语义令牌都使用令牌 **类型** 和任意数量的令牌 **修饰符** 注释一个范围。例如,类型 variable
和修饰符 member
和 modification
将描述对成员变量的写访问。然后,令牌类型和修饰符用于在编辑器中添加样式。
可以在颜色主题和用户设置中配置样式
"editor.tokenColorCustomizationsExperimental": {
"variable.member": {
"foreground": "#35166d"
},
"*.modification": {
"fontStyle": "underline"
}
}
如果您对这个功能感兴趣,我们希望得到您关于当前提案的反馈,并且我们很乐意鼓励试验和一些早期的实现。
完整的示例可以在 vscode-extensions-samples 存储库中找到。
语言服务器协议
现在提议通过 LSP 支持 调用层次结构视图。
浏览器支持
改进了对 Firefox 和 Safari(macOS 和 iPadOS)的支持
在此里程碑期间,我们专注于改进在 Firefox 或 Safari 中使用浏览器运行 VS Code 的体验。我们修复了许多问题以支持这两种浏览器(Firefox,Safari)。在 Firefox 上,由于上游阻止程序,我们尚未完全支持键盘快捷键,您可以在跟踪问题 #85252 中阅读更多详细信息。
我们还修复了许多问题,以在 iPadOS 上的 Safari 中启用基本的 VS Code 功能。核心 UI 元素现在可用于触摸和指针设备。但是,仍然存在与预定义快捷键(Escape
和 Function
键)、悬停和触摸友好 UI/UX 相关的主要阻塞程序。有关更多信息,请参阅 问题 #85254。
更多功能可在浏览器中运行
在上一个里程碑中,我们引入了支持,可以从我们的存储库运行 yarn web
来设置在浏览器中运行的 VS Code。此设置仍然旨在用于测试浏览器中的问题,而不是用于开发。
在这个里程碑中,我们添加了更多可以测试的功能
- 调试
- 搜索
- 任务
- 问题
这是一个展示新功能的视频
注意: 请勿将此设置用于任何重要的开发。目的是让社区为 VS Code 贡献更改,以改善浏览器中的整体体验。
工程
Insiders 版本可在 yum 存储库中使用
Insiders 版本现在可在 yum 存储库中使用,并且像 apt 存储库一样自动发布。请按照网站上的说明设置存储库并使用 sudo dnf install code-insiders
进行安装。
Monaco 编辑器的持续构建
在此迭代中,我们为 Monaco 编辑器添加了持续构建和测试管道。我们从 VS Code 存储库主分支构建 Monaco 编辑器核心,并执行健全性测试,以尽早发现潜在的错误或意外的重大更改。
值得注意的修复
- 51039:在其他选项卡中关闭左侧编辑器时,差异编辑器关闭
- 83746:Web:无法拖放复合视图和视图(活动栏、面板)
- 80026:launch.json 中的灰色属性令人困惑,请删除它们
- 83449:辅助功能:辅助功能模式下的 Ctrl+Right(CursorWordAccessibilityRight)应该跳转到下一个单词的开头,而不是结尾
- 83753:禁用 console.debug.wordWrap 会删除换行符和空格
- 85086:当
search.usePCRE2
禁用时,全局搜索不支持反向引用 - 36219:Git:“暂存选定范围”命令将编码更改为 UTF-8
感谢
最后但同样重要的是,非常感谢以下人员为使 VS Code 变得更好做出的贡献!
对我们的问题跟踪的贡献
- John Murray (@gjsjohnmurray)
- Andrii Dieiev (@IllusionMH)
- Alexander (@usernamehw)
- Danny Tuppeny (@DanTup)
对 vscode
的贡献
- Amir Omidi (@aaomidi):使用 isNaN 而不是 === NaN PR #83790
- Anirudh Rayabharam (@anirudhrb):Git:修复了在空存储库中暂存时出现的错误 PR #82995
- Anthony Dresser (@anthonydresser):向 git hook 添加过滤器(开发质量)PR #85159
- Jakub Chodorowicz (@chodorowicz):改进 markdown 文件的 Monokai 主题 PR #85467
- DiamondYuan (@DiamondYuan):修复:修复拼写错误 CustomEditoInputFactory -> CustomEditorInputFactory PR #85090
- George Batalinski (@georgebatalinski):修复(aria-expanded)在子菜单上添加 aria prop PR #79775
- John Murray (@gjsjohnmurray)
- James Inkster (@Grommers00):修复 #84080 将 cntl-shift-c 和 cntl-shift-v 添加到终端 PR #84438
- Vladislav Hadzhiyski (@hadzhiyski)
- Hung-Wei Hung (@hunghw):修复 #83818 - 改进 enablePreviewFromQuickOpen 中的描述 PR #83895
- Andrew Liu (@hypercubestart):修复 #82457,markdown 打开,但未聚焦源选项卡 PR #85506
- Andrii Dieiev (@IllusionMH): 改进模板字面量的支持以匹配 TS PR #80234
- Jason Ginchereau (@jasongin): 修复自动化库中的一些小的打包问题 PR #83942
- Jean Pierre (@jeanp413)
- 黄俊量 (@JLHwung): 将
babel.config.json
添加到 JSON 验证模式映射中 PR #83758 - Joan Rieu (@joanrieu): 文档化 problemMatcher.fileLocation="autodetect" 配置选项 PR #83803
- John Combs (@jscombs91): 将 force-device-scale-factor 添加到命令行参数中 PR #84651
- Robert Jin (@jzyrobert)
- @MartinBrathen: 修复第一次单击时的缩放问题 PR #83826
- @mltony: 使辅助模式下的 Ctrl+右箭头键跳转到单词开头 PR #83450
- Nilesh Kevlani (@njkevlani): 添加用于从搜索结果添加多光标的命令和快捷键绑定 PR #82510
- okmttdhr (@okmttdhr)
- @OneQuid: 修复打开文件名中带有 '%' 的图像的问题 PR #84667
- Osk (@oskosk): 解决 installMissingDependencies 的命令标识符中的错别字问题 PR #84056
- Peter Elmers (@pelmers): 向 QuickPick 添加可选的 sortByLabel 以控制是否重新排序结果 PR #77297
- Pieter Vanderpol (@petevdp)
- Samuel Bronson (@SamB): 允许 jsconfig.json 中使用尾随逗号 PR #85479
- Shizeng Zhou (@shizengzhou): 修复 #84111 PR #84610
- @smilegodly: 将 focusSearch() 添加到 clearSearchResults() 中并删除了重复的函数 PR #83617
- Konstantin Solomatov (@solomatov)
- 空雲 (@SoraKumo001): 使本地和远程端口可配置 PR #84958
- Sebastian Pahnke (@spahnke): monaco-editor:在 SimpleEditorModelResolverService 中按资源查找模型 PR #85129
- 酷酷的哀殿 (@sunbohong): 支持 utf-8 编码猜测 PR #84504
- Tobias Fenster (@tfenster): 实现按标记类型进行过滤 PR #83797
- Valentin Hăloiu (@vially): 将父路径添加到 git clone 命令中 PR #85459
- Wojciech Buczek (@Wowol): 为 git.ignoredRepositories 添加对相对路径的支持 PR #83466
- ZHAO Jinxiang (@xiaoxiangmoe): 将 .cjs 添加到已知的 JavaScript 文件扩展名中 PR #85460
对 language-server-protocol
的贡献
-
Bradley Walters (@bmwalters): 修复文档符号列出的客户端功能接口错误的问题 PR #862
对 vscode-css-languageservice
的贡献
对 debug-adapter-protocol
的贡献
- Ben Clayton (@ben-clayton): 更新 sdks.md PR #82
对 vscode-chrome-debug-core
的贡献
- Elmi Ahmadov (@ahmadov): 修复为属性设置新值时出现的引用错误问题 PR #546
对 vscode-vsce
的贡献
- Alessandro Fragnani (@alefragnani): 通过选项忽略文件 PR #294
- James Inkster (@Grommers00): 修复 #400 允许强制取消发布扩展 PR #405
- Chris S. (@LaChRiZ): 如果包路径是目录,则使用默认文件名写入 vsix PR #248
- Nate Drake (@ndrake): 将 .vsce 的权限设置为 0600;修复 #230 PR #295
对 localization
的贡献
有超过 800 名 Cloud + AI 本地化社区成员正在使用 Microsoft 本地化社区平台 (MLCP),其中有约 100 名活跃贡献者为 Visual Studio Code 提供本地化支持。我们感谢您通过提供新的翻译、投票选择翻译或建议流程改进来做出的贡献。
这是 贡献者的快照。有关该项目的详细信息(包括贡献者姓名列表),请访问项目站点 https://aka.ms/vscodeloc。
- 波斯尼亚语(拉丁语,波斯尼亚和黑塞哥维那):Sead Mulahasanović、Ismar Bašanović、Adnan Rizvan。
- 丹麦语:Lasse Stilvang。
- 荷兰语:Lemuel Gomez、Gideon van de Laar。
- 英语(英国):Martin Littlecott、Alonso Calderon、Daniel Imms、Kamalsinh Solanki。
- 芬兰语:Tuula P.
- 法语:Antoine Griffard、Thierry DEMAN-BARCELÒ、Edouard Choinière、Joel Monniot、Rodolphe NOEL、Alain BUFERNE、Xavier Laffargue、DJ Dakta。
- 德语:Pascal Wiesendanger、Jakob von der Haar、jan-nitsche、Michael Richter。
- 希腊语:Valantis Kamayiannis、Θοδωρής Τσιρπάνης。
- 希伯来语:Ariel Bachar。
- 印地语:Kiren Paul、Niraj Kumar、Preeti Madhwal、Jaadu Jinn、Mahtab Alam。
- 匈牙利语:József Cserkó、Kiss Attila Csaba、Krisztián Papp。
- 简体中文:Yizhi Gu、Tingting Yi、Justin Liu、Charles Dong、Peng Zeng、Tony Xia、斌 项、Yixing Zheng、paul cheung、普鲁文、Sheng Jiang、钟越、Joel Yang、一斤瓜子、Zhiqiang Li、Yiting hu、Alexander ZHANG、张锐、Libing Yang、ZHENGCHENG CHEN、光宇 朴、石岩 詹、舜杰 杨、WJ Wang、Siam Chen。
- 繁体中文:Winnie Lin、船長、Alan Tsai、TingWen Su。
- 印尼语:Eriawan Kusumawardhono、Arif Fahmi、Laurensius Dede Suhardiman、Christian Elbrianno。
- 意大利语:Alessandro Alpi、Luigi Bruno。
- 日语:Takayuki Fuwa、貴康 内田、Kyohei Uchida、Koichi Makino、TENMYO Masakazu、Aya Tokura。
- 韩语:Hongju。
- 拉脱维亚语:Andris Vilde。
- 挪威语:Frode Aarebrot、Anders Stensaas、Thomas Ødegård、Thomas Isaksen。
- 波兰语:Makabeus Orban、Wojciech Maj、Kacper Łakomski、Oskar Janczak、Szymon Seliga、Mateusz Redynk、Franx Bar。
- 葡萄牙语(巴西): Marcelo Fernandes, Albert Tanure, Arthur Lima, Nylsinho Santos, Pudda, Matheus Vitti Santos, Rodrigo Crespi, Roberto Fonseca, Felipe Nascimento。
- 葡萄牙语(葡萄牙): Francisco Osorio, Luís Chaves, Ricardo Sousa Vieira, João Fernandes。
- 罗马尼亚语: LaServici, Dan Ichim。
- 俄语: Vadim Svitkin。
- 塞尔维亚语(西里尔字母): Dusan Milojkovic。
- 西班牙语: José María Aguilar, Gustavo Gabriel Gonzalez。
- 泰米尔语: MUTHU VIJAY, Sankar Raj, Kadhireshan S, Pandidurai R, Madhu Chakravarthy, Madhu Maha。
- 土耳其语: Mehmet Yönügül, mehmetcan Gün, Misir Jafarov, Fırat Eşki, Gökberk Nur, Safa Selim。
- 乌克兰语: Arthur Murauskas, Oleksandr Krasnokutskyi。
- 越南语: Dat Nguyen, Vương, Dao Ngo, Van-Tien Hoang, ng-hai。