🚀 在 VS Code 中

测试

Visual Studio Code 提供了一套丰富的功能来测试你的代码。你可以自动发现项目中的测试,运行和调试测试,并获得测试覆盖率结果。VS Code 中的 GitHub Copilot 可以协助为你的项目设置测试框架,并帮助你生成测试代码和修复失败的测试。

在本文中,你将学习如何在 VS Code 中开始进行测试,查找常用的测试扩展,并探索测试功能。你还将了解 VS Code 中的 Copilot 如何帮助你更快地编写测试,并帮助你修复失败的测试。

提示

如果你还没有 Copilot 订阅,请注册 Copilot 免费计划,免费使用 Copilot。你将获得每月有限的补全和聊天互动次数。

关于 VS Code 中的测试

VS Code 中的测试支持是特定于语言的,并且取决于你安装的测试扩展。语言扩展或独立扩展可以为特定语言或测试框架实现测试功能。

VS Code 具有以下用于测试代码的功能

  • 支持多种测试框架:语言扩展和独立的测试扩展为各种语言和测试运行程序提供支持,例如 Jest、Mocha、Pytest、JUnit 等。

  • 集中式测试管理测试资源管理器提供了一个集中的位置来管理和运行项目中的测试。根据测试扩展,测试资源管理器可能会自动发现项目中的测试。

  • 集成的测试结果:在编辑器中与测试代码一起内联查看测试状态,或在测试资源管理器中查看所有测试。详细的测试结果可在“测试结果”面板中查看。

  • 调试调试你的测试以诊断测试失败。利用 VS Code 中丰富的调试支持,例如断点、监视变量等。

  • 测试覆盖率运行带有覆盖率的测试,以查看你的代码有多少被测试覆盖。

  • AI 辅助测试:使用 VS Code 中的 GitHub Copilot 来帮助你设置测试框架、生成测试代码和修复失败的测试。

  • 任务集成:通过创建任务来运行测试,使你的测试工作更轻松。你还可以在更改代码时在后台运行测试。

VS Code 中测试入门

要开始在 VS Code 中进行测试,请按照以下步骤操作

  1. 打开扩展视图并为你的项目安装测试扩展。按测试类别 (@category:"testing") 过滤扩展。

  2. 选择活动栏中的烧杯图标 () 以打开测试资源管理器并发现项目中的测试。

  3. 从测试资源管理器或直接从编辑器运行和调试测试。

用于测试的扩展

你可以在Visual Studio Marketplace中找到支持测试的扩展。你也可以转到扩展视图 (⇧⌘X (Windows, Linux Ctrl+Shift+X)),并按测试类别进行过滤。

提示

Copilot 可以协助设置测试框架并建议相关的测试扩展。打开聊天视图 (⌃⌘I (Windows, Linux Ctrl+Alt+I)),输入 /setupTests 命令,Copilot 将指导你完成配置项目的过程。

测试视图中的自动测试发现

“测试”视图提供了一个集中的位置来管理和运行测试。你可以通过选择活动栏中的烧杯图标 () 来访问“测试”视图。你也可以在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用测试: 聚焦于测试资源管理器视图命令。

如果你的项目包含测试,“测试资源管理器”视图将发现并列出工作区中的测试。默认情况下,发现的测试在“测试资源管理器”中以树视图显示。树视图与测试的层次结构匹配,使你可以轻松导航和运行测试。

Screenshot that shows VS Code with the Test Explorer showing the tests, matching the test code that is shown in the editor.

你可以通过选择播放按钮从测试资源管理器运行测试。在运行和调试测试部分中了解有关运行和调试测试的更多信息。

提示

通过双击“测试资源管理器”视图中的测试,导航到测试代码。如果选择失败的测试,编辑器将打开测试文件,突出显示失败的测试,并显示错误消息。

如果你的测试很多,可以使用筛选选项快速找到你感兴趣的测试。你可以使用筛选器按钮按状态筛选测试,或仅显示当前文件的测试。你还可以使用搜索框按名称搜索特定测试,或使用 @ 符号按状态搜索。

Test Explorer view with filtering options

更多操作菜单中,你可以访问更多功能,例如排序和显示选项。

如果你添加了新测试或更改了测试,请使用刷新测试按钮刷新测试资源管理器中的测试列表。你也可以在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用测试资源管理器: 重新加载测试命令。

注意

根据测试扩展,你可能首先需要配置测试框架或测试运行程序,以发现项目中的测试。有关更多信息,请查阅测试扩展的文档。你可以使用 Copilot 聊天视图中的 setupTests 命令来获得有关为你的项目设置测试框架的帮助。

使用 AI 编写测试

编写测试可能很耗时,并且它们经常被忽略。Copilot 可以通过为你的应用程序创建测试代码来加速编写测试的过程。你可以使用它来编写单元测试、集成测试、端到端测试等等。

要在 VS Code 中使用 Copilot 编写测试,你可以使用以下任一方法

  • 编辑器智能操作

    1. (可选)选择一个应用程序代码块

    2. 在编辑器中右键单击,然后选择 Copilot > 生成测试

  • 聊天提示

    1. 打开你想要为其生成测试的应用程序代码文件

    2. 打开 Copilot 编辑 (⇧⌘I (Windows Ctrl+Shift+I, Linux Ctrl+Shift+Alt+I))、聊天视图 (⌃⌘I (Windows, Linux Ctrl+Alt+I)) 或编辑器内联聊天 (⌘I (Windows, Linux Ctrl+I))

    3. 输入提示以生成测试,例如为此代码生成测试。还包括边缘情况的测试。

      通过在提示中键入 #file,向你的提示添加额外的上下文。例如,为此代码生成测试 #file:calculator.js

      提示

      在 GitHub Copilot 文档中获取更多生成单元测试模拟对象端到端测试的示例提示。

Copilot 将为你的应用程序代码生成测试用例代码。如果你已经有一个测试文件,Copilot 将在那里添加测试,或者在需要时创建一个新文件。你可以通过向 Copilot 提供更多提示来进一步自定义生成的测试。例如,你可以要求 Copilot 使用另一个测试框架。

提示

你可以给 Copilot 你自己的生成代码的特殊说明。例如,你可以告诉 Copilot 使用特定的测试框架、命名约定或代码结构。

了解更多关于在 VS Code 中使用 Copilot的信息。

运行和调试测试

在发现项目中的测试后,你可以直接在 VS Code 中运行和调试测试,并查看测试结果。

在测试资源管理器中,使用节标题中的控件来运行或调试所有测试。你也可以通过选择特定节点上的运行/调试图标来运行或调试树视图中的特定测试。

Run and debug tests in Test Explorer

当你在编辑器中查看测试代码时,使用编辑器装订线中的播放控件来运行该位置的测试。

Run and debug tests in editor gutter

右键单击装订线控件以查看其他操作,例如调试测试。

提示

通过使用testing.defaultGutterClickAction 设置,配置装订线控件的默认测试操作。

运行一个或多个测试后,编辑器装订线和测试资源管理器中的树视图将显示相应的测试状态(通过/失败)。当测试失败时,请注意测试错误消息将作为叠加层显示在编辑器中。

Screenshot that shows a test error message overlay in the editor.

使用测试资源管理器中的显示输出按钮,在测试结果面板中查看测试输出。

Test Results panel

提示

Copilot 可以帮助你修复失败的测试。在测试资源管理器中,将鼠标悬停在树视图上,然后选择修复测试失败按钮 (sparkle),Copilot 将为失败的测试建议修复方案。或者,在 Copilot 聊天中输入 /fixTestFailure 命令。

Screenshot showing the Test Explorer, highlighting the "Fix Test Failure" button, and the editor that shows a suggestion from Copilot on how to fix the failing test.

测试覆盖率

测试覆盖率衡量你的代码中有多少被测试覆盖。它可以帮助你识别代码中未被测试覆盖的区域。如果相应的测试扩展支持测试覆盖率,则 VS Code 支持运行带有覆盖率的测试并查看覆盖率结果。

你可以运行带有覆盖率的测试,就像你可以运行和调试测试一样。使用测试资源管理器视图、编辑器装订线或命令面板中的相应操作 (⇧⌘P (Windows, Linux Ctrl+Shift+P))。

Run tests with coverage

运行带有覆盖率的测试后,你可以在不同的位置查看覆盖率结果

  • 在“测试覆盖率”视图中

    树视图显示测试及其覆盖率百分比。颜色指示器还提供了有关覆盖率百分比的视觉提示。将鼠标悬停在每一行上以查看有关覆盖率结果的更多详细信息。

    Test Coverage view

  • 作为编辑器中的叠加层

    对于具有测试覆盖率的代码文件,编辑器在装订线中显示颜色叠加层,以指示哪些行被测试覆盖或未被测试覆盖。当你将鼠标悬停在装订线上时,请注意,对于覆盖的行,还有一个指示器指示该行已执行的次数。你也可以选择编辑器标题栏中的显示内联覆盖率按钮,或使用测试: 显示内联覆盖率命令 (⌘; ⇧⌘I (Windows, Linux Ctrl+; Ctrl+Shift+I)) 来切换覆盖率叠加层。

    View coverage in editor

  • 在资源管理器视图中,该视图显示你的代码文件的覆盖率百分比

    资源管理器视图显示你的代码文件的覆盖率百分比。将鼠标悬停在资源管理器中的文件或节点上,以查看有关覆盖率结果的更多详细信息。

    View coverage in Explorer view

  • 在差异编辑器中

    如果你打开了差异编辑器,覆盖率结果也会显示在差异编辑器中,类似于它们在编辑器中的显示方式。

任务集成

VS Code 中的任务可以配置为在 VS Code 中运行脚本和启动进程,而无需输入命令行或编写新代码。在 VS Code 中,你可以定义一个运行测试的默认测试任务,并可以选择创建键盘快捷键来运行测试。

使用命令任务: 配置默认测试任务来配置默认测试任务。VS Code 尝试自动检测测试任务,例如基于你的 package.json 文件。选择默认测试任务后,将打开 tasks.json 文件供你自定义任务。

以下代码片段显示了一个 tasks.json 文件,该文件将 node --test 命令指定为默认测试任务。

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "npm",
      "script": "test",
      "group": {
        "kind": "test",
        "isDefault": true
      },
      "problemMatcher": [],
      "label": "npm: test",
      "detail": "node --test src/tests/**.js"
    }
  ]
}

要运行测试任务,请使用命令任务: 运行测试任务或为该命令创建键盘快捷键

了解更多关于使用和配置任务的信息。

注意

目前,任务尚未与 VS Code 的测试功能进行特殊集成,因此在任务中运行测试不会更新用户界面。各个测试扩展可以提供集成到 UI 中的特定测试自动化功能。

测试配置设置

你可以配置多个设置来自定义 VS Code 中的测试体验。每个语言扩展都可能提供特定于该语言中测试的其他设置。以下是一些你可以配置的常见设置

设置 ID 详细信息
testing.countBadge 控制活动栏上“测试”图标上的计数徽章
testing.gutterEnabled 配置是否在编辑器装订线中显示测试控件
testing.defaultGutterClickAction 配置选择装订线测试控件时的默认操作
testing.coverageBarThresholds 为“测试覆盖率”视图配置覆盖率条阈值的颜色
testing.displayedCoveragePercent 配置在“测试覆盖率”视图中显示的百分比值(总计、语句或最小值)
testing.showCoverageInExplorer 配置是否在资源管理器视图中显示覆盖率百分比

你可以在“设置”编辑器 (⌘, (Windows, Linux Ctrl+,)) 中找到所有与测试相关的设置。

后续步骤