IntelliJ IDEA 2025.2 Help

运行/调试配置：TestNG

TestNG 运行/调试配置用于启动符合 TestNG 框架的测试。 对话框包含多个选项卡。

常见选项

名称(N)

在编辑或运行时，指定运行配置的名称以便快速识别。

允许多个实例(U)

允许并行运行此运行配置的多个实例。

默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置，IntelliJ IDEA 建议停止正在运行的实例并启动另一个。 当一个运行配置消耗大量资源且没有充分理由运行多个实例时，这会很有帮助。

存储为项目文件(S)

将运行配置设置的文件保存下来，与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是，如果您不想共享 .idea 目录，您可以将配置保存到项目内的任何其他目录。

默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

配置选项卡

此选项卡的组成取决于选择的测试范围：包、项目等。

条目

描述

测试种类

  • 软件包中的所有 – 运行包中的所有测试。 在 软件包 字段中，指定包的完全限定名。

  • 模式 ：运行一组测试类或测试类中的特定方法。 此集合可能包含位于相同或不同目录、包或模块中的类。 声明必须用 || 分隔。

    此字段中的每个类必须由其完全限定名称表示：

    • 包括包名和类名

    • 将 , 用作方法的分隔符

    • 将 $ 用作内部类的分隔符

    您可以手动输入类名，或者点击 "添加"按钮 （或按 Shift+Enter ），并在打开的对话框中搜索您想要添加的类。

    示例： packageName.ClassName$InnerClassName,methodName

    您也可以使用 正则表达式指定所需的类。

    例如，如果您想排除名称中包含 IT 的所有集成测试，请输入 ^(?!.*IT.*).*$。

    您可以创建一个套件测试，即多个测试类的集合，并将它们一起运行。 创建套件测试类，请点击 展开按钮 并键入您希望作为套件运行的测试类。 因此，将使用 @Suite 注释创建一个新类。

  • 分组 – 运行测试组。 在 分组 字段中，指定您想要运行的组。

  • 套餐 – 运行测试套件。 在 套餐 字段中，输入对应的 testng.xml 文件。

    • 在整个项目中—— IDE 将在所有模块中查找测试

    • 在单个模块中 — IDE 只会在 使用模块的类路径 字段中选择的模块中查找测试。

    • 跨模块依赖 – 与上一选项相同，加上依赖于该模块的模块。

  • 类——运行测试类。 在 类 字段中，输入您要运行的测试类的完全限定名。

  • 方法——运行测试方法。

输出目录

测试报告生成的目录。

JDK 设置

条目

描述

虚拟机选项(V)

指定启动应用程序时传递给 Java 虚拟机的选项，例如， -mx、 -verbose 等。

在指定 JVM 选项时，请遵循以下规则：

  • 使用空格来分隔各个选项。

  • 如果选项的值包含空格，请用双引号括起值或实际空格。

  • 如果选项的值中包含双引号，请使用反斜杠对双引号进行转义。

  • 您可以将环境变量值传递给自定义 Java 属性。

-Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}

在此字段中使用代码补全：开始输入标志的名称，IDE 会建议可用的命令行选项列表。 这适用于 -XX: 和 -X 选项以及一些未由IntelliJ IDEA自动配置的标准选项，如 -ea ，但不适用于 -cp 或 –release。

此字段中指定的 -classpath 选项将重写模块的类路径。

测试运行参数

传递给测试运行器的参数。

请使用与指定 VM options 相同的规则。

工作目录(W)

指定用于运行应用程序的工作目录。 这个目录是所有相对输入和输出路径的起点。 默认情况下，工作目录是项目根目录。

环境变量(E)

点击 浏览按钮 以打开 环境变量 对话框，在这里您可以创建变量并指定其值。

使用模块路径

此选项适用于具有 JPMS 模块（Java 9 及更高版本）的项目。 您可以选择如何运行测试：在类上运行还是在模块路径上运行。

JRE

要使用的 JRE。

缩短命令行

选择一种方法来缩短命令行，如果 classpath 太长，或者您有许多超过操作系统命令行长度限制的 VM 参数。 选项的选择取决于类加载器的实现。 请注意，一些框架不支持 JAR manifest ，而其他具有自定义类加载器的框架则无法很好地与 classpath.file 选项一起工作。

  • 无 ：IntelliJ IDEA 不会缩短长类路径。 如果命令行超过操作系统的限制，IntelliJ IDEA 将无法运行您的应用程序，并会显示一条消息，建议您指定缩短方法。

  • JAR 清单 ：IntelliJ IDEA 将通过一个临时 classpath.jar 传递一个长 classpath。 原始 classpath 是在 清单 文件中作为 class-path 属性在 classpath.jar 中定义的。 请注意，如果使用此方法缩短了命令行，您将能够预览完整的命令行，而不仅仅是临时 classpath.jar 的类路径。

  • classpath.file ：IntelliJ IDEA 将把一个长 classpath 写入文本文件。

  • @argFiles (Java 9+) ：可以使用 @argument files option 解决命令行长度限制问题。

参数

条目

描述

参数

属性文件

请指定 .属性 文件传递给 TestNG。

名称 - 数值

作为键值对的附加参数。

侦听器

 

使用这些图标来创建一个监听器列表。

代码覆盖率选项卡

使用此选项卡配置 代码覆盖率监控选项。

条目

描述

要包含在覆盖数据中的包和类

点击 "添加"按钮 并选择 添加类按钮添加类 或 “ 添加包按钮 ”添加软件包 以指定要测量的类和包。 您还可以通过在列表中选择类和包，然后点击 删除这个包 按钮从列表中删除它们。

要从覆盖率数据中排除的包和类

点击 "添加"按钮 并选择 添加类按钮添加类 或 “ 添加包按钮 ”添加软件包 来指定不应当被测量的类和包。 您还可以通过在列表中选择类和包，然后点击 删除这个包 按钮从列表中删除它们。

日志

以下选项与记录此配置的执行相关。 有关更多信息，请参见 日志。

条目

描述

将显示在控制台中的日志文件

指定在运行应用程序时显示哪些日志文件。

点击 "添加"按钮 添加新的日志。 在 编辑日志文件别名 对话框中，配置以下内容：

  • 别名(A) ：日志将显示在该选项卡中。

  • 日志文件位置(L) ：指定日志文件或 Ant pattern的路径。 如果滚动日志的多个文件匹配模式，IntelliJ IDEA 将显示最新的那个。

  • 显示可由模式覆盖的所有文件(S) ：显示与模式匹配的所有日志。

对于表中的日志，您可以配置以下选项：

  • 处于活动状态 ：显示指定的日志文件。

  • 跳过内容 ：不显示先前运行中的旧日志消息。

将控制台输出保存到文件(S)

将控制台输出保存到指定位置。 请手动输入路径或点击浏览按钮，并在打开的 对话框中指定所需位置。

在消息打印到标准输出流时显示控制台

当应用程序写入标准输出流时激活控制台.

在消息打印到标准错误流时显示控制台

当应用程序写入标准错误流时激活控制台.

启动前

在此区域，您可以指定在启动所选的运行/调试配置之前需要执行的任务。 任务将按其在列表中出现的顺序执行。

条目

描述

添加启动前任务

启用此选项以添加以下可用任务之一：

  • 启动Web 浏览器 ：选择此选项以启动浏览器。 在打开的对话框中，选择浏览器类型并提供起始 URL。 此外，请指定是否希望使用 JavaScript 调试器启动浏览器。

  • 运行外部工具 ：运行一个外部应用程序。 在打开的对话框中，选择您想要运行的一个或多个应用程序。 如果它在 IntelliJ IDEA 中尚未定义，请添加其定义。 更多信息请参阅 外部工具。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再启动当前配置。 如果您想并行运行多个配置，请使用 compound run/debug configuration。

  • 运行远程外部工具 ：添加一个 远程 SSH 外部工具。

  • 运行Gradle 任务 ：运行一个 Gradle task。 在打开的对话框中，指定任务并在必要时提供附加配置。

  • 构建 ：选择编译指定的模块。 构建模块 操作将被执行。

    如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。

  • 构建项目 ：选择编译整个项目。 构建项目操作将被执行。

    如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。

  • 构建，无错误检查 ：与 构建 选项相同，但 IntelliJ IDEA 将会尝试启动运行/调试配置，而不考虑编译结果。

  • 编译Artifacts ：选择此选项以构建一个或多个 构件。 在打开的对话框中，选择应构建的 artifact。

  • 运行Maven 目标 ：选择此选项以 运行一个 Maven 目标。 在打开的对话框中，选择要运行的目标。

  • 运行Grunt 任务 ：选择此选项以运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。

  • 运行gulp 任务 ：选择此选项以运行 Gulp 任务。

    在打开的 Gulp task 对话框中，请指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 gulp 包的路径。

  • 运行npm 脚本 ：选择此选项以执行 npm script。

    在打开的 NPM 脚本 对话框中，指定 npm 运行/调试配置设置。

  • 编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除 检查错误 复选框，以配置在检测到任何错误时编译器的行为：

    • 如果选中 检查错误 复选框，编译器将显示所有错误，运行配置将不会启动。

    • 如果取消选中 检查错误 复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。

  • 断开数据源 ：如果您希望在运行/调试配置运行之前中断与数据源的连接，请选择此选项。

激活工具窗口

根据配置类型，在启动此 run configuration 时打开 运行、 调试或 服务工具窗口。 如果此选项被禁用，您可以手动打开工具窗口：

  • 视图(V) | 工具窗口 | 运行 或 Alt+4

  • 视图(V) | 工具窗口 | 调试 或 Alt+5

  • 视图(V) | 工具窗口 | 服务 或 Alt+8

使工具窗口获得焦点

当测试运行时，将重点放在运行配置工具窗口上。

显示此页面

在实际启动之前显示运行配置设置。

2025年 9月 22日
TestNG开始使用 Spock