运行/调试配置：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 只会在使用模块的类路径字段中选择的模块中查找测试。跨模块依赖 – 与上一选项相同，加上依赖于该模块的模块。类——运行测试类。在类字段中，输入您要运行的测试类的完全限定名。方法——运行测试方法。
输出目录	测试报告生成的目录。

条目

描述

测试种类

软件包中的所有 – 运行包中的所有测试。在软件包字段中，指定包的完全限定名。
模式：运行一组测试类或测试类中的特定方法。此集合可能包含位于相同或不同目录、包或模块中的类。声明必须用 || 分隔。
此字段中的每个类必须由其完全限定名称表示：
- 包括包名和类名
- 将 , 用作方法的分隔符
- 将 $ 用作内部类的分隔符
您可以手动输入类名，或者点击（或按 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` 选项将覆盖模块的 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 任务对话框中，请指定定义所需任务的 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年 4月 24日