testng.xml 是 TestNG 的核心调度入口，必须包含 根节点及至少一个 和 ；需显式声明全限定类名，支持分组、并行、参数化等工程级控制。
testng.xml 是 TestNG 框架用来定义测试套件（suite）、测试组（test）、类（class）和方法（method）执行顺序与配置的 XML 配置文件。它不是可选的“辅助工具”，而是 TestNG 执行测试的**核心调度入口**——不写 testng.xml，你就只能靠 IDE 或命令行硬指定单个类运行，无法做分组、依赖、并行、参数化等工程级控制。
testng.xml 的基本结构怎么写
一个最小可用的 testng.xml 必须包含
<?xml version="1.0" encoding="UTF-8"?><suite name="SmokeSuite"><test name="LoginTests"><classes><class name="com.example.tests.LoginTest"></class><class name="com.example.tests.PasswordResetTest"></class></classes></test></suite>
-
name属性是必需的，用于识别套件/测试，在报告和日志中直接可见 -
class name必须是全限定类名（含包路径），拼错或漏包会导致org.testng.TestNGException: Cannot find class - 多个
用 groups 属性实现测试分类与筛选
TestNG 的 @Test(groups = {"smoke", "api"}) 注解配合 mvn test -Dgroups=smoke 也不会生效。
<suite name="RegressionSuite"><test name="API_Smoke"><groups><run><include name="smoke"></include><include name="api"></include></run></groups><classes><class name="com.example.api.UserApiTest"></class><class name="com.example.api.OrderApiTest"></class></classes></test></suite>
-
flaky） - 同一方法属于多个 group（如
@Test(groups={"smoke","login"})），只要任一被 include 就会执行 - Maven 命令行优先级高于 XML：如果同时在 XML 里 include
smoke，又执行mvn test -Dgroups=regression，则只跑regression组
parallel 和 thread-count 控制并发行为
TestNG 的并行粒度由 parallel 属性决定，不是简单开多线程就能加速——设错会导致线程竞争、状态污染甚至测试失败。
<suite name="ParallelSuite" parallel="methods" thread-count="4"><test name="ConcurrentTests"><classes><class name="com.example.tests.ConcurrentTest"></class></classes></test></suite>
-
parallel="methods"：每个@Test方法独立线程，最常用但要求方法间无共享状态 -
parallel="tests"：每个 -
thread-count是总线程数，不是每个 test 单独分配——设为 10 但只有 2 个 - 若测试类里用了
static变量或单例对象，parallel="methods"很可能出错
常见坑：为什么 testng.xml 写了但没生效
绝大多数“配置无效”问题都源于执行方式不匹配。TestNG 只认两种入口：IDE 运行时明确选中 testng.xml，或 Maven/Gradle 显式调用它。
- IDE 中右键单击 Java 类 → Run As → TestNG Test：**不会读取 testng.xml**，只运行该类
- Maven 默认执行
src/test/java/**/*Test.java，除非你在pom.xml里配置mvn test -DsuiteXmlFile=testng.xml - XML 文件名必须是
testng.xml（大小写敏感），放在src/test/resources/或项目根目录才容易被识别 - XML 语法错误（如未闭合标签、属性值没加引号）会导致 TestNG 静默失败，控制台只显示
Failed to create suite，需检查日志细节
真正要用好 testng.xml，关键不是写得多复杂，而是清楚每处配置在哪个执行链路下起作用——IDE、Maven、命令行、CI 脚本，它们加载 XML 的机制完全不同。
