2023 年 2 月(1.76 版本)
1.76.1 更新:此更新解决了这些 问题。
1.76.2 更新:此更新解决了这些 问题。
下载:Windows:x64 Arm64 | Mac:通用 Intel silicon | Linux:deb rpm tarball Arm snap
欢迎使用 Visual Studio Code 2023 年 2 月版本。此版本包含许多更新,我们希望您喜欢这些更新,其中一些关键亮点包括
- 配置文件 - 活动配置文件徽章,通过命令面板快速切换配置文件。
- 辅助功能改进 - 新的音频提示,改进的终端屏幕阅读器模式。
- 可移动的资源管理器视图 - 将资源管理器放置在辅助侧边栏或面板中。
- 笔记本内核 MRU 列表 - 查找和选择最近使用的笔记本内核。
- Markdown 标题链接建议 - 轻松链接到工作区中文件的标题。
- 远程开发可用性 - 新的键盘快捷键,简化的远程选项列表。
- 新的 Git/GitHub 主题 - 针对初学者和高级 Git 源代码控制用户的文章。
- 改进的 Marketplace 搜索 - 对多词查询提供更好的结果。
- Jupyter IPyWidgets 8 支持 - 在 Jupyter 笔记本中使用最新的 IPyWidgets 版本。
- Python pytest IntelliSense - pytest 固定装置和参数化参数的代码完成。
如果您想在线阅读这些发行说明,请访问 更新,网址为 code.visualstudio.com。
内部人员:想尽快尝试新功能吗?您可以下载夜间 内部人员 版本,并在新功能可用时立即尝试。
辅助功能
终端命令失败音频提示
当命令在具有 Shell 集成的终端中以非零代码退出时,有视力的用户可以快速查看命令装饰,了解发生了错误。为了向屏幕阅读器用户传达错误,VS Code 现在播放 audioCues.terminalCommandFailed
音频提示。
您可以通过滚动浏览 帮助:列出音频提示 下拉菜单来收听可用的音频提示声音。
改进的错误音频提示响应速度
audioCues.lineHasError
音频提示现在在字符导航期间播放,以便屏幕阅读器用户可以更好地了解编辑器中的错误位置。
终端可访问缓冲区改进
在上次迭代中,我们引入了终端可访问缓冲区,该缓冲区使屏幕阅读器用户可以通过 终端:聚焦可访问缓冲区 命令访问终端内容。
在此迭代中,我们通过添加选择和链接支持、使其成为只读以及使用 Shell 集成洞察力来将输出限制为仅重要的终端内容(运行的命令、如果有的话则为退出代码和输出)来改进可访问缓冲区。我们计划在下次迭代中添加此功能的配置。
上下文特定的 Tab 聚焦模式
切换 Tab 键移动焦点 命令对于确定工作台或编辑器/终端接收 Tab 键输入非常有用。
新的 editor.tabFocusMode
设置允许用户设置默认行为。当该值为 true
时,工作台接收 Tab 键输入,而不是编辑器或终端。
Windows 上的屏幕阅读器 Shell 集成支持
由于在此上下文中 PowerShell 支持存在问题,因此以前在 Windows 上检测到屏幕阅读器时,Shell 集成被禁用。我们已经确定这在大多数情况下不再是问题,因此已启用它。
终端可访问帮助添加
与屏幕阅读器社区的讨论导致在 终端辅助功能帮助 对话框 () 中添加了内容,例如提及 创建新终端(带配置文件) 和 首选项:打开辅助功能设置 命令。
配置文件
配置文件,发布到稳定版 上一个里程碑,使您能够根据当前的工作流程和项目快速切换 VS Code 配置。您可以保存一组自定义设置,例如设置、扩展和键盘快捷键,在您的机器之间同步它们,以及轻松地与同事共享它们。
配置文件徽章
VS Code 现在通过在 管理 活动栏图标上显示配置文件名称的前两个字母作为配置文件徽章来指示当前的自定义配置文件。
主题可以通过配置两个新的主题颜色来自定义配置文件徽章的背景和前景颜色
profileBadge.background
profileBadge.foreground
切换配置文件
您现在可以通过命令面板中的 配置文件:切换配置文件 命令 (⇧⌘P(Windows、Linux Ctrl+Shift+P)) 快速切换配置文件,该命令会显示一个下拉列表,列出您的可用配置文件。
远程工作区中的配置文件
您现在可以创建和自定义包含 远程扩展 的配置文件,并在 远程开发 工作区中切换它们。
下面两个不同的配置文件(“文档编写”和“代码”)在两个 远程 - SSH 实例中处于活动状态。
配置文件文档
如果您想了解有关配置文件以及它们在哪些情况下有用的更多信息,请查看新的 Visual Studio Code 中的配置文件 主题。本文详细介绍了如何创建、修改、共享和重用配置文件。
工作台
可移动的资源管理器视图
VS Code 中的大多数视图和视图容器都可以移动,除了少数内置视图和容器。在此版本中,资源管理器视图容器 (⇧⌘E(Windows、Linux Ctrl+Shift+E)) 现在可以移动,并且可以放置在辅助侧边栏或底部面板中,以便进一步自定义工作台。
下面,文件资源管理器视图已移至面板区域。
如果您想将所有视图重置回默认布局,则可以从命令面板运行 视图:重置视图位置。
固定宽度居中布局
视图:切换居中布局 命令 (workbench.action.toggleCenteredLayout
) 现在具有固定宽度布局选项。此选项通过新的 workbench.editor.centeredLayoutFixedWidth
设置启用。启用后,并且居中布局处于活动状态,编辑器将居中并尝试在窗口和面板调整大小过程中保持其宽度。
多个快速差异
随着提出的 多个快速差异 API 的引入,多个扩展可以提供快速差异。当文件中存在多个快速差异时,您现在会看到一个下拉菜单,用于选择要查看的差异基础。
评论
评论 视图有一个新的 全部展开 命令,与现有的 全部折叠 命令相对应。未解决的评论的槽图标现在与 评论 视图中使用的图标相同。
配置默认日志级别
您现在可以从 开发人员:设置日志级别... 命令中配置 VS Code 或扩展的默认日志级别。这将在重启后持久保存,并在机器之间同步。
选择一个扩展将显示与默认日志级别相同的日志级别下拉菜单。
扩展编辑器中的已验证发布者域
扩展编辑器现在在已验证指示器旁边显示已验证的发布者域。下面,prettier.io
域显示在已验证徽章的右侧。
编辑器
JSONC 文档排序
现在可以按键排序 JSONC(包含注释的 JSON 文档)文件。要使用此功能,请从命令面板中选择 JSON:排序文档。
独立的括号对用于匹配和着色
在此迭代中,我们更改了当同时配置editor.language.brackets
和editor.language.colorizedBracketPairs
时的行为。之前,设置editor.language.colorizedBracketPairs
将覆盖editor.language.brackets
的括号匹配(因为两者使用相同的括号对树)。现在,两个设置的并集用于括号匹配,但只有在editor.language.colorizedBracketPairs
中配置的括号会被着色。
源代码管理
Git 提交语法高亮
VS Code 采用了一种新的 Git 语法,为 Git 提交消息文件提供语法高亮。新语法对英语以外的语言提供了更好的支持。
Git 和 GitHub 文档
无论您是源代码控制的新手还是经验丰富的 Git 用户,您都可以在我们文档的源代码控制部分了解更多关于 VS Code 的 Git 集成的信息。文章包括
- 在 VS Code 中使用 Git 源代码控制 - VS Code 的 Git 集成功能概述。
- Git 简介 - VS Code 中的初学者级 Git 操作。
- 使用 GitHub - 将您的代码移至GitHub 以与他人共享和协作。
- 常见问题解答 - 获取常见情况和陷阱的帮助。
笔记本
内核选择器默认模式:MRU
内核选择器现在默认显示最近使用(MRU)的内核。这与之前显示所有可用内核的行为有所不同。您仍然可以通过辅助选择器选择其他内核...查看所有内核,当您安装了最新的Jupyter和Python扩展时,它会按其来源(例如:Jupyter 内核、Python 环境等)对内核进行分组。
笔记本渲染器性能诊断
在运行笔记本单元时,一些笔记本输出渲染器可能需要很长时间才能渲染。为了帮助识别这些渲染器,我们在笔记本单元状态栏的悬停中添加了诊断信息。此视图显示每个渲染器执行所需的时间和总执行时间。此外,悬停中的链接将打开问题报告器,其中预先填写渲染器名称和执行时间,以便您在发现渲染器执行时间过长时轻松提交问题。
对内置错误渲染器更好的链接支持
内置错误渲染器现在支持指向文件和行号的链接。这允许您点击错误消息中的文件路径并在编辑器中打开文件。
Jupyter 扩展的错误渲染器已弃用,取而代之的是内置错误渲染器。
语言
Markdown 工作区标题链接完成
需要链接到另一个 Markdown 文档中的标题,但记不住或不想输入完整的路径?尝试使用工作区标题完成!要开始,只需在 Markdown 链接中键入##
即可查看当前工作区中所有 Markdown 标题的列表。
接受其中一个完成,插入到该标题的完整链接,即使它在另一个文件。
您可以通过Markdown > 建议 > 路径:包含工作区标题完成设置(markdown.suggest.paths.includeWorkspaceHeaderCompletions
)来配置工作区标题完成显示的时间和方式。
有效的设置值是
onDoubleHash
(默认) - 仅在您键入##
后显示工作区标题完成。onSingleOrDoubleHash
- 在您键入#
或##
后显示工作区标题完成。never
- 从不显示工作区标题完成。
请记住,查找当前工作区中的所有标题可能很费时,因此第一次请求它们时可能会出现轻微的延迟,特别是对于包含大量 Markdown 文件的工作区。
配置 Markdown 链接的首选文件扩展名样式
新的markdown.preferredMdPathExtensionStyle
设置配置 VS Code 是否更喜欢为指向 Markdown 文件的链接使用文件扩展名。此首选项用于语言工具,如路径完成和链接重命名.
有效的设置值是
auto
- 尝试保留文件扩展名的现有样式。includeExtension
- 在链接中包含尾随的.md
。removeExtension
- 从链接中删除尾随的.md
。
远程开发
通过远程开发扩展,您可以使用开发容器、通过 SSH 或远程隧道连接到远程计算机,或使用适用于 Linux 的 Windows 子系统(WSL)作为功能齐全的开发环境。
您可以在远程开发版本说明中了解新的扩展功能和错误修复。
远程菜单
在本里程碑中,我们对远程菜单进行了若干可用性改进,可以通过单击状态栏左下角的远程指示器访问。
-
现在有一个默认的键盘绑定来打开远程菜单:⌥⌘O(Windows、Linux Ctrl+Alt+O)。
-
我们减少了远程扩展对远程菜单的贡献,使其易于查看所有连接到远程窗口的操作。
- 用于打开远程窗口的基本操作现在始终在远程菜单中可用,因此即使您已在远程窗口中,您也可以发现连接到另一个远程的操作。
- 大多数用于配置或开始使用远程的操作已从远程菜单移至命令面板,以节省远程菜单中的空间。
-
远程菜单中的安装其他远程扩展选项现在指向精选的远程开发扩展列表,如果所有此类扩展都已安装,则会从远程菜单中隐藏。
远程存储库
在本里程碑中,我们在远程存储库扩展中引入了无需克隆即可浏览和编辑远程存储库演练,以帮助您搜索、编辑和在 GitHub 和 Azure Repos 中创建快速提交,而无需在本地克隆。
您还可以查看远程存储库教程,以帮助您入门。
VS Code for the Web
在本里程碑中,我们为Git LFS跟踪的文件添加了实验性的只读支持,这些文件托管在vscode.dev上的 GitHub 和 Azure Repos 存储库中。
在下面的短视频中,当在 vscode.dev 上滚动 Markdown 预览时,存储在 vscode-docs 存储库中 Git LFS 上的图像可见。
当您查看 GitHub 或 Azure Repos 存储库中的文件时,根据您的.gitattributes
配置,我们会检测文件是否为 LFS 跟踪以及是否需要从 GitHub 或 Azure Repos 的 LFS 服务器获取。
您还可以使用GitHub 存储库和Azure Repos扩展与 VS Code 桌面一起浏览包含 Git LFS 跟踪文件的存储库,而无需克隆。
可以使用以下设置禁用此行为
"githubRepositories.experimental.lfs.read.enabled": false
"azureRepos.experimental.lfs.read.enabled": false
VS Code 尚未支持提交 Git LFS 跟踪文件,并且github.dev 也不支持 Git LFS 读取。
扩展
改进的扩展搜索相关性
我们在扩展视图和市场画廊中改进了扩展搜索结果的相关性。现在结果应该更合适,特别是对于多个单词的查询。
之前 | 之后 |
---|---|
对扩展的贡献
Jupyter
IPyWidgets
Jupyter扩展现在支持IPyWidgets 的版本8
。依赖于IPyWidgets 7.*
的 Python 小部件将继续工作,因为版本7.*
和8.*
都受支持。
交互式窗口内核选择
为交互式窗口自动选择内核已修改,以更好地与新的内核选择器 UI 配合使用。使用当前活动解释器,除非之前为该工作区中的交互式窗口选择过另一个内核,在这种情况下,将使用之前选择的内核。
Python
改进的 pytest 的 IntelliSense 支持
Pylance扩展现在具有强大的功能,可以帮助您在使用pytest编写清晰、简洁且易于理解的测试时更高效、更有效地工作。
- 对 pytest 固定装置和参数化参数的支持,包括完成、转到定义、查找所有引用和重命名符号(F2)。
- 通过内联提示(由
"python.analysis.inlayHints.pytestParameters"
设置启用)和代码操作对 pytest 参数进行类型注释支持。 - 根据提供给装饰器的参数值推断参数化 pytest 参数的类型。
下面的短视频重点介绍了这些新的 pytest 功能。
GitHub 拉取请求和问题
GitHub 拉取请求和问题扩展取得了更多进展,该扩展允许您处理、创建和管理拉取请求和问题。亮点包括
- 在 PR 说明和评论中渲染永久链接。
- 从说明页面重新请求审查。
- 已检出 PR 中文件的快速差异。
查看扩展的 0.60.0 版本的更改日志,以查看其他亮点。
预览功能
富内容笔记本搜索
全局搜索现在支持显示笔记本中的结果,就像它们在笔记本编辑器中显示一样。启用search.experimental.notebookSearch
试用一下,并告知我们您遇到的任何错误!目前仅支持搜索单元格输入和单元格中的 Markdown 源。
主题:社区材质主题(vscode.dev 上的预览)。
异步标记化
此版本发布了实验性的异步标记化功能。此功能允许编辑器在单独的 Web 工作器中标记化文档,这可以提高文档很大时编辑器的响应能力。
目前,异步标记化默认情况下处于禁用状态,但可以通过将editor.experimental.asyncTokenization
设置为true
来启用。
TypeScript 5.0 支持
此更新包含对即将发布的 TypeScript 5.0 版本的支持。请查看 TypeScript 5.0 Beta 博客文章 和 TypeScript 5.0 迭代计划,以获取有关 TypeScript 团队目前正在进行工作的更多详细信息。一些编辑器工具的亮点
- 新的
switch
和case
完成帮助你更快地填写switch
语句的两个部分。 - 正在进行的工作是在 github.dev 和 vscode.dev 上启用项目范围的 IntelliSense。
若要开始使用 TypeScript 5.0 夜间构建版本,请安装 TypeScript Nightly 扩展程序,或安装最新的 VS Code 1.76+ 预览版构建。
扩展编写
在 InputBox 提示和验证消息中支持链接
在本次迭代中,我们引入了对 InputBox
提示和验证消息中链接的支持。现在,你可以在这些字符串中使用以下语法来创建链接
[link text](link target)
链接目标可以是 URL 或命令 ID。当用户单击链接时,链接目标将分别在浏览器中打开或作为命令执行。
示例
const result = await vscode.window.showInputBox({
prompt:
'Please enter a valid email address [more info](https://aka.ms/vscode-email-validation)',
validateInput: text => {
if (text.indexOf('@') === -1) {
return 'Please enter a valid email address, [more info](https://aka.ms/vscode-email-validation)';
}
return undefined;
}
});
这将导致以下提示
以及以下验证消息
主题:熊猫主题(在 vscode.dev 上预览)
此行为适用于 showInputBox
和 createInputBox
API。
有关 * 激活事件的信息诊断
当扩展程序使用 *
(星号)激活事件时,它会在 VS Code 启动过程中激活。这可能会延迟 VS Code 的启动。为了帮助扩展程序作者了解使用 *
激活事件的影响,我们添加了一个信息诊断,当扩展程序使用 *
激活事件时会显示该诊断。该诊断显示在“问题”视图中,也可以在扩展程序编辑器中看到
有关 *
(星号)激活的更多信息,请阅读 激活事件 文档。
when 子句上下文解析中即将发生的更改
when 子句 用于扩展清单文件 (package.json
) 中,允许扩展程序有选择地启用和禁用贡献,例如命令和 UI 元素(例如,菜单或视图)。下一个 VS Code 版本计划包含一个新的 when 子句解析器。新的解析器提供更多功能和正确性,但它也对 when 子句实施更严格的规则,并且可能导致一些现有 when 子句出现故障。查看 问题 #175540 以了解有关故障和新功能的更多信息。我们还鼓励你订阅该问题,以获取有关新解析器的更新,包括新功能、故障和迁移指南。
即将发布的 Electron 更新可能需要对原生模块进行强制性更改
我们计划在下一个稳定版本中更新到 Electron 22。由于启用了 V8 内存笼,这对利用原生模块的扩展程序具有影响:指向外部(“堆外”)内存的 ArrayBuffers
不再被允许。这意味着依赖于 V8 中此功能的原生模块需要重构才能在 VS Code 1.77
及更高版本中继续运行。
请遵循 Electron 博客文章 中的建议,了解如何使你的原生模块与未来版本的 VS Code 兼容。
语言服务器协议
已发布了 语言服务器协议 (LSP) 客户端 (8.1.0) 和服务器 (8.1.0) npm 包的新版本。这些是错误修复版本(主要是为了解决使用完整文本文档同步时出现的请求排序问题),并且包含用于向 JSON-RPC 库添加自定义消息处理的 API。
建议的 API
每个里程碑都伴随着新的提议 API,扩展程序作者可以试用它们。和往常一样,我们希望获得你的反馈。以下是如何试用提议 API 的步骤
- 找到你想试用的提议 并将其名称添加到
package.json#enabledApiProposals
中。 - 使用最新的 vscode-dts 并运行
vscode-dts dev
。它将把相应的d.ts
文件下载到你的工作区中。 - 你现在可以针对该提议进行编程。
你无法发布使用提议 API 的扩展程序。下一个版本中可能存在重大更改,我们绝不希望破坏现有扩展程序。
OpenDialogOptions 允许使用 UI 资源
知道自己在远程扩展主机中运行的扩展程序可以使用 allowUIResources
使“显示本地”按钮显示在打开文件对话框中。使用 allowUIResources
的扩展程序应始终检查返回的 URI 的方案。
QuickPickItems 的工具提示
在本次迭代中,我们正在引入一个新的提议 API,用于 QuickPickItem
中的 tooltip
属性。此属性允许你为 Quick Pick 中的每个项目指定工具提示。当用户将鼠标悬停在项目上时会显示工具提示,或者可以使用 Ctrl+Space 切换显示。
示例
await vscode.window.showQuickPick(
[
{
label: 'label',
tooltip: 'tooltip'
},
{
label: 'label2',
tooltip: new vscode.MarkdownString('tooltip2 [link](https://github.com)')
}
],
{
placeHolder: 'placeholder'
}
);
这将导致以下 Quick Pick
主题:熊猫主题(在 vscode.dev 上预览)
显然,这是一个不需要工具提示的简单示例。当你想要提供可能包含多行或指向其他资源的链接的长描述时,工具提示非常有用。
我们认为此属性是 Quick Pick API 的一个很好的补充,我们期待收到你的反馈。
工程
更多 Electron UtilityProcess 的采用
作为我们 进程沙箱之旅 的一部分,我们希望确保我们的应用程序中不再有启用了 Node.js 的浏览器窗口。在本里程碑中,我们开始将我们最后剩余的进程从隐藏的 Node.js 浏览器窗口转换为 Electron UtilityProcess。作为这项工作的一部分,文件监视器进程也必须移到它自己的 UtilityProcess 中。
一个新的设置 window.experimental.sharedProcessUseUtilityProcess
启用了 UtilityProcess
的使用,我们计划在下个版本中将其设为默认值。
macOS 10.11 和 10.12 支持已结束
正如我们在 1.75 版本说明 中提到的,1.76
是支持 macOS 10.11 (OS X El Capitan) 和 10.12 (macOS Sierra) 的最后一个版本。请参考我们的 常见问题解答,以获取更多信息。
重要修复
感谢
最后但同样重要的是,衷心感谢 VS Code 的贡献者。
问题跟踪
对我们的问题跟踪的贡献
- @gjsjohnmurray (John Murray)
- @IllusionMH (Andrii Dieiev)
- @ArturoDent (ArturoDent)
- @starball5 (starball)
- @tjx666 (余腾靖)
拉取请求
对 vscode
的贡献
- @davidnx: 使用“在文件夹中查找”时转义特殊通配符字符 PR #166318
- @DerDemystifier (Bassim EL BAKKALI EL GAZUANI): 在 QuietLight 中设置透明度以匹配突出显示 PR #174296
- @dtivel (Damon Tivel)
- 改进对签名扩展程序验证的错误处理和日志记录 PR #174730
- 更新发行版 PR #175115
- @eronnen (Ely Ronnen)
- 修复 #173869 为代码元素在 Markdown 预览中也标记活动行 PR #173870
- 修复 #174711 在 Markdown 自定义编辑器中显示“显示源代码”命令 PR #174712
- @gjsjohnmurray (John Murray)
- 将注释区域小部件的“喙”箭头指向单行范围(#_173690) PR #174291
- 在适当的时候在槽中显示未解析的注释字形(#_149162) PR #174418
- @hamzahamidi (Hamza Hamidi): 修复(键绑定):修复扫描码和简单键的哈希码 PR #173456
- @hermannloose (Hermann Loose): 向注释面板添加“展开全部”操作 PR #173132
- @ibuky (ibuky): 修复 #171379 PR #172175
- @jongwooo (Jongwoo Han): 使用环境文件替换已弃用的
set-output
命令 PR #172691 - @jsanjose (JSJ): 修复 OpenWithCodeContextMenu 文本 PR #173468
- @MarkZuber (Mark Zuber)
- 为 vscode-server 套接字文件添加自定义路径,并命名管道长度 PR #172481
- 以块的形式发送大型 RPC 消息 PR #174278
- @maski07 (Masaki Mori): 修复 #173735 PR #174149
- @rtjoa (Ryan Tjoa): 在
Workbench › List: Fast Scroll Sensitivity
的描述中使用 Markdown PR #173878 - @Schamper (Erik Schamper): 仅在实际脱机时引发 OfflineError PR #172708
- @thernstig (Tobias Hernstig): 为
.env.*
添加 shell 脚本filenamePatterns
PR #173426 - @Viijay-Kr (Vijaya Krishna): #162727: '调试:运行到光标' 命令现在在非活动调试会话中可用 PR #169819
- @walles (Johan Walles): 解冻 Git 提交消息语法 II PR #173195
对 vscode-pull-request-github
的贡献
- @joshuaobrien
- @kabel (Kevin Abel): 从 vsix 中忽略更多文件 PR #4530
对 vscode-vsce
的贡献
- @calebcartwright (Caleb Cartwright): 在文档中提及 yarn 测试要求 PR #830
- @lucyydotp (Lucy): 不要将 .js 扩展名追加到 .cjs 文件 PR #825
对 monaco-editor
的贡献
- @mathedu4all (Bao Hongchang): 更新 README.md 中的 api 文档 URL PR #3550