# 在 Gradle 中测试

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

在 Gradle 项目中，您可以像在任何其他项目中一样 [创建](create-tests.html) 和 [运行](performing-tests.html) 测试。

IntelliJ IDEA 还允许您 [更改默认测试运行器](gradle-settings.html#gradle_tests) 用于您的测试过程，甚至可以为每个测试配置测试运行器。

Procedure: 配置测试运行器

1. 在   Gradle  工具窗口中，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)以打开 [Gradle 设置](gradle-settings.html#gradle_tests)页面。

2. 在   使用运行测试   列表中，为选定的 Gradle 项目选择以下测试运行程序选项之一：

* Gradle ：IntelliJ IDEA 默认使用 Gradle 作为测试运行器。 最终，您会在持续集成（CI）服务器上获得相同的测试结果。 此外，在命令行中运行的测试始终会在 IDE 中运行。

* %instance% ：选择此选项以将测试过程委托给 IntelliJ IDEA。 在这种情况下，IntelliJ IDEA 使用 [JUnit](https://junit.org/junit5/docs/current/user-guide/#overview-what-is-junit-5) 测试运行器，并且由于增量编译，测试运行得更快。

* 按测试选择 ：选择此选项可配置每个测试所使用的测试运行程序（Gradle 或 IntelliJ IDEA）。

![Gradle 设置：运行测试使用列表](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_test_runner.png)

3. 点击   OK  。

Procedure: 运行 Gradle 测试

1. 在 您的 Gradle 项目中，在编辑器中， [创建](create-tests.html)或选择一个测试来运行。

2. 在上下文菜单中，选择   运行 <test name>  。

或者，点击左侧边栏中的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg)图标。

![运行测试](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_run_test_gutter.png)

如果您选择了 [Choose per test](#choose_per_test)选项，IntelliJ IDEA将在编辑器中显示每个测试的 Gradle 和 JUnit 测试运行器。

![按测试选择](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_choose_per_test.png)

> **Note:**
> 一旦您选择了测试运行器，IntelliJ IDEA 将记住您的选择，并自动使用您选择的选项运行测试。 如果您想要再次提供这两个选项，请删除为测试创建的 run configuration。

如果您想在运行测试时查看代码覆盖率，请选择   以覆盖率运行 'name()'  选项。 它适用于 IntelliJ IDEA 和 Gradle 测试运行器。

![测试覆盖率报告](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_test_coverage.png)

3. IntelliJ IDEA 使用配置的 [测试运行器](#test_runner)运行测试，并在   运行  工具窗口的 [测试选项卡](viewing-and-exploring-test-results.html)中显示输出。

![使用工具窗口 / 使用 Gradle 运行测试](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_test_runner_output.png)

如果您使用 [Gradle 测试运行器](#gradle_test_runner) 运行测试，则各种 Gradle 测试选项（包括并行执行测试）将会保留。 有关详细信息，请参阅 [Gradle 文档](https://docs.gradle.org/current/userguide/performance.html#a_run_tests_in_parallel)。

您还可以生成 Gradle 测试报告 ![打开 Gradle 测试报告](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.gradleNavigate.svg) 并运行 [内部 Gradle 测试套件](#internal_gradle_testsuits)。

Procedure: 调试 Gradle tests

1. 在编辑器中的 Gradle 项目中，创建或选择您要调试的测试。

2. 在上下文菜单中，选择   调试 <test name>  。

![调试测试](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-gradle.html)中的   调试 Gradle 脚本  选项，并禁用 Gradle 脚本中的断点。 这样做是为了加快调试过程。 您可以通过添加或删除   调试 Gradle 脚本  选项手动启用或禁用 Gradle 脚本中的断点。

有关调试的更多信息，请参阅 [Gradle debugging](work-with-gradle-tasks.html#debug_gradle)章节。

Procedure: 运行内部 Gradle 测试套件

有时，在多模块项目中，您可能希望查看有关 Gradle 内部测试套件的信息。 例如，当测试并行运行时，您可以让 IntelliJ IDEA 显示有关测试过程的信息。 IntelliJ IDEA 还显示了这些进程中有多少是同时工作的。

1. 在   运行   工具窗口中，点击 ![更多按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg)，选择   测试运行程序设置  ，然后选择   显示内部 Gradle 测试套件  。

![运行工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_internal_testuSuites.png)

2. 重新运行测试以查看包含 Gradle 内部测试结果的测试结果。