2020 年 11 月(1.52 版本)
更新 1.52.1:此更新解决了以下问题。
下载:Windows:x64 Arm64 | Mac:Intel | Linux:deb rpm tarball Arm snap
欢迎来到 Visual Studio Code 2020 年 11 月版本。正如11 月迭代计划中所宣布的那样,我们继续专注于两周的时间来整理 GitHub 问题和拉取请求,如我们的问题整理指南中所记录的那样。在我们所有的 VS Code 存储库中,我们关闭(已分类或修复)了 5242 个问题,甚至超过了我们在 2019 年 10 月上次整理迭代期间关闭的 4622 个问题。在我们关闭问题的同时,您创建了 2937 个新问题。主要的 vscode 存储库现在有 2146 个开放的功能请求和 884 个开放的错误。此外,我们还关闭了 144 个拉取请求。
和每年一样,我们使用了来自 Benjamin Lannon 的 实时跟踪器来跟踪我们的进度
在专注于整理工作后,我们还解决了几个功能请求和社区拉取请求。这带来了许多新功能和设置,其中一些关键亮点包括
- 差异编辑器中的换行 - 内联和并排视图现在都支持换行。
- 新的扩展二分功能 - 排除 VS Code 中导致问题的扩展。
- 键盘快捷方式编辑器改进 - 从命令面板创建键绑定。
- 在资源管理器中撤消文件操作 - 在资源管理器中撤消或重做文件操作。
- 新的 Git 命令和设置 - 通过新功能优化您的版本控制体验。
- 预览编辑器改进 - 完全关闭预览编辑器,并尝试新的交互模式。
- 使用空格缩进时的粘性制表位 - 改进了使用空格缩进时的体验。
- 改进的基于单词的建议 - 显示来自其他打开文件的基于单词的建议。
- 终端配置支持 - 从终端下拉菜单修改终端设置。
- 新的远程开发资源 - 查看新的视频和学习模块。
工作台
预览编辑器改进
我们根据用户反馈对我们如何处理预览编辑器进行了一些更新。
现在默认禁用 workbench.editor.enablePreviewFromQuickOpen
设置,因此从快速打开打开的编辑器将不再以预览模式显示。
当您启动代码导航(例如,使用转到定义)时,您启动的编辑器将移出预览模式并保持打开状态,而新的编辑器将处于预览模式,直到您进一步导航。
我们更改了我们所有的自定义树(例如,扩展或 Git 视图中使用的树)以更一致地像其他内置树(例如,文件资源管理器)一样工作。这意味着,以下交互现在适用于所有这些
- 双击或鼠标中键单击以在非预览模式下打开。
- Enter 以在非预览模式下打开(空格键 以在预览模式下打开)。
Alt+单击
以在活动编辑器旁边打开一个编辑器。
注意:如果您是使用我们的自定义树 API 的扩展作者,您也可以从这种更改中受益。请确保为 TreeItem.command
使用 vscode.open
或 vscode.diff
命令以获得新的预览模式行为。
编辑器溢出菜单中的新菜单项 保持编辑器打开 允许您快速完全关闭预览编辑器
恢复之前的会话窗口
现有 window.restoreWindows
设置的新值 preserve
可让您强制在您重新启动 VS Code 时恢复您在关闭 VS Code 之前打开的每个窗口,即使明确要求 VS Code 打开特定文件夹或文件也是如此。一个常见的示例是在您平台的文件资源管理器中双击文件以在 VS Code 中打开它,或使用终端打开特定文件或文件夹。如果没有 window.restoreWindows: preserve
设置,VS Code 将仅按指示打开文件或文件夹,而不会恢复任何其他窗口。
禁用拖放时拆分编辑器组
新的设置 workbench.editor.splitOnDragAndDrop
可防止在使用拖放编辑器时拆分编辑器组。还有一种方法可以通过按住 Shift 键 (macOS) 或 Alt 键(Windows、Linux)在拖放操作期间有条件地切换此项。
在资源管理器中撤消文件操作
文件资源管理器现在支持所有文件操作的撤消和重做:删除、重命名、复制、移动、新建文件和新建文件夹。确保焦点在文件资源管理器中,并触发撤消或重做命令,您的上一次文件操作将分别被撤消或重做。请记住,我们为编辑器和文件资源管理器设置了单独的撤消堆栈,我们根据焦点选择要撤消的堆栈。
资源管理器中长时间运行的操作的进度
我们现在在文件资源管理器和状态栏中显示长时间运行的文件操作(超过 500 毫秒)的进度。还初步支持取消长时间运行的操作。这在复制大型文件夹或从远程位置下载资源时应该会有所帮助。
打开编辑器排序
有一个新的设置 explorer.openEditors.sortOrder
来控制打开的编辑器列表中的排序顺序。
这些值是
editorOrder
- 编辑器按照编辑器选项卡显示的相同顺序列出(默认)。alphabetical
- 编辑器按照字母顺序在每个编辑器组中列出。
alphabetical
排序仅对“打开的编辑器”视图有效 - 它不会以任何方式“移动选项卡”。
当您打开了很多文件并且想要匹配关联的文件时(例如,hello.component.js 和 hello.component.html),这会很有帮助。
可访问的进度控制
工作台进度显示已变得更易于访问。VS Code 设置适当的 ARIA 角色,以便屏幕阅读器可以报告 VS Code 中所有长时间运行的操作的进度。大多数屏幕阅读器默认情况下仅在进度持续超过 10 秒时才宣布进度。
源代码控制更改显示其父文件夹路径
从源代码控制视图打开的差异编辑器现在将显示其文件路径(禁用选项卡时)。以前,仅显示文件名,但如果之前和之后的 文件位于同一文件夹中,则现在会显示父文件夹。
默认启用新的代理登录对话框
我们新的代理登录对话框现在默认启用。您可以阅读我们之前的发行说明以了解更多详细信息。设置 window.enableExperimentalProxyLoginDialog
可用于启用旧的对话框,但我们将在不久的将来删除此支持。如果您发现新的登录对话框有问题,请通过提交 问题 来告知我们。
改进的终端环境处理(Linux、macOS)
当您第一次通过 Dock 或启动器(而不是终端)在 Linux 或 macOS 上启动 VS Code 时,VS Code 会启动一个后台进程来解析您的 Shell 环境(由 .bashrc
或 .zshrc
定义或更改)。所有检测到的环境变量都将由 VS Code 使用,因此从终端或 Dock/启动器启动不会有任何区别,这在调试或执行任务时很重要。
遗憾的是,VS Code 要到此后台进程执行后才会打开。为了避免阻止启动时间过长,VS Code 将在 10 秒后开始打开。在这种情况下,VS Code 现在会通知您它无法解析 Shell 环境,并提供一个链接以了解更多信息
同样,VS Code 现在会在三秒钟后显示警告,以指示 VS Code 启动被阻止解析您的 Shell 环境
我们正在积极研究更改我们的策略,以避免在后台解析 Shell 环境时阻止 VS Code 启动,但这只能在未来的里程碑中实现。
此区域中其他值得注意的更改是
- 您现在可以在启动 VS Code 的第二个窗口之前从终端定义和更改环境变量,并且这些变量将正确覆盖第一次启动中的变量,从而有效地允许每个窗口的环境变量(例如,这使您可以使用诸如
nvm
之类的工具在启动之前按窗口更改 Node.js 版本)。 - 从终端设置并在启动 VS Code 的第二个窗口之前设置的环境变量现在即使您在该第二个窗口中切换文件夹也会保留。
改进的工作台溢出
每当没有足够的空间容纳工作台内的所有视图时,VS Code 现在将显示滚动条来平移内容,并让您访问所有内容。这适用于整个工作台的多个区域,例如侧边栏、编辑器网格等。
Sash 悬停边框颜色
您现在可以自定义整个工作台上用于 SASH 的边框悬停颜色 (sash.hoverBorder
)。
树:展开模式
新增的 workbench.tree.expandMode
设置允许您控制在树状图中如何展开文件夹:使用单击或双击。
macOS Big Sur 更新
由于 Electron 9 的一个问题,每当您选择“重启以更新”时,VS Code 不会自动重启,而只是退出。在下一个包含 Electron 11 的 VS Code 版本发布之前,发生这种情况时您必须手动重新启动 VS Code。请在issue #109728 中了解更多信息。
源代码控制
保留源代码管理视图状态
源代码管理视图状态现在会在会话之间保留。折叠的树节点即使在退出并重新启动 VS Code 后也会保持折叠状态。
源代码管理装订线操作
新的 scm.diffDecorationsGutterAction
设置允许您控制选择编辑器左侧源代码管理装订线装饰时会发生什么。可能的值有:
diff
- 单击时打开内联差异预览视图(默认)。none
- 禁用任何操作。
Git:新命令
命令面板中添加了几个新的 Git 命令:
- Git: Cherry Pick... - 将特定提交选取到您的分支。
- Git: Rename - 对活动文件执行 git 重命名。
- Git: Push Tags - 将所有本地标签推送到远程。
- Git: Checkout to (Detached)... - 以分离模式执行检出。
Git:新设置
此外,还添加了新的 Git 设置:
git.pruneOnFetch
- 使 VS Code 在获取远程引用时运行git fetch --prune
。git.ignoreSubmodules
- 您现在可以确保 VS Code 忽略子模块存储库中的更改,这在大型单体存储库中非常有用。git.openAfterClone
- 控制在克隆 git 存储库后是否以及如何打开文件夹:在当前窗口、在新窗口、在没有打开文件夹时以及通过提示用户。git.useCommitInputAsStashMessage
- 启用 VS Code 在运行 Git: Stash 时将源代码管理输入框中的提交消息用作存储消息。git.followTagsWhenSync
- 在运行 Git: Sync 时跟踪标签。git.checkoutType
- 控制在运行 Git: Checkout... 命令时显示哪些引用以及以何种顺序显示。
Git:在存储之前提示保存文件
现在,每当您尝试存储更改时,VS Code 都会提示您保存未保存的文件。
Git:改进的已删除文件合并冲突差异
已删除文件合并冲突现在具有改进的差异体验,显示文件在与删除相反的分支上的实际更改。
Git:远程添加时获取
现在,在您添加远程后,VS Code 将立即运行 git fetch
,从该远程获取所有引用。
Git:检出分离
现在可以从 VS Code 以分离模式检出引用
Git:在错误时显示命令输出
当 git 命令抛出错误时,您现在可以使用新的“显示命令输出”选项查看完整的错误消息。
Git:git.api.getRemoteSources 命令的新选项
git.api.getRemoteSources
Git API 命令选项现在支持一个可选的 branch?: boolean
属性,如果远程源提供程序支持,这将使 Git 提示用户从远程源中选择一个分支。
此外,该命令现在支持 providerName?: string
选项,该选项允许调用者绕过用户选择远程源,并直接使用特定的提供程序。
调试
断点视图:异常断点的条件
VS Code 现在支持使用“编辑条件”上下文菜单操作从断点视图编辑异常断点的条件。
目前,只有 Mock Debug 扩展具有(虚假的)异常断点条件支持,但很快其他调试扩展程序也将跟进,例如 JavaScript 调试器。
异常区域辅助功能
编辑器中的异常信息区域已变得更易于访问。调试时,一旦命中异常,VS Code 会自动将焦点移动到异常区域,这将使屏幕阅读器报告异常详细信息和堆栈帧。
现在也可以使用 Escape 键或异常区域右上角的 X 按钮关闭异常区域。
UI 改进
在概览标尺中显示调试的行
当前调试的行现在显示在编辑器右侧的概览标尺中。对于此装饰,我们使用已存在的 editor.stackFrameHighlightBackground
颜色。除此之外,VS Code 在概览标尺中使用 editor.focusedStackFrameHighlightBackground
颜色显示当前聚焦的调试行(聚焦的调试行是非顶层堆栈帧位置,在 调用堆栈视图 中手动选择)。
自动调试配置改进
以前,我们引入了一项功能,使调试扩展程序可以分析当前项目并自动提供调试配置。这些调试配置是动态创建的,因此它们不会显示在 launch.json
配置文件中。在此里程碑中,我们还在 VS Code 重启(和重新加载)时保留最近使用的自动调试配置,以使整个体验更加流畅。如果自动调试配置在重启后不再有效,VS Code 将在开始调试后要求您从同一提供程序中选择新的自动配置。
调试悬停:底部显示帮助文本/提示以切换到正常悬停
现在,调试悬停的底部有帮助文本,以使调试时按 Alt 切换到编辑器语言悬停更易于发现。提醒一下,当您进行调试时,调试悬停优先于语言悬停,因此无法看到语言悬停。您可以通过按住 Alt 修饰键从调试悬停切换回语言悬停。只要按下 Alt,就会显示语言悬停而不是调试悬停。这使得在调试时更容易阅读诸如 Javadoc 描述之类的悬停。
调试控制台:折叠相同的行
调试控制台现在折叠相同的输出并显示出现的次数。此功能使得更容易掌握重复的程序输出。
launch.json 和 tasks.json 的新变量
引入了以下新变量:
${fileWorkspaceFolder}
- 解析为在活动 VS Code 编辑器中打开的文件的 workspace 文件夹路径。${fileDirnameBasename}
- 解析为在活动 VS Code 编辑器中打开的文件的所在文件夹的名称。${pathSeparator}
- 解析为操作系统用于分隔文件路径中组件的字符。
serverReadyAction:按名称启动其他调试配置
serverReadyAction 历来可以通过匹配 URL 来启动浏览器或 Chrome 调试。此版本添加了一个新选项,可以通过名称启动另一个任意配置。例如,在您的 launch.json
中,您可以指定:
"serverReadyAction": {
"action": "startDebugging",
"pattern": "listening on port ([0-9]+)",
"name": "Launch Browser"
}
这允许您在标准 Chrome 调试配置中传递其他选项,并将其他调试器与 serverReadyAction
一起使用。
暂时禁用自动附加
现在可以通过状态栏中的“自动附加”项或通过“调试:切换自动附加”命令暂时禁用自动附加。以这种方式禁用自动附加仅适用于当前窗口,并且不需要重新启动您的终端。可以通过相同的方式重新启用它。
JavaScript 调试器
可以在调试器的 changelog 中找到完整的更改列表。
断点诊断工具
有一个新工具旨在帮助排除阻止调试或阻止断点绑定的构建或配置问题。要使用它,请在调试会话运行时运行“调试:为当前会话创建诊断信息”命令。在以后的 VS Code 版本中,当合适时,会自动显示此诊断工具的提示。
设置默认可执行文件位置
有一个用户设置 debug.javascript.defaultRuntimeExecutable
,允许您指定 Node.js 或 Chrome 二进制文件的默认位置。例如,{ "pwa-chrome": "dev" }
将在您使用 Chrome 类型配置进行调试时使用 Chrome 的 “dev” 版本。
请注意,要使用此新选项,您需要确保您的启动配置是 pwa-node
而不是 node
,或者 pwa-chrome
而不是 Chrome。
任务
npm
内置 npm 扩展的设置 npm.packageManager
有一个新的默认值:auto
。auto
值将导致根据 .lock
文件以及用于安装工作区中依赖项的包管理器自动检测包管理器。当检测到多个 .lock
文件时,仍然会选择一个包管理器,并且会发出警告,指示存在冲突。
删除最近的任务
任务快速选择器顶部始终有一个“最近的任务”部分。由于这是一个有价值的位置,您现在可以通过右侧的“删除最近使用的任务”按钮将其从快速选择器中删除,从而更好地管理您最近的任务。
扩展
在此里程碑中,我们对扩展视图和扩展详细信息页面添加了一些改进。
扩展视图现在会自动刷新。例如,安装扩展后,扩展会立即显示在“扩展:已安装”列表中。您还可以使用标题栏中的刷新按钮手动刷新视图。
主题:GitHub Light
扩展的详细信息页面现在会显示一个上下文菜单,其中包含扩展的所有操作,就像在扩展视图中一样。
主题:GitHub Light
扩展的详细信息页面中的功能贡献选项卡现在显示扩展的激活事件。
主题:GitHub Light
现在可以同时禁用扩展及其依赖项。当您尝试禁用具有依赖项的扩展时,会有一个带有全部禁用操作的通知。
主题:GitHub Light
您可以使用扩展视图中扩展的上下文菜单中提供的添加到工作区建议或从工作区建议中移除操作,从工作区建议中添加或删除扩展。
主题:GitHub Light
启用设置同步后,扩展推荐通知现在会显示安装下拉操作,就像在扩展视图中一样。
我们通过弃用 extensions.showRecommendationsOnlyOnDemand
设置简化了扩展建议的配置。您现在可以使用 extensions.ignoreRecommendations
设置来控制扩展推荐通知,并使用扩展视图的可见性操作来默认隐藏推荐。
问题排查:扩展二分法
VS Code 的真正强大之处在于其扩展:主题扩展添加漂亮的颜色和图标,语言扩展提供 IntelliSense 并启用代码导航,调试器扩展使您能够深入研究错误。有时,问题是否由扩展引起并不明显,如果是,是由哪个扩展引起的也不明显。在此之前,您需要禁用所有扩展,然后逐个重新启用扩展以找到有问题的扩展。现在,使用称为扩展二分法的新功能,此过程变得简单起来。它使用二分搜索算法来快速识别导致问题的扩展。本质上,它会禁用您一半的扩展,并要求您检查您看到的问题。如果问题消失了,则坏的扩展必须在禁用的扩展列表中,而不是在当前启用的扩展列表中。此过程会重复执行,直到只剩下一个扩展为止。
您可以通过命令面板中的帮助:启动扩展二分法命令(⇧⌘P(Windows,Linux Ctrl+Shift+P))启动扩展二分法。然后,它会引导您完成重复禁用和重新启用扩展的过程。每次重新加载后,系统都会提示您确认问题是否仍然存在。
扩展二分法会反复询问您是否正在重现问题。您始终可以通过停止二分法中止,如果您关闭二分法通知,可以通过帮助:继续扩展二分法命令继续。
扩展二分法过程完成后,系统会要求您针对该扩展提交问题。您也可以从此处禁用该扩展。
键盘快捷方式编辑器
在此里程碑中,我们对键盘快捷方式编辑器进行了一些改进。
您现在可以通过右侧的配置按键绑定齿轮按钮,从命令面板为命令配置按键绑定。
主题:GitHub Light
您可以从键盘快捷方式编辑器向命令添加多个按键绑定。
主题:GitHub Light
您现在还可以从搜索输入中按特定的键盘快捷方式编辑器列进行筛选。
@command:commandId
- 按命令 ID 筛选。例如,@command:workbench.action.showCommands
。@keybinding:keybinding
- 按按键绑定筛选。例如,@keybinding:f1
。@source:user|default|extension
- 按来源筛选。
您可以使用向上和向下箭头在键盘快捷方式编辑器中浏览搜索历史记录。
IntelliSense
来自其他文档的基于单词的建议
VS Code 支持简单的基于单词的建议。当语言服务不可用或语言服务无法计算结果时(例如在注释中键入时),它们很有用。在此版本中,现在可以配置 VS Code 以建议来自其他打开文件的单词。使用 editor.wordBasedSuggestionsMode
设置,使用 allDocuments
建议来自所有打开文件的单词,使用 matchingDocuments
建议来自相同语言的打开文件的单词(默认),并使用 currentDocument
仅建议来自当前文件的单词。
隐藏内联详细信息
VS Code 中的建议具有在建议旁边的单独浮出控件中显示的详细信息。详细信息视图可以关闭,然后详细信息的预览将与建议内联显示。内联显示建议的详细信息可能会占用太多空间,因此现在可以通过新的布尔设置 editor.suggest.showInlineDetails
禁用此功能。
TypeScript 建议显示路径
TypeScript 可以提供还会添加导入语句的补全。但是,当有多个同名符号时,很难选择正确的补全。此版本简化了此过程,因为自动导入补全的路径会与标签一起显示。
自定义 CodeLens
您现在可以配置 CodeLens 项目的字体系列和大小。
在上面的屏幕截图中,字体和大小是使用以下两个设置自定义的
"editor.codeLensFontFamily": "Comic Sans MS",
"editor.codeLensFontSize": 12,
编辑器
使用空格缩进时保持粘性制表位
如果您喜欢用空格缩进代码,则有一个名为 editor.stickyTabStops
的新设置,它使 VS Code 将前导空格中的光标移动视为制表符。
删除单词命令
现有的删除单词操作将从当前光标位置删除到单词的开头(例如 Windows/Linux 上的 Ctrl+Backspace)或删除到单词的结尾(Windows/Linux 上的 Ctrl+Delete)。现在有一个名为删除单词的新命令,它将删除光标下的整个单词。
差异编辑器中的换行
差异编辑器的并排视图和内联视图现在都支持换行。通常,差异编辑器将遵守与换行相关的编辑器设置。在默认情况下换行的 Markdown 文件的情况下,差异编辑器也将换行它们。
如果您希望差异编辑器永远不换行或始终换行,可以使用新的 diffEditor.wordWrap
设置将其配置为 "on"
或 "off"
(默认值为 "inherit"
,这意味着差异编辑器继承编辑器换行设置)。
代码片段
隐藏扩展代码片段
扩展提供的代码片段现在可以从 IntelliSense 中隐藏。此功能可从运行插入代码片段时使用的“插入代码片段”选取器中使用。找到要隐藏的扩展代码片段,然后选择右侧的眼睛图标。
隐藏的代码片段不会在 IntelliSense 中显示,但仍然可以通过插入代码片段使用。最后,当使用设置同步时,隐藏的代码片段首选项将在您的设备之间同步。
没有前缀的代码片段
创作代码片段时,您现在可以省略前缀属性。没有前缀的代码片段不会在 IntelliSense 中显示,但可以通过插入代码片段使用。
集成终端
终端配置支持
您现在可以通过在终端下拉菜单中选择配置终端设置来修改终端设置。
按键绑定管理
默认情况下,按键绑定会按照 terminal.integrated.commandsToSkipShell
设置中的指定分派到工作台,而不是终端。当用户输入与这些命令之一对应的按键绑定时,会通知用户,并提供配置相关设置的选项。
要将大多数按键绑定发送到终端而不是工作台,可以设置 terminal.integrated.sendKeybindingsToShell
。
语言
Markdown 内联智能选择
使用以下命令在 Markdown 文档中展开和收缩选择
- 展开:⌃⇧⌘→(Windows,Linux Shift+Alt+Right)
- 收缩:⌃⇧⌘←(Windows,Linux Shift+Alt+Left)
选择适用于斜体、粗体、内联代码块和链接。
TypeScript 4.1
此版本的 VS Code 包括 TypeScript 4.1.2。此主要的 TypeScript 更新为许多新的语言功能带来了支持,包括 模板字面量类型和对 [React 17 的工厂的支持,以改进 JavaScript 和 TypeScript 的语言工具。与往常一样,它还包括许多错误修复。
您可以在 TypeScript 博客上阅读有关 TypeScript 4.1 的更多信息。
对 JSDoc @see 标签的初始支持
JSDoc @see
标签允许您在 JSDoc 注释中引用其他函数和类。下面的示例显示了 crash
函数引用来自另一个文件的 WrappedError
类
// @filename: somewhere.ts
export class WrappedError extends Error { ... }
// @filename: ace.ts
import { WrappedError } from './somewhere'
/**
* @see {WrappedError}
*/
function crash(kind) {
throw new WrappedError(kind);
}
VS Code 现在将在执行重命名时包含基本的 @see
引用。您也可以在 @see
标签的内容上运行转到定义,并且 @see
标签也会显示在引用列表中。
我们计划在未来的版本中继续改进对 @see
标签的支持。
用于 IntelliSense 行为和类型检查的新设置
有两个新设置可以控制 JavaScript 和 TypeScript 文件中 IntelliSense 和类型检查的行为,这些文件不是显式 tsconfig 或 jsconfig 项目的一部分。
-
js/ts.implicitProjectConfig.strictNullChecks
设置启用严格的空值检查。默认情况下为false
。如果您正在使用 TypeScript,您肯定希望启用严格的空值检查,因为它可以捕获许多常见的编程错误。
在 JavaScript 中工作时,严格的空值检查也很有用。启用严格的空值检查后,悬停和 IntelliSense 信息将显示哪些类型可以为
undefined
和null
。如果您在 JavaScript 中启用类型检查,VS Code 还可以使用严格的空值检查来捕获一些常见的编程错误。 -
js/ts.implicitProjectConfig.strictFunctionTypes
设置启用严格的函数类型。默认情况下为true
。严格的函数类型更难以解释,但通常也可以改进 IntelliSense 并捕获一些编程错误。
请注意,如果文件属于 jsconfig 或 tsconfig 项目,这些设置都会被覆盖。
重命名其他隐式 JS/TS 项目设置
JavaScript 和 TypeScript 的其他隐式项目设置已重命名,以使其更加准确
javascript.implicitProjectConfig.checkJs
->js/ts.implicitProjectConfig.checkJs
javascript.implicitProjectConfig.experimentalDecorators
->js/ts.implicitProjectConfig.experimentalDecorators
这些设置被重命名是因为它们适用于不属于 jsconfig 或 tsconfig 项目的 JavaScript 和 TypeScript 文件。之前的设置名称暗示它们仅适用于 JavaScript 文件。
HTML
新的格式化程序设置
HTML 扩展使用 JSBeautify 作为格式化程序。更新到最新版本的 JSBeautify (1.13) 带来了一些新的格式化程序设置
html.format.wrapAttributesIndentSize
: 在html.format.wrapAttributes
中使用force aligned
和aligned multiple
时的对齐大小,或者使用null
来使用默认的缩进大小。html.format.templating
: 支持 django、erb、handlebars 和 php 模板语言标签。html.format.unformattedContentDelimiter
: 将此字符串之间的文本内容保持在一起。
最后一个设置允许您设置一个标记,以标记不应格式化的区域
"html.format.unformattedContentDelimiter": "<!-- DoNotFormat -->"
onTypeRename 的新设置名称
当修改匹配的结束标记时,用于编辑标记的键入时重命名功能现在称为链接编辑。启用链接编辑的命令是开始链接编辑(⇧⌘F2 (Windows, Linux Ctrl+Shift+F2)) 和 Escape 禁用链接编辑模式。
启用它的设置现在是
"editor.linkedEditing": true
对扩展的贡献
远程开发
远程开发扩展的工作仍在继续,该扩展允许您使用容器、远程机器或 适用于 Linux 的 Windows 子系统 (WSL) 作为全功能开发环境。
1.52 中的功能亮点包括
- 在 Linux 远程上自动端口转发。
- 用于在本地安装远程扩展的新命令。
- 现在,您可以在容器中打开存储库时选择一个分支。
- 通过在后台安装扩展来改进服务器启动性能。
您可以在远程开发发行说明中了解新的扩展功能和错误修复。
笔记本
VS Code 团队正在继续努力对笔记本的本机支持,并改进其用户体验和性能。
改进大型文本输出渲染
如果内容太大,原生笔记本编辑器现在将截断输出,以确保用户界面始终响应。您仍然可以在文本编辑器中打开输出的完整原始内容。
扩展创作
文件装饰 API
FileDecorationProvider
API 现在是最终版本,可以被任何扩展使用。使用此 API 可以将环境信息添加到文件中,用于资源管理器中显示的 SCM 和错误装饰。
撤消资源更改
资源管理器操作(如创建文件、重命名文件或删除文件)会引发事件,这些事件允许参与,例如,onWillCreateFiles
、onWillRenameFiles
或 onWillDeleteFiles
。此版本增加了对撤消此类资源管理器操作的支持,您应该知道,在撤消操作时不会触发上述事件。
新的主题颜色
statusBarItem.errorBackground
: 状态栏错误项的背景色。错误项与其他状态栏条目区分开来,以指示错误情况。statusBarItem.errorForeground
: 状态栏错误项的前景色。错误项与其他状态栏条目区分开来,以指示错误情况。
错误背景颜色
主题作者现在可以利用编辑器中错误的新主题颜色。现在可以通过以下方式设置编辑器错误、警告和信息样式
editorError.background
editorWarning.background
editorInfo.background
更新的 Codicons
我们在 codicon 库中添加了以下新图标
check-all
circle-large-filled
circle-large-outline
pass-filled
pinned-dirty
支持用于视图容器和视图的 codicon
您现在可以使用 codicon 作为视图容器和视图的图标。示例
"views": {
"explorer": [
{
"id": "npm",
"name": "NPM Scripts",
"icon": "$(code)",
"visibility": "hidden"
}
]
}
请参阅图标列表以获取可用图标的列表。
链接编辑范围提供程序
以前称为 OnTypeRenameProvider
的现在作为公共 API LinkedEditingRangeProvider
。
对于文档中的给定位置,LinkedEditingRangeProvider
将具有相同内容的范围链接起来。对其中一个范围的更改可以应用于所有其他范围。
这可以在 HTML 中看到。在编辑开始标记的名称时,结束标记也会自动更新。
FoldingRangeProvider.onDidChangeFoldingRanges
FoldingRangeProvider.onDidChangeFoldingRanges
已被公开为公共 API。它是一个可选事件,用于指示提供程序的折叠范围已更改。
使用查询过滤器打开键盘快捷键编辑器
扩展现在可以在使用命令 workbench.action.openGlobalKeybindings
打开键盘快捷键编辑器时传递查询文本。
vscode.commands.executeCommand('workbench.action.openGlobalKeybindings', 'query');
fs.isWritableFileSystem
新的 fs.isWritableFileSystem
API 允许您检查给定的文件系统是否支持写入。例如,要检查 URL 为 example:/path/to/file
的文档是否位于可写的文件系统上
switch (vscode.fs.isWritableFileSystem('example')) {
case true:
// The `example` filesystem supports writing.
// Keep in mind the permissions or other issues may still prevent
// a file from being written.
break;
case false:
// The `example` filesystem does not support writing (it is readonly).
break;
case undefined:
// VS Code does not know about the `example` filesystem
break;
}
自定义编辑器可以使用 fs.isWritableFileSystem
来确定是否显示只读 UI。
Markdown 树工具提示 API
已完成在 TreeItem
上使用 Markdown 作为 tooltip
的 API。您可以在创建 TreeItem
时将 tooltip
设置为 Markdown 字符串,或者,如果您的 Markdown 可能需要额外的计算时间,则可以使用新的 TreeDataProvider.resolveTreeItem
来设置工具提示。
TreeItem 高亮显示 API
期待已久的 TreeItemLabel
API 已完成。此 API 可用于在 TreeItem
的 label
上设置高亮显示。您可以在“引用”视图中看到它的实际效果。
listDoubleSelection 和 listMultiSelection
现在,在贡献的树视图中使用上下文值 listDoubleSelection
和 listMultiSelection
来启用命令已起作用。
视图欢迎内容按钮启用
您现在可以为视图欢迎内容部分设置启用上下文子句。
建议的扩展 API
每个里程碑都带有新的建议 API,扩展作者可以试用它们。一如既往,我们希望得到您的反馈。这是您试用建议 API 所必须执行的操作
- 您必须使用 Insiders,因为建议的 API 经常更改。
- 您必须在扩展的
package.json
文件中添加这一行:"enableProposedApi": true
。 - 将最新版本的 vscode.proposed.d.ts 文件复制到您的项目的源位置。
您不能发布使用建议的 API 的扩展。下一个版本可能会有重大更改,我们绝不希望破坏现有的扩展。
状态栏条目背景颜色 API
我们为 StatusBarItem
提出了一个新属性 backgroundColor
,用于设置状态栏条目的背景颜色。目前,仅支持 statusBarItem.errorBackground
,以避免状态栏看起来过于花哨。我们可能会在将来将此支持扩展到更多颜色。
此新 API 的用例是使扩展能够在状态栏中指示错误情况。例如,ESLint 扩展可能会决定使用此颜色来提醒用户尚未为工作区启用 ESLint。
更多可主题化的图标
产品图标主题的工作已经恢复。产品图标主题是一个建议的功能,允许您使用一组自定义图标来设置 VS Code 的样式。它适用于内置视图中的所有图标,以及使用 Codicon 库中的图标的所有扩展。产品图标主题将在下一个里程碑中公开。
已经添加了更多图标名称,特别是对于调试、扩展和终端视图,以及设置和笔记本编辑器。
查看更新的图标列表。
删除建议的日志记录 API
大约一年前存在一个关于日志记录 API、LogLevel
和 onDidChangeLogLevel
的提议,现在已被删除。扩展可以使用输出通道 API 进行日志记录,或者,在使用自定义记录器时,使用 ExtensionContext#logUri
。
初步添加建议的测试 API
我们正在调查 VS Code 中的测试,并且该 API 的第一个版本现在出现在 vscode.proposed.d.ts
中。请阅读链接的问题以获取更多背景信息,并在您有输入时参与。我们预计将在观察者部分之前发布 API 的提供者部分。
新的上下文键运算符
<
、<=
、>
或 >=
现在可以用于上下文键表达式。这是一个为仅在打开两个或多个工作区文件夹时才会显示的命令做出贡献的示例
"contributes": {
"menus": {
...
"when": "workspaceFolderCount >= 2"
...
}
}
语言服务器协议
语言服务器协议 3.16 版本的特性集已最终确定,可在 LSP 协议站点上获得。3.16 版本的主要亮点是
详细的 变更日志 也包含对现有请求的所有细微改进。
调试适配器协议
支持条件异常
在此里程碑中,来自 2020 年 9 月的条件异常提案已最终确定,现在是调试适配器协议 (DAP) 1.43 版本的一部分。
协议添加使用新的可选 filterOptions
属性扩展了 setExceptionBreakpoints
请求,用于设置异常筛选器及其条件。调试适配器可以通过 supportsExceptionFilterOptions
功能声明它支持条件异常功能。
澄清了 StackTraceResponse.totalFrames 的语义
调试适配器协议中 supportsDelayedStackTraceLoading
功能的描述似乎表明,为了使延迟堆栈帧加载起作用,适配器必须使用可用堆栈帧的正确数量填充 StackTraceResponse
的 totalFrames
字段。但是,对于某些调试器或运行时,此值不容易计算,这使得支持延迟堆栈帧加载变得代价高昂。
由于 UI 中从未显示帧的总数,因此我们澄清了 totalFrames
的原始 - 有些缺乏 - 语义描述:调试适配器现在可以自由地为 totalFrames
提供一个较大的(不正确的)值,客户端应该准备好接收比请求的帧少的帧,并将其用作指示堆栈已到达末尾的标志。
澄清了 RunInTerminalRequestArguments.cwd 的语义
由于 runInTerminal
请求的 cwd
属性(“当前工作目录”)是非可选的,因此无法省略该属性来表示“不关心”的情况。例如,如果调试适配器知道 “cwd” 已经正确,并且不需要客户端生成 “更改目录” 命令,则 DAP 规范没有描述如何实现这一点。
为了解决这个缺陷,我们通过添加以下内容来澄清 DAP 规范:只有当 cwd
属性包含非空路径时,才期望客户端执行更改目录命令。
工程
为问题报告器和进程资源管理器启用了沙箱和上下文隔离
为了从启用 Electron 的 沙箱 和 上下文隔离 中获得更多反馈,我们已推动为我们的进程资源管理器和问题报告器窗口启用它。此配置最终也将成为主 VS Code 窗口的默认配置。
- 已启用
sandbox
- 已启用
contextIsolation
- 资源从自定义的
vscode-file
方案(而不是file
)提供。
NPM 依赖项的安全供应链
我们通过利用源代码扫描和测试服务改进了我们的 NPM 依赖项供应链,以提高我们的构建管道的安全性和可靠性。
Linux ARM 存储库
针对 ARM 架构(aarch64
和 armhf
)的 VS Code 现在发布在以下 Linux 存储库中
新命令
键 | 命令 | 命令 ID |
---|---|---|
在差异编辑器中聚焦主侧 | workbench.action.compareEditor.focusPrimarySide |
|
在差异编辑器中聚焦辅助侧 | workbench.action.compareEditor.focusSecondarySide |
|
在差异编辑器中聚焦另一侧 | workbench.action.compareEditor.focusOtherSide |
文档
远程开发
现在有几种新方法可以了解 VS Code 远程开发
- 观看讨论 VS Code 远程开发 的 “制表符还是空格” 视频。
- 或尝试逐步学习模块,了解如何 使用 Docker 容器作为开发环境。
GitHub 集成
- 查看我们关于如何最好地利用编辑器与 GitHub 集成的新学习模块:在 Visual Studio Code 中入门 GitHub。
我们如何公开地开发 VS Code
观看开发者 Alex Ross 和 Benjamin Pasero 在 GitHub Universe 上的会话录像 我们如何公开地开发 VS Code,了解我们的团队如何以开源方式构建 VS Code,并在 GitHub 上与社区协作。
Chromebook 上的 VS Code
您知道可以在 Chromebook 上运行 VS Code 吗?我们认为这对学生和初学者程序员来说是一个很好的选择。 通过我们的 在 Chromebook 上使用 VS Code 进行学习 博客文章了解如何在 Chrome OS(通过 Crostini)上设置 VS Code,其中包含使用 JavaScript 和 Python 开始编码的说明。
重要修复
- 39543:在拆分 JSON 设置编辑器的概述标尺中突出显示匹配的单词。
- 67905:同时安装多个扩展 vsix 文件
- 83187:一个配置中的环境变量会泄露到另一个配置中。
- 88703:设置 UI 中未报告具有 URI 格式的字段的错误
- 97202:${config
} 变量无法在多根工作区启动配置中解析。 - 98041:Emmet 忽略“计算数学表达式”上的选择
- 107320:安装包含 main 的扩展时不应显示主题选择器。
- 107461:调试控制台中的历史记录未保留
- 109111:调试控制台不遵守用户设置。
- 110077:数据断点未显示在“断点”视图中。
- 110426:支持使用从标准输入读取的
--diff
参数 - 110738:允许扩展为自定义文件系统方案设置编辑器标签
- 110775:Shift 右键单击的“永久删除”选项已消失
- 110854:支持在已打开的编辑器中对文件系统提供程序的只读更改
- 110905:CLI:除非强制,否则如果已安装扩展,则不要访问 Marketplace
感谢
最后但并非最不重要的是,非常感谢以下在本月为 VS Code 做出贡献的人们
对我们的问题跟踪的贡献
- John Murray (@gjsjohnmurray)
- Simon Chan (@yume-chan)
- Andrii Dieiev (@IllusionMH)
- ArturoDent (@ArturoDent)
- Alexander (@usernamehw)
对 vscode
的贡献
- Aasim Khan (@aasimkhan30)
- 修复 ListWidget 转义按钮行为 PR #110760
- 为复选框添加轮廓偏移以使焦点可见。 PR #110038
- @AE1020:使单击滚动条按页移动 PR #104923
- @alisonnoyes:安静浅色主题差异语法高亮 PR #107926
- Andrew Casey (@amcasey):公开 TS 服务器跟踪 PR #110534
- Andrew Branch (@andrewbranch):[typescript-language-features] 更新 importModuleSpecifierPreference 值 PR #110536
- @apogeeoak:防止重新打开 Markdown 预览时出错。 (#_107205) PR #111449
- Jonathan Belcher (@belcherj):修复 Firefox 的组合逻辑 PR #106873
- @BTNDev:为代码片段更新了 javascript PR #111062
- Borja Zarco (@bzarco):在解析配置变量时,如果没有
folderUri
,则不会失败。 PR #97203 - @chanmaoooo:添加“deleteWordEntire”命令 PR #109511
- chenjigeng (@chenjigeng):修复了在 HTML 中编写 javascript 时悬停样式不正确的问题 PR #111110
- @dataleaky:更新 package.json PR #111661
- Devansh Jethmalani (@devanshj):feat(quickinput):支持提示中的代码图标 PR #102898
- Aadhish Sriram S (@dfireBird):feat:检测默认储藏消息 microsoft#106907 PR #107074
- @digeff:为 searchView/context 添加了可扩展点 PR #109049
- Nathaniel Palmer (@diminutivesloop):在失败时提供显示 git 命令输出的选项 PR #95354
- Dor Mesica (@dormesica):在删除储藏之前添加警告。 PR #94267
- David Sanders (@dsanders11)
- 修复错误消息 PR #111269
- 将 vscode.Uri 添加到 vscode.RelativePattern 的 base 参数的类型 PR #111155
- 使用标签作为“关注链接”命令的工具提示 PR #110917
- 阐明命令启用的效果 PR #110423
- 使用 Array.flat() PR #110189
- Ikko Ashimine (@eltociear):修复了将“sequece”拼写为“sequence”的错别字 PR #109643
- Erik Krogh Kristensen (@erik-krogh):修复解析 markdown 文件时的灾难性回溯 PR #109964
- Jakub Piskiewicz (@eXotech-code):添加了一个用于自动打开克隆存储库的设置。 PR #94369
- Fabio Zadrozny (@fabioz):FileSystemWatcher 限制的文档 (#_60813) PR #110858
- Himanshu Kapoor (@fleon):允许 monaco-editor 与 Jest 正常工作 PR #109833
- Ben Curtis (@Fmstrat):添加 ignoreSubmodules 选项 PR #88772
- John Murray (@gjsjohnmurray)
- 修复 #109733 防止在标题栏中出现双重“(只读)”后缀 PR #109736
- 修复 #106487 为 viewsWelcome 贡献的按钮实现“enablement”子句 PR #107705
- Guillaume Lachance (@glachancecmaisonneuve):Windows 资源管理器图标 PR #86283
- Hung-Wei Hung (@hunghw):创建包含已更改文件的空提交 #107753 PR #107958
- Dhruva Srinivas (@IQUBE-X):向 Markdown 片段添加定义列表 PR #110026
- Jean Pierre (@jeanp413)
- 修复快速导航导航栏时扩展编辑器故障 PR #110370
- 修复打印长行时终端滚动时的延迟 PR #110213
- 改进合并冲突中已删除文件的差异显示 PR #91245
- 修复源代码管理记住树的折叠状态 PR #89313
- Jessica Petty (@jepetty):添加节点任务以修复损坏的富导航构建 PR #110762
- Josias (@justjosias):拼写错误 hightlight -> highlight PR #108451
- @KapitanOczywisty:比较时忽略 LineDecoration 的顺序 PR #108379
- Ken Aoki (@kena0ki):更新 xterm.css PR #109850
- Wenlu Wang (@Kingwl)
- Oliver Larsson (@LarssonOliver):git.pruneOnFetch 设置已实现 PR #89249
- Jiaxun Wei (@LeuisKen):在 ExtensionUrlBootstrapHandler 中缓存 OpenURLOptions PR #110725
- Jade (@lf-):显式 fontLigatures 描述 PR #109987
- Logan Rosen (@loganrosen):将 .ember-cli 标记为 jsonc 而不是 json PR #110541
- Mohammed Al-Dahleh (@maldahleh):#109255 - 向设置“文件:编码”下拉列表添加编码描述 PR #109551
- Mathias Rasmussen (@mathiasvr):允许仅修改 git 提交消息 PR #91838
- MD Asif Hasan (@mdasifhasan):修复 Pull 和 Sync 的 fetchOnPull 行为 PR #99324
- Seth Fitzsimmons (@mojodna):拼写错误:Uncommited → Uncommitted PR #109119
- Nicholas Rayburn (@nrayburn-tech):为 launch.json 添加 dirSep 变量 PR #105887
- oli (@olivercoad):处理冲突的多字符自动关闭对 PR #110094
- @Pikachu920:防止将不需要的“null”连接到反馈 URL PR #111325
- Pablo Sebastian Greco (@psgreco)
- 更多针对 armhfp 和 aarch64 rpm 硬编码依赖项的清理 PR #111253
- 修复 armv7hl 和 aarch64 的硬编码 rpm 依赖项 PR #111198
- Rotem Bar (@rotem-bar):feat(extensions): 添加了禁用具有启用依赖项的扩展时禁用相关依赖项的选项 PR #104997
- Andreas Ziegler (@rupran):scmViewPane:不在提交消息输入字段中渲染空格 PR #107913
- Dmitry Sharshakov (@sh7dm):Git:在储藏之前要求保存未保存的文件 PR #94358
- Shivang Tripathi (@shivangg):feat: 自动检测 npm.packageManager #102050 PR #102494
- Shunsuke Iwamoto (@shskwmt):修复 #93946。滚动时移除焦点。 PR #94280
- Emanuel Tesař (@Siegrift):启用 tsec 作为语言服务插件 PR #108682
- Jonathan Mannancheril (@SneakyFish5)
- Git:添加 cherryPick 命令 PR #104614
- 添加 git.pushTags 设置 PR #104312
- Scott Davis (@stdavis):feat: 实现 Git: 推送标签命令 PR #110096
- Suman B K (@sumanbk92):包括 ` 作为 foldEndPairCharacters 的一部分 PR #110108
- Tim (@Timmmm):添加原子制表符选项 PR #107126
- @turara
- 更新 OneSnippet#move 方法以修复 #96545。 PR #108964
- 向 SearchView 添加 updateTextFromFindWidgetOrSelection 方法 PR #108401
- 更新 CodeActionOnSaveParticipant PR #108193
- Alexander (@usernamehw)
- 添加一个设置,以包含与语言无关的基于单词的建议 PR #110494
- 修复 #99971 - 在功能贡献中显示激活事件 PR #100010
- Valter Pires (@vfcp):更正“Tomorrow Night Blue”主题的 package.nls.json 中的 themeLabel PR #110178
- Jason Wang (@wangjaso):提供一个选项,对于 git.api.getRemoteSources 默认使用 github 提供程序 PR #106368
- Eno Yao (@Wscats)
- 支持键盘快捷键浏览器上下文键 PR #110902
- 支持大于和小于 PR #110846
- 优化代码可读性 PR #110572
- @xndcn:修复迷你地图滑块的覆盖区域 PR #108448
- winwin2011 (@YuJianghao):修复进度位溢出错误 PR #110411
- Zuckjet (@Zuckjet):悬停信息不应在单词内中断 PR #106885
对 language-server-protocol
的贡献
- @KamasamaK
- Danny Tuppeny (@DanTup):调整以简化规范的解析 PR# 1156
对 vscode-languageserver-node
的贡献
- Niccolò Belli (@darkbasic):实现 ShowTextDocumentRequest PR #490
- Danny Tuppeny (@DanTup):在 onProgress 中添加对中间件的支持 PR #690
- Julien HENRY (@henryju):使用 appName 作为客户端信息,而不是“vscode” PR #697
对 vscode-eslint
的贡献
对 vscode-js-debug
的贡献
- Momtchil Momtchev (@mmomtchev):添加对调试外部节点内部的支持 PR #824
对 vscode-html-languageservice
的贡献
- Jean Pierre (@jeanp413):修复自动完成文本编辑输出 </[object Object]> PR #93
对 node-jsonc-parser
的贡献
- Dan Russell (@dangrussell):向 typings 属性值添加文件扩展名 PR #43
对 vscode-generator-code
的贡献
- Tom Sherman (@tom-sherman):将已弃用的
assert.equal
替换为strictEqual
PR #229 - Tomáš Hübelbauer (@TomasHubelbauer):允许通过 CLI 传递 gitInit、pkgManager 和 webpack PR #227
对 vscode-vsce
的贡献
- Fabian Meumertzheim (@fmeum):确保 package.json 在 *.vsix 中可写 PR #508
- James George (@jamesgeorge007):chore:删除过时代码 PR #511
- Matan Gover (@matangover):presense -> presence PR #510