testng.xml 是 testng 的核心调度入口，必须包含 根节点及至少一个 和 ；需显式声明全限定类名，支持分组、并行、参数化等工程级控制。
testng.xml 是 TestNG 框架用来定义测试套件（suite）、测试组（test）、类（class）和方法（method）执行顺序与配置的 XML 配置文件。它不是可选的“辅助工具”，而是 TestNG 执行测试的**核心调度入口**——不写 testng.xml，你就只能靠 IDE 或命令行硬指定单个类运行，无法做分组、依赖、并行、参数化等工程级控制。
testng.xml 的基本结构怎么写
一个最小可用的 testng.xml 必须包含 <suite></suite> 根节点，并至少嵌套一个 <test></test> 和若干 <classes></classes>。TestNG 不会自动扫描包或类，所有要运行的测试类都必须显式声明。
<?xml version="1.0" encoding="UTF-8"?>
<suite name="SmokeSuite">
<test name="LoginTests">
<classes>
<class name="com.example.tests.LoginTest"/>
<class name="com.example.tests.PasswordResetTest"/>
</classes>
</test>
</suite>
-
name属性是必需的，用于识别套件/测试，在报告和日志中直接可见 -
class name必须是全限定类名（含包路径），拼错或漏包会导致org.testng.TestNGException: Cannot find class - 多个
<test></test>块会按 XML 中出现顺序串行执行，不是并行
用 groups 属性实现测试分类与筛选
TestNG 的 @Test(groups = {"smoke", "api"}) 注解配合 <groups></groups> 节点，才能真正按业务维度组织测试。只加注解不配 XML，mvn test -Dgroups=smoke 也不会生效。
<suite name="RegressionSuite">
<test name="API_Smoke">
<groups>
<run>
<include name="smoke"/>
<include name="api"/>
</run>
</groups>
<classes>
<class name="com.example.api.UserApiTest"/>
<class name="com.example.api.OrderApiTest"/>
</classes>
</test>
</suite>
-
<include></include>表示只运行带这些 group 的方法；<exclude></exclude>可排除特定 group（如跳过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"/>
</classes>
</test>
</suite>
-
parallel="methods"：每个@Test方法独立线程，最常用但要求方法间无共享状态 -
parallel="tests"：每个<test></test>块独立线程，适合隔离环境（如不同浏览器、不同 DB 实例） -
thread-count是总线程数，不是每个 test 单独分配——设为 10 但只有 2 个<test></test>，最多只启 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里配置<suitexmlfiles></suitexmlfiles>或执行mvn test -DsuiteXmlFile=testng.xml - XML 文件名必须是
testng.xml（大小写敏感），放在src/test/resources/或项目根目录才容易被识别 - XML 语法错误（如未闭合标签、属性值没加引号）会导致 TestNG 静默失败，控制台只显示
Failed to create suite，需检查日志细节
真正要用好 testng.xml，关键不是写得多复杂，而是清楚每处配置在哪个执行链路下起作用——IDE、Maven、命令行、CI 脚本，它们加载 XML 的机制完全不同。
