🚀 在 VS Code 中！

2022 年 5 月（版本 1.68）

更新 1.68.1：此更新解决了这些 问题。

下载：Windows：x64 Arm64 | Mac：通用 Intel silicon | Linux：deb rpm tarball Arm snap

欢迎使用 Visual Studio Code 2022 年 5 月版。此版本包含许多更新，我们希望您会喜欢，其中一些主要亮点包括

如果您想在线阅读这些发行说明，请访问 code.visualstudio.com 上的更新。

Insiders： 想要尽快试用新功能？您可以下载每晚 Insiders 版本，并在最新更新可用时立即试用。

工作台

配置显示语言改进

已刷新配置显示语言命令，以包含

  • 该语言的语言名称。
  • 可用语言部分，显示您的计算机上未安装哪些语言，选择一种语言将自动安装并应用该语言。

Configure Display Language dropdown with installed and available Language Packs in their language

主题：Panda Theme

这应有助于发现可用的语言包。请告知我们您的想法！

问题面板表格视图

在此里程碑中，我们为用户添加了一项新功能，可以在树状视图和表格视图之间切换问题面板的视图模式。与树状视图相比，表格视图表面化了每个问题的来源（语言服务或扩展），使用户可以按来源筛选问题。

Problems panel table view

主题：GitHub Dark Dimmed Theme

您可以使用问题面板右上角的以表格形式查看/以树状形式查看按钮切换视图 UI，或者使用问题：默认视图模式设置 (problems.defaultViewMode) 更改默认视图模式

Problems panel View at Table button

已弃用的扩展

在此里程碑中，我们在 VS Code 中添加了对已弃用扩展的支持。扩展可以简单地弃用，也可以为了另一个扩展而弃用，或者在其功能内置到 VS Code 中时弃用。VS Code 将在扩展视图中将扩展呈现为已弃用，如下所示。

不再维护的已弃用扩展。

Deprecated extension with no maintenance

为了另一个扩展而弃用的扩展。在这种情况下，VS Code 不允许用户安装此扩展。

Deprecated extension with alternative

功能已内置到 VS Code 中的已弃用扩展，可以通过配置设置来启用。

Deprecated extension with builtin to VS Code

VS Code 不会自动迁移或卸载已弃用的扩展。将有一个迁移按钮来引导您切换到推荐的扩展。

Migrate deprecated extension

主题：GitHub Dark Dimmed Theme

注意： 已弃用扩展的列表由 VS Code 维护。如果您有认为应该弃用的扩展，请在此讨论中评论与我们联系。

扩展赞助

VS Code 现在允许用户赞助他们喜爱的扩展。当扩展可以被赞助时，VS Code 将在扩展视图的详细信息页面中呈现一个赞助按钮，如下所示

Sponsor extension button on Extensions view Details page

主题：GitHub Dark Dimmed Theme

赞助按钮将引导您到扩展的赞助 URL，您可以在那里提供支持。请参阅扩展赞助，了解如何为您的扩展选择加入此功能。

使用 .gitignore 隐藏资源管理器中的文件

文件资源管理器现在支持解析和隐藏 .gitignore 文件排除的文件。可以通过资源管理器：排除 Git 忽略 (explorer.excludeGitIgnore) 设置启用此功能。此设置与 files.exclude 一起工作，以隐藏资源管理器中不需要的文件。

注意：目前，否定 glob（如 !package.json）不可解析。

锁定悬停位置

由于存在其他 UI 元素（例如，滚动条），一些自定义悬停很难或不可能鼠标悬停。在悬停处于活动状态时按住 Alt 键现在将“锁定”它，使其具有更宽的边框，并防止鼠标移动到悬停之外而隐藏它。这主要是一个辅助功能，使悬停与屏幕放大镜配合使用，但对于从悬停复制文本也很有用。请注意，此功能仅适用于编辑器外部，因为编辑器悬停始终可以鼠标悬停，除非通过 editor.hover.sticky 设置另有指定。

设置编辑器改进

设置编辑器现在为特定于语言的设置显示默认值覆盖指示器。您可以通过在设置编辑器搜索栏中添加语言筛选器来查看特定于语言的设置，方法是显式键入 (@lang:javascript)，或者单击搜索栏右侧的筛选器按钮，然后选择语言选项。

当默认值覆盖指示器出现时，它表示特定于语言的设置的默认值已被扩展覆盖。指示器还指示哪个扩展覆盖了默认值。

主题：Light Pink

此迭代还修复了当设置编辑器搜索栏中已存在搜索查询时，设置编辑器中的某些链接未正确重定向的行为。链接现在也具有适当的样式，因此当鼠标悬停在链接上时会更清晰。

<video src="/assets/updates/1_68/settings-editor-working-links.mp4" autoplay loop controls muted title="在设置编辑器中搜索“font”一词后，并在目录中选择终端类别，设置 terminal.integrated.fontFamily 出现，其描述包含指向 editor.fontFamily 设置的链接。现在单击该链接会将您正确地带到该设置。">

主题：Light Pink

注释小部件主按钮

注释小部件对第一个（最右侧）操作使用主按钮颜色

Add Comment has the primary button color

终端

查找匹配背景色

上一个版本在终端中实现了查找，以在所有匹配项周围显示边框，但这只是一个临时解决方案，直到可以动态更改单元格的背景。当突出显示匹配项时，彩色背景现在是主题的默认设置，整体体验应与编辑器类似。

Find now uses the blue from the editor's find for the active match and the orange for highlights

如果您是采用了 terminal.findMatchBorder 或 terminal.findMatchHighlightBorder 的主题作者，我们建议迁移到 terminal.findMatchBackground 和 terminal.findMatchHighlightBackground，如果这更适合主题或有助于对比度。

对比度和最小对比度比率的改进

查找匹配背景工作增加了终端在背景色和前景色方面工作的灵活性。因此，围绕终端中的对比度进行了改进，使终端视觉效果更接近编辑器。此外，现在还有最小对比度比率功能，可以动态更改文本的前景色，以帮助提高可见性。

  • 如果未满足对比度，则亮度现在将朝另一个方向移动。例如，如果浅灰色背景上的深灰色文本的对比度未达到纯黑色 (#_000000)，则颜色也将尝试向白色移动，并将使用最符合所需对比度比率的值。

    Darker grey on lighter dark can now use a light foreground color if needed

  • 当 GPU 加速禁用并且支持不透明颜色时，选择现在绘制在文本下方。以前，这必须是部分透明的，并且会冲刷前景色。由于此更改，选择颜色现在使用与编辑器中相同的颜色。

    Foreground color are retained in selections

  • Nerd 字体符号现在应应用最小对比度比率，以与附近的文本融合，而 Powerline 符号和框图字符将不应用最小对比度比率，因为它们通常与没有任何前景色字符的反色单元格相邻。

    Powerlines no longer have odd colors between the colored sections

  • 主题现在可以指定一个固定的选择前景色，以在默认情况下在高对比度主题中使用。

    The dark high contrast theme now uses black as its selection foreground

  • 修复了多个错误，以使生成的前景色更正确。

提醒一下，如果您希望使用原始颜色，可以通过将 "terminal.integrated.minimumContrastRatio": 1 设置为禁用最小对比度比率。

任务

默认任务的 Glob 模式

默认生成和测试任务现在可以限定范围，仅当活动文件匹配文件名 glob 模式时才为“默认”

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "echo txt",
            "type": "shell",
            "command": "echo TextFile",
            "group": {
                "kind": "build",
                "isDefault": "**.txt" // This is a glob pattern which will only match when the active file has a .txt extension.
            }
        },
        {
            "label": "echo js",
            "type": "shell",
            "command": "echo JavascriptFile",
            "group": {
                "kind": "build",
                "isDefault": "**.js" // This is a glob pattern which will only match when the active file has a .js extension.
            },
        }
    ]
}

源代码管理

Git 扩展进行了一些更新，这些更新与我们新的拉取请求流程保持一致。

Git：分支前缀

为了使创建新分支的过程更顺畅，有一个新设置 git.branchPrefix，用于指定在创建新分支时用作前缀的字符串。

Git：分支名称生成

新设置 git.branchRandomName.enable 将使 VS Code 在每次创建新分支时建议随机分支名称。随机名称从字典生成，您可以通过 git.branchRandomName.dictionary 设置控制字典。支持的字典有：adjectives（默认）、animals（默认）、colors 和 numbers。

Git：分支保护

使用新的 git.branchProtection 设置，您可以配置要保护的特定分支。VS Code 将避免直接在受保护分支上提交，并将为您提供创建新分支以进行提交的机会。您可以使用 git.branchProtectionPrompt 设置微调此行为。

GitHub：拉取请求模板支持

GitHub 扩展现在了解拉取请求模板，并且每当从新创建的分支仓库创建 PR 时，都会将它们用作基础。

笔记本

单元格显示更改

我们调整了视口外的单元格在几种场景中的显示方式。

当您在轮廓视图中单击单元格时，如果该单元格在视口之外，笔记本现在将滚动以在视口顶部约 1/5 处显示该单元格。这与轮廓在文本编辑器中的行为相匹配。

当光标在单元格编辑器中时，您可以将光标移动到编辑器的第一行或最后一行之后，以将其移动到下一个单元格编辑器中。现在，当将光标移动到单元格超出视口的编辑器中时，笔记本将仅滚动到足以在编辑器中显示该行，而不是跳到中间显示单元格。

查找和替换支持从光标/选区播种查询

笔记本编辑器中的查找控件现在支持从编辑器选区播种搜索字符串。此行为由编辑器设置 editor.find.seedSearchStringFromSelection 控制。

调试

运行和调试，无需 launch.json

当您未设置 launch.json 配置文件并按 F5，或在调试视图中选择运行和调试按钮时，VS Code 会根据当前活动文件中的编程语言选择调试器。如果您没有打开文件，系统将询问您要使用哪个调试器。此体验可能会有点令人困惑，因此我们进行了一些改进。

Select debugger prompt before (alphabetical) and after (activated debugger at the top)

如果扩展在您尝试开始调试之前已激活，则该扩展的调试器将排序到顶部。这可能很有用，例如，当扩展先前通过运行该扩展中的命令、打开激活该扩展的语言文件或您的工作区匹配的 workspaceContains 模式激活时。如果您在本会话中使用过调试器，它也将排序到顶部。

Chrome/Edge 调试器已重命名为 Web 应用程序 (Chrome) 和 Web 应用程序 (Edge)，以尽量避免与其他调试器（如 Flutter 扩展）混淆，这些调试器也在浏览器中运行应用程序。

语言

TypeScript 4.7

VS Code 现在捆绑了 TypeScript 4.7.3。此主要 TypeScript 版本带来了新的语言功能，包括 改进的控制流分析 和对 Node.js 中的 ECMAScript 模块支持。它还包括新的工具功能并修复了许多重要的错误！

跳转到源定义

VS Code 最长期和最受投票的功能请求之一是使 VS Code 能够从外部库导航到函数和符号的 JavaScript 实现。目前，跳转到定义会跳转到定义目标函数或符号类型的类型定义文件（.d.ts 文件）。如果您需要检查这些符号的类型或文档，这很有用，但会隐藏代码的实际实现。当前行为也使许多可能不理解 .d.ts 中的 TypeScript 类型的 JavaScript 用户感到困惑。

虽然将跳转到定义更改为导航到符号的 JavaScript 实现听起来很简单，但此功能请求已开放这么长时间是有原因的。JavaScript（尤其是许多库附带的编译后的 JavaScript）比 .d.ts 更难分析。尝试分析 node_modules 下的所有 JavaScript 代码既缓慢又会大大增加内存使用量。VS Code IntelliSense 引擎也无法理解许多 JavaScript 模式。

这就是新的 跳转到源定义 命令的用武之地。当您从编辑器上下文菜单或命令面板运行此命令时，TypeScript 将尝试跟踪符号的 JavaScript 实现并导航到它。这可能需要几秒钟，并且我们可能并不总是获得正确的结果，但在许多情况下它应该很有用。

我们正在积极努力改进此功能，因此请在您的代码库中试用它并分享您的反馈。

对象方法代码片段

对象方法代码片段可帮助您快速将方法添加到实现给定接口的对象字面量

在对象字面量内部时，您应该看到每个可能方法的两个建议：一个仅插入方法名称，另一个插入方法的完整签名。您还可以通过设置 "typescript.suggest.classMemberSnippets.enabled": false 或 "javascript.suggest.classMemberSnippets.enabled": false 完全禁用对象方法代码片段。

组感知组织导入

JavaScript 和 TypeScript 的 组织导入 命令使您可以快速清理导入列表。运行时，它会删除未使用的导入，并按字母顺序对导入进行排序。

但是，某些代码库希望对其导入的组织方式进行一定程度的手动控制。对外部导入和内部导入进行分组是其中最常见的示例

// local code
import * as bbb from './bbb';
import * as ccc from './ccc';
import * as aaa from './aaa';

// built-ins
import * as path from 'path';
import * as child_process from 'child_process';
import * as fs from 'fs';

// some code...

在旧版本的 VS Code 中，在此处运行 组织导入 将导致以下结果

// local code
import * as child_process from 'child_process';
import * as fs from 'fs';
// built-ins
import * as path from 'path';
import * as aaa from './aaa';
import * as bbb from './bbb';
import * as ccc from './ccc';

// some code...

呸！发生这种情况是因为所有导入都按字母顺序排序，并且 VS Code 甚至尝试在执行此操作时保留注释和换行符。

但是，使用 TypeScript 4.7，组织导入现在是组感知的。在上面的代码上运行它看起来更符合您的预期

// local code
import * as aaa from './aaa';
import * as bbb from './bbb';
import * as ccc from './ccc';

// built-ins
import * as child_process from 'child_process';
import * as fs from 'fs';
import * as path from 'path';

// some code...

请注意，导入现在已排序，同时仍保留在其组内。好多了！

在隐式项目中启用严格的 Null 检查

严格的 Null 检查在 JavaScript 和 TypeScript 的隐式项目中默认启用。这应导致更准确的 IntelliSense 和改进的类型检查，可以捕获常见的编程错误。

A strict null error. getElementById may return null if no element with the ID exists

此新行为仅适用于不属于 jsconfig 或 tsconfig 项目的任何文件。您可以通过设置禁用它："js/ts.implicitProjectConfig.strictNullChecks": false。对于属于 jsconfig 或 tsconfig 的文件，您仍然需要在配置文件中启用严格的 Null 检查。

Markdown 引用链接的跳转到定义

您现在可以在 Markdown 文件中的引用链接上使用 跳转到定义。这将从引用跳转到当前文件中的链接定义。

扩展的 JSON 架构支持

内置的 JSON 语言服务改进了对 JSON 架构草案 2019-09 和 JSON 架构草案 2020-12 的支持。当使用此类架构时，不再显示警告。

仍有一些功能未完全支持。当架构使用它们时，会显示警告。不支持的属性是

  • 带有 $id 的子架构
  • $recursiveRef/Anchor (草案 2019-09)
  • $dynamicRef/Anchor (草案 2020-12)

Web 版 VS Code

核心本地化支持

我们为 Web 版 VS Code 引入了初始本地化支持。VS Code 在世界各地使用，对于许多用户来说，英语不是他们的第一语言（或他们熟悉的语言！）。多年来，VS Code 用户一直在安装 Marketplace 中的语言包，以便使用英语以外的语言使用 VS Code。对于 Web 版 VS Code，我们决定采用不同的方法，这种方法更符合当今 Web 的工作方式。

对于将其浏览器设置为我们核心支持的语言之一的用户，vscode.dev 将自动应用该语言的翻译。我们在 vscode-loc 存储库中记录了我们支持的语言。

例如，要在 Microsoft Edge 中配置显示语言，您可以使用设置 > 语言

Microsoft Edge Settings Languages page

设置完成后，当您转到 vscode.dev（或 insiders.vscode.dev）时，它将以德语显示

vscode.dev in a browser displayed in German

主题：Panda Theme

在接下来的几个月中，我们将为扩展（包括 VS Code 附带的扩展和未附带的扩展）启用本地化，以便扩展作者也可以支持非英语使用者。敬请期待！

远程仓库

当使用 远程仓库 > 继续在...上工作 命令在本地克隆 GitHub 或 Azure Repos 仓库并在桌面版 VS Code 中打开它时，您现在可以配置 remoteHub.gitProtocol 以始终使用 http 或 ssh URL 进行克隆。

开发容器规范

我们在 Microsoft 和 GitHub 的开发容器团队继续积极开发新的 Dev Container Specification，并且此迭代有几个令人兴奋的亮点。

参考实现

我们发布了一个开源命令行界面 (CLI) 作为规范的参考实现。CLI 从 devcontainer.json 构建并启动开发容器，它可以直接使用，也可以集成到产品体验中。

CLI 在新的 devcontainers/cli 存储库中可用。您可以学习如何在 README 中开始使用它，并在 博客文章中阅读更多内容。

CLI 正在积极开发中，并将继续发展以更好地支持更多场景，例如更好地支持个人用户。我们很乐意听到您一路走来的反馈，因此我们打开了一个问题专门用于 CLI 的反馈，并欢迎在仓库中提出其他问题和 PR。

CI 中的开发容器

GitHub Action 和 Azure DevOps Task 可用于在持续集成 (CI) 构建中运行仓库的开发容器。这允许您重用用于本地开发的相同设置，以在 CI 中构建和测试您的代码。有关更多详细信息，请参阅 devcontainers/ci README。

GitHub Action 的示例用法

- name: Build and run dev container task
  uses: devcontainers/[email protected]
  with:
    imageName: ghcr.io/example/example-devcontainer
    runCmd: make ci-build

Azure DevOps Task 的示例用法

- task: DevcontainersCI@0
  inputs:
    imageName: 'yourregistry.azurecr.io/example-dev-container'
    runCmd: 'make ci-build'
    sourceBranchFilterForPush: refs/heads/main

规范

规范的积极开发仍在继续，我们已经在 devcontainers/spec 存储库中发布了初始版本。

与 CLI 一样，请继续关注更多更新和进展，我们很乐意听到您的反馈。

进一步阅读

您可以在 https://containers.dev 上阅读有关开发容器和规范的所有信息。

扩展贡献

Python

启动时没有解释器发现

Python 扩展现在仅在以下情况下自动触发发现

  • 使用 Python：选择解释器命令选择不同的解释器。
  • 特定范围（工作区或全局）首次打开。
  • 未安装 Python。

由于发现不会在启动时自动触发，因此这会导致即时加载，并加快语言服务器等其他功能的启动速度。但是，如果安装/启用了 Jupyter 扩展，则发现仍由 Jupyter 在启动时触发。

启用本地化

Python 扩展现在支持 VS Code 支持的所有语言的翻译。我们更新了获取命令、通知、标题等翻译的方式，使用了 vscode-nls。这些翻译由本地化团队维护，以确保它们是最新的和正确的。

Jupyter

Web 扩展

我们在 Web 版 Jupyter 扩展中支持更多核心功能方面取得了进展。

本月，以下功能已移植到 Web 扩展

  • https 支持
  • 内核补全
  • ipywidgets
  • 笔记本调试
  • 变量查看
  • 导出
  • 交互窗口

如果您想试用该功能，请从本地计算机启动 Jupyter，并使用

jupyter notebook --no-browser --NotebookApp.allow_origin_pat=https://.*\.vscode-cdn\.net

然后使用 vscode.dev 中的命令 Jupyter：指定 Jupyter 服务器以进行连接 连接到它。

有关更多信息（和评论），请参阅此讨论 项目。

远程开发

在 远程开发扩展方面继续工作，这使您可以使用容器、远程计算机或 适用于 Linux 的 Windows 子系统 (WSL) 作为功能齐全的开发环境。

您可以在 远程开发发行说明中了解有关新扩展功能和错误修复的信息。

GitHub Pull Requests and Issues

在 GitHub Pull Requests and Issues 扩展方面取得了更多进展，该扩展允许您处理、创建和管理拉取请求和问题。此版本的亮点包括

  • 创建拉取请求视图中的自动合并复选框

查看扩展的 0.44.0 版本的变更日志，了解其他亮点。

远程仓库扩展

GitHub 仓库和 Azure Repos 扩展都支持 VS Code 支持的所有语言的翻译。

预览功能

Markdown 链接验证

在使用 Markdown 时，很容易错误地添加无效的文件链接或图像引用。也许您忘记了文件名使用了 -（短划线）而不是 _（下划线），或者您链接到的文件已移动到其他目录。通常，您只有在查看 Markdown 预览甚至发布后才会发现这些错误。VS Code 新的实验性 Markdown 链接验证可以帮助捕获这些错误。

通过链接验证，VS Code 将分析 Markdown 链接到标题、图像和其他本地文件。无效链接将报告为警告或错误。

A warning shown in the editor when linking to a file that does not exist

VS Code 甚至可以捕获指向其他 Markdown 文件中特定标题的无效链接！

链接验证默认情况下处于关闭状态。您可以通过设置 "markdown.experimental.validate.enabled": true 来尝试链接验证。

您可以使用一些设置来自定义链接验证

  • markdown.experimental.validate.fileLinks.enabled - 启用/禁用本地文件链接的验证：[link](/path/to/file.md)

  • markdown.experimental.validate.headerLinks.enabled - 启用/禁用当前文件中标题链接的验证：[link](#_some-header)

  • markdown.experimental.validate.referenceLinks.enabled - 启用/禁用引用链接的验证：[link][ref]。

  • markdown.experimental.validate.ignoreLinks - 跳过验证的链接列表。如果您链接到磁盘上不存在的文件，但在 Markdown 发布后存在，这将非常有用。

请告知我们您对新功能的看法！

粘贴文件以插入 Markdown 链接

我们添加了实验性支持，用于粘贴以在 Markdown 中插入图像或文件链接。

这需要同时启用 markdown.experimental.editor.pasteLinks.enabled 和 "editor.experimental.pasteActions.enabled"。您当前可以从 VS Code 文件资源管理器复制文件。粘贴图像文件会插入图像引用，而粘贴普通文本文件会插入指向这些文件的链接。

终端 Shell 集成

Shell 集成（使用 terminal.integrated.shellIntegration.enabled 设置启用）和命令装饰在此迭代中得到了改进和完善。

一些更新包括

  • 146377 持久化 Shell 状态，以便 bash-git-prompt 和其他程序可以工作
  • 148635 允许为 zsh 使用自定义 ZDOTDIR
  • 145801 修复在较慢的机器上装饰不同步的问题
  • 146873 改进 bash 中现有调试陷阱的处理
  • 148839 使用 这是如何工作的？ 命令和选项卡悬停中的激活状态改进消息传递
  • 151223 清除缓冲区后，确保正确跟踪命令

Windows 上的窗口控件叠加

我们采用了 Electron 提供的 API，以支持 Windows 上的 Window Controls Overlay（窗口控件叠加层）。此项更改面向用户的主要好处是能够访问 Windows 11 中的 Snap Layouts（贴靠布局） 功能。由于一些 持续存在的问题，窗口控件叠加层默认处于关闭状态，但您可以使用实验性设置 window.experimental.windowControlsOverlay.enabled 将其打开。

Hover over the maximize/restore window control to see Windows 11 Snap layouts

命令中心

我们正在添加命令中心 - 一种更简单的方式来触发文件、命令等的快速选择 (Quick Pick)。

Command Center in the VS Code title bar

可以通过 window.experimental.commandCenter 设置启用此功能，并请告知您的想法。

合并编辑器

我们已经开始致力于改进合并体验。目前仍处于早期阶段，我们尚未准备好征求反馈，但您可以通过 git.experimental.mergeEditor 尝试使用它。启用此功能后，具有合并冲突的文件将在新的合并编辑器中打开，以简化冲突解决。

我们将继续致力于此。使用 Insiders 版本以关注我们的进展。我们衷心感谢 Mingpan 以及我们在 Google 的朋友们为此付出的努力。❤️

扩展创作

内联补全最终确定

我们已经最终确定了内联补全 API。这允许扩展提供与建议小部件解耦的内联补全。内联补全的渲染效果如同已被接受，但颜色为灰色。用户可以使用 Tab 键循环浏览建议并接受它们。使用内联补全的一个扩展示例是 GitHub Copilot。更多信息可以在 vscode.d.ts 文件中找到，API 的入口点是 languages.registerInlineCompletionItemProvider。

InputBox 验证消息严重性最终确定

我们的 InputBox API（通过 window.showInputBox 和 window.createInputBox）用于在用户输入验证中提供严重性的功能已最终确定。

例如，如果您想根据用户的输入向用户显示信息消息，您的验证消息可以返回

{
  message: 'this is an info message';
  severity: InputBoxValidationSeverity.Info;
}

这将看起来像这样

Input box with 'this is an info message' severity message

Notebook Editor API

新的 notebook 编辑器 API 引入了一种新的 NotebookEditor 类型，它类似于 TextEditor，但用于 notebooks（笔记本） 而不是普通的文本编辑器。

const editor = vscode.window.activeNotebookEditor;
if (editor) {
  // Access the underlying notebook document associated with the editor
  console.log(editor.notebook.uri);

  // Change the selection in the current notebook
  editor.selection = new vscode.NotebookRange(1, 3);
}

您可以使用 window.activeNotebookEditor 获取当前的 notebook 编辑器，并使用诸如 window.onDidChangeActiveNotebookEditor 之类的事件来观察用户何时切换到新的 notebook 编辑器。

基于时间线视图的扩展激活

当时间线视图可见时，已添加新的激活事件。任何扩展都可以使用此事件 onView:timeline，但对于实现建议的 Timeline API 的扩展程序最为有用。

UX 指南

扩展作者的 UX 指南 已更新和扩展，以涵盖更多 VS Code 用户界面元素。

UX Guideline example image pointing to View Actions elements

修订后的 概述 页面逐步浏览 VS Code UI，以提供界面和常用 UI 元素的视觉导览。

相关指南、API 参考和扩展示例的链接已添加到每个区域的专用页面。此外，所有示例图像已在整个指南中更新，以展示最新版本的 UI。

您现在可以阅读有关扩展添加到或贡献以下 UI 元素的推荐“应该做”和“不应该做”

扩展赞助

在此里程碑中，我们在扩展的 package.json 中引入了 sponsor 字段，以允许扩展选择加入赞助。 sponsor 对象具有 url 字段，用于扩展作者的赞助链接。例如

"sponsor": {
    "url": "https://github.com/sponsors/nvaccess"
}

如果扩展选择加入此功能，VS Code 将在“扩展”视图的“详细信息”页面中渲染一个 Sponsor（赞助） 按钮，如上面的 Sponsoring extensions（赞助扩展） 部分所示。

注意： 确保使用最新的 vsce 命令行工具 (>=2.9.1) 发布已启用赞助的扩展。

提议的 API

每个里程碑都附带新的建议 API，扩展作者可以试用它们。与往常一样，我们希望收到您的反馈。以下是试用建议 API 的步骤

  1. 查找您想要尝试的提案，并将其名称添加到 package.json#enabledApiProposals。
  2. 使用最新的 vscode-dts 并运行 vscode-dts dev。它会将相应的 d.ts 文件下载到您的工作区。
  3. 您现在可以针对该提案进行编程。

您不能发布使用建议 API 的扩展。下一个版本中可能会有破坏性更改，我们绝不希望破坏现有扩展。

从 DataTransfer 读取文件

新的 dataTransferFiles API 提案允许扩展从 vscode.DataTransfer 对象读取文件。 DataTransfer 类型由树拖放 API 以及拖放到编辑器和复制粘贴 API 提案使用。

export class TestViewDragAndDrop implements vscode.TreeDataProvider<Node>, vscode.TreeDragAndDropController<Node> {

  ...

   public async handleDrop(target: Node | undefined, sources: vscode.DataTransfer, token: vscode.CancellationToken): Promise<void> {

     // Get a list of all files
     const files: vscode.DataTransferFile[] = [];
     sources.forEach((item) => {
       const file = item.asFile();
       if (file) {
         files.push(file);
       }
     });

    const decoder = new TextDecoder();

    // Print out the names and first 100 characters of the file
     for (const file of files) {
       const data = await file.data();
       const text = decoder.decode(data);
       const fileContentsPreview = text.slice(0, 100);
       console.log(file.name + ' — ' + fileContentsPreview + '\n');
     }

    ...
  }
}

文件数据传输项目前仅在它们来自 VS Code 外部时才添加到 DataTransfer 中（例如，当您从桌面拖放到树视图或编辑器中时）。

复制粘贴 API

新的 documentPaste API 提案允许扩展挂钩到文本编辑器内的复制和粘贴操作。这可以用于修改粘贴时插入的文本。您的扩展还可以在复制文本时存储元数据，并在粘贴时使用此元数据（例如，在两个代码文件之间粘贴时引入导入）。

文档粘贴扩展示例 展示了此 API 的实际应用

/**
 * Provider that maintains a count of the number of times it has copied text.
 */
class CopyCountPasteEditProvider implements vscode.DocumentPasteEditProvider {
  private readonly countMimeTypes = 'application/vnd.code.copydemo-copy-count';

  private count = 0;

  prepareDocumentPaste(
    _document: vscode.TextDocument,
    _range: vscode.Range,
    dataTransfer: vscode.DataTransfer,
    _token: vscode.CancellationToken
  ): void | Thenable<void> {
    dataTransfer.set(this.countMimeTypes, new vscode.DataTransferItem(this.count++));
  }

  async provideDocumentPasteEdits(
    _document: vscode.TextDocument,
    range: vscode.Range,
    dataTransfer: vscode.DataTransfer,
    token: vscode.CancellationToken
  ) {
    const countDataTransferItem = dataTransfer.get(this.countMimeTypes);
    if (!countDataTransferItem) {
      return undefined;
    }

    const textDataTransferItem = dataTransfer.get('text/plain') ?? dataTransfer.get('text');
    if (!textDataTransferItem) {
      return undefined;
    }

    const count = await countDataTransferItem.asString();
    const text = await textDataTransferItem.asString();

    // Build a snippet to insert
    const snippet = new vscode.SnippetString();
    snippet.appendText(`(copy #${count}) ${text}`);

    return new vscode.SnippetTextEdit(range, snippet);
  }
}

vscode.languages.registerDocumentPasteEditProvider(
  { language: 'markdown' },
  new CopyCountPasteEditProvider()
);

新的 Notebook Workspace 编辑提案

新的 notebookWorkspaceEdit API 提案允许扩展编辑 notebook 的内容。它取代了之前的 notebookEditorEdit 提案。

使用此提案，您可以创建工作区编辑，以在 notebook 中插入、替换或修改单元格

const currentNotebook = vscode.window.activeNotebookEditor?.notebook;
if (currentNotebook) {
  const edit = new vscode.WorkspaceEdit();

  edit.set(
    currentNotebook.uri,
    vscode.NotebookEdit.insertCells(/* index*/ 1, [
      // ... new notebook cell data
    ])
  );

  await vscode.workspace.applyEdit(edit);
}

工程

使用拉取请求

我们已不再直接将更改推送到 vscode 存储库的 main 分支，现在完全使用拉取请求 (PR) 将所有更改推送到 VS Code。我们要求每个 PR 至少获得另一位团队成员的批准。利用这一点，我们现在还要求在 PR 可以合并之前通过一些基本检查。这些任务包括 TypeScript 编译、格式化规则、单元测试和集成测试，通常不会超过 10 分钟。切换到此流程减少了我们的 Insiders 版本因编程错误而损坏的次数。

VS Code OSS 构建

我们有一个新的公共 Code OSS 构建，它重用了与我们的生产构建相同的构建定义。此构建现在在每个 PR 上运行时间不到 30 分钟，我们计划继续投入以加快其速度。

文档

更新的版本控制视频

将 Git 与 Visual Studio 结合使用 入门视频已重新制作，以帮助您开始使用内置于 VS Code 中的 Git 集成。

您还可以在 VS Code YouTube 频道上找到其他精彩视频。

vscode.dev 在 code.visualstudio.com 上

想使用 VS Code for Web 但忘记了 URL？ vscode.dev 现在突出显示在 VS Code 下载 页面上，以便您可以快速启动在浏览器中运行的 VS Code。

vscode.dev on the code.visualstudio.com download page

值得注意的修复

  • 141157 在非调试模式下单击 F11 会开启调试而不是进入全屏
  • 148864 TypeScript 文件的不绑定断点
  • 149638 惰性变量求值按钮导致节点之间出现有问题的间隙和错位

感谢

最后但同样重要的是，衷心感谢 VS Code 的贡献者。

Web 扩展

扩展作者启用作为 Web 扩展 运行代码的扩展（以下列表为 2022 年 5 月 2 日至 6 月 6 日期间）

Issue tracking

问题跟踪的贡献

Pull requests

对 vscode 的贡献

对 vscode-extension-samples 的贡献

对 vscode-generator-code 的贡献

对 vscode-html-languageservice 的贡献

对 vscode-js-debug 的贡献

对 vscode-languageserver-node 的贡献

对 vscode-pull-request-github 的贡献

  • @jpspringall: Issue #3371 | 更新了 GitHub Enterprise AuthProvider 情况下的 getAuthSessionOptions PR #3565

对 debug-adapter-protocol 的贡献

对 language-server-protocol 的贡献