2019 年 11 月(版本 1.41)
更新 1.41.1:此更新解决了这些问题。
下载:Windows:x64 | Mac:Intel | Linux:deb rpm tarball snap
欢迎使用 Visual Studio Code 2019 年 11 月版。此版本中有许多更新,我们希望您会喜欢,其中一些主要亮点包括
- 资源管理器中的紧凑文件夹 - 默认情况下折叠单个子文件夹。
- 编辑差异视图的左侧 - 现在您可以编辑差异视图中的两个文件。
- 在您键入时更新搜索结果 - 全局搜索结果在您键入时更新。
- 问题面板改进 - 按问题类型筛选并将输出限制为活动文件。
- 迷你地图突出显示错误和内容更改 - 快速定位文件中的问题和更改。
- 终端最小对比度 - 设置首选对比度以提高可见性。
- HTML 镜像光标在标签中 - 匹配的 HTML 标签中的自动多光标。
- JS/TS 中的可选链 - 使用
?.
运算符简化嵌套结构的处理。 - 为 TypeScript 提取接口重构 - 快速将内联类型提取到 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+Space 触发。但是,在 macOS 上,当配置多个输入源时,此键盘快捷键由操作系统占用。这通常会导致混淆,并使用户认为 IntelliSense 已损坏。
现在有两种方法可以处理此问题
- 使用我们为 macOS 添加的新 Alt+Escape 键盘快捷键。
- 通过 首选项 > 键盘 > 快捷键 > 输入源 在您的 macOS 首选项中禁用通过 Ctrl+Space 进行的输入源切换。
屏幕阅读器输出
有一个新设置 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 镜像光标
VS Code 现在在您编辑 HTML 标签时添加“镜像光标”。此行为由设置 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 检查 时,您才会看到此诊断。
调试
调试 START 视图
我们引入了一个新的调试 START 视图,以使用户更容易在新工作区中启动和配置调试。根据活动文件,我们将选择适当的调试扩展,并使调试或运行您的应用程序成为可能。对于更详细的调试和运行配置,最好仍然配置 launch.json
文件。
在下面,您可以看到快速启动调试 Express JavaScript 应用程序,然后在需要更多控制时创建 launch.json
文件。
在调用堆栈视图中将“重启帧”作为内联操作
为了提高 重启帧 操作的可发现性,现在在鼠标悬停在调用堆栈视图上时,会显示一个内联操作。在命中断点后,重启帧是重新运行前面的源代码的一种方便方法。如果调试扩展不支持重启帧,则不会显示此操作。
调试控制台显示输入和输出
为了更好地区分调试控制台中的输入和输出,我们在左侧添加了输入 >
和输出 <
装饰。
内联断点显示
新的设置 debug.showInlineBreakpointCandidates
控制在调试时是否在编辑器中显示内联断点候选装饰。默认情况下,它们是可见的。
预览功能
预览功能尚未准备好发布,但功能已足够使用。我们欢迎您在开发过程中提供早期反馈。
搜索编辑器
在此里程碑中,我们已开始致力于在专用编辑器中显示搜索结果。这提供了更多空间来查看搜索结果,并允许您同时维护多个搜索结果集合。
在此版本中,在搜索编辑器中,您可以
- 使用 转到定义 系列命令导航到结果,包括 速览定义 和 在侧边打开定义。
- 重新运行搜索以更新结果列表。
- 查看结果周围的源代码行。
- 将结果持久保存到磁盘,以便稍后引用甚至在源代码管理中跟踪。
我们将在未来的版本中继续添加功能并提高可用性。
主题:A Touch of Lilac,字体:Hasklig
注意: 您可以通过将 search.enableSearchEditorPreview
设置为 true
来预览此功能。
调用层次结构视图
调用层次结构 API 在 Stable 中可用,语言扩展作者正忙于实现它,因此我们添加了“调用层次结构”视图。这补充了 速览调用层次结构 视图,并与 查找所有引用 和 查找所有实现 共享相同的侧边栏视图。一旦语言扩展支持调用层次结构 API,您将能够从上下文菜单或命令面板中选择 显示调用层次结构 以查看该视图
主题:GitHub Sharp,字体:FiraCode
“调用层次结构”视图允许您深入了解符号的调用者和调用。它突出显示活动编辑器中的调用,允许从任何子项重新父级化视图,并且它保留以前运行的历史记录。
JavaScript 调试器
我们正在开发用于 Node.js 和 Chrome 的新调试器。您可以安装每晚构建的扩展 js-debug-nightly
,并通过更新设置以添加以下内容将其用作直接替换
{
"debug.chrome.useV3": true,
"debug.node.useV3": true
}
您应该不需要更改现有的启动配置即可使用新的调试器。
调试器带来了一系列新功能,例如调试和单步执行 Web Worker 的能力
主题:Earthsong,字体:Fira Code
...无需额外的配置或标志即可调试 npm 脚本...
...以及更多!如果您遇到问题,请提交问题。
扩展贡献
远程开发
继续开发 远程开发扩展,它允许您使用容器、远程计算机或 Windows Linux 子系统 (WSL) 作为功能齐全的开发环境。
1.41 中的功能亮点包括
- 开发容器:更轻松地在容器中试用示例存储库(例如 vscode-remote-try-python)。
- 开发容器:创建容器时性能得到改进,以及
devcontainer.json
的新选项。 - WSL:在基于 Windows 10 ARM 的电脑(如 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
属性是一个人类可读的字符串,描述了为什么给定的 Code Action 不可能。以下是在我们的 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;
}
...
}
如果用户尝试通过键盘快捷键应用禁用的 Code Action,VS Code 将向用户显示 .disabled
错误消息。
此外,为了帮助发现,禁用的 Code Action 在 重构 和 源操作 上下文菜单中显示为灰色。
请注意,禁用的操作不会显示在顶层灯泡菜单中。
如果您的扩展使用 Code Actions,请告知我们 CodeAction.disabled
是否对您有用并且能够实现。
自定义编辑器编辑功能
在本迭代中,我们继续致力于 自定义编辑器提案。提醒一下,自定义编辑器是基于 webview 的视图,可以代替 VS Code 的普通文本编辑器用于特定文件类型。从 VS Code 1.41 开始,自定义编辑器现在可以与 VS Code 的撤消/重做和保存功能集成,这实现了许多有趣的用例,包括将它们用作可视化和 WYSIWYG 编辑器。
您可以在 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 Editor 的持续构建
在本迭代中,我们为 Monaco Editor 添加了持续构建和测试管道。我们从 VS Code 仓库主分支构建 Monaco Editor 核心,并执行健全性测试,以尽早发现潜在的错误或意外的重大更改。
值得注意的修复
- 51039:在其他选项卡中关闭左侧编辑器时,Diff 编辑器关闭
- 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 添加过滤器 (dev qol) PR #85159
- Jakub Chodorowicz (@chodorowicz): 改进 markdown 文件的 Monokai 主题 PR #85467
- DiamondYuan (@DiamondYuan): fix: 修复拼写错误 CustomEditoInputFactory -> CustomEditorInputFactory PR #85090
- George Batalinski (@georgebatalinski): fix(aria-expanded) 在子菜单上添加 aria 属性 PR #79775
- John Murray (@gjsjohnmurray)
- James Inkster (@Grommers00): fix #84080 在终端中添加 cntl-shift-c 和 cntl-shift-v PR #84438
- Vladislav Hadzhiyski (@hadzhiyski)
- Hung-Wei Hung (@hunghw): Fix #83818 - 优化 enablePreviewFromQuickOpen 中的描述 PR #83895
- Andrew Liu (@hypercubestart): fix #82457, markdown 打开,但未聚焦源选项卡 PR #85506
- Andrii Dieiev (@IllusionMH): 改进模板字面量支持以匹配 TS PR #80234
- Jason Ginchereau (@jasongin): 修复自动化库中的一些小打包问题 PR #83942
- Jean Pierre (@jeanp413)
- Huáng Jùnliàng (@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+right 跳转到单词开头 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): Fix #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): 修复了文档符号列出的客户端 capabilities 接口错误的问题 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。