junit 5 参数化测试需用 @parameterizedtest 注解，配合 @valuesource（单类型多值，支持 strings/ints 等，不支持 null/空串）或 @csvsource（多参数组合，支持自定义分隔符与转义），且必须引入 junit-jupiter-params 依赖。
JUnit 5 的参数化测试通过 @ParameterizedTest 注解启用，配合 @ValueSource 或 @CsvSource 可以高效复用同一测试逻辑，验证多组输入。关键前提是项目已引入 junit-jupiter-params 依赖。
使用 @ValueSource 提供单类型参数
@ValueSource 适用于单一参数、多种取值的场景，比如字符串、数字、布尔值或 Class 类型。它只支持基本类型和 String、Class，不支持 null 或空字符串（需改用 @NullSource 或 @EmptySource）。
- 必须搭配
@ParameterizedTest使用，不能与@Test共存，否则会重复执行 - 参数类型需与方法形参严格匹配，例如
strings = {"a", "b"}对应String s - 支持的数组类型包括：
strings、ints、longs、booleans、classes等
示例：
@ParameterizedTest
@ValueSource(strings = {"hello", "world", "junit"})
void testStringLength(String input) {
assertTrue(input.length() > 0);
}
使用 @CsvSource 提供多参数组合
@CsvSource 适合多个参数协同变化的用例，如“用户名 + 预期年龄 + 是否合法”这类组合校验。每组双引号内的 CSV 字段按逗号分隔，自动映射到方法参数列表。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
- 默认分隔符是英文逗号
,；若字段含逗号，可用双引号包裹（JUnit 自动解析） - 可自定义分隔符，用
delimiterString = "|"指定竖线等符号 - 支持转义：双引号内用两个双引号表示一个字面双引号，如
"a""b"→a"b - 空值写成
""，null 值需显式写null并配合@NullSource或使用@CsvFileSource
示例：
@ParameterizedTest
@CsvSource({"张三, 25, true", "李四, 17, false", "王五, 30, true"})
void testAdultCheck(String name, int age, boolean expected) {
assertEquals(expected, age >= 18);
}
常见注意事项与补充技巧
实际编写时容易忽略几个细节：
- 测试方法必须是
public，且不能有返回值（void） - 参数顺序必须与数据源中字段顺序完全一致，类型也要兼容（如
"123"可自动转为int，但"abc"转int会报错） - 大量数据建议迁移到 CSV 文件，用
@CsvFileSource(resources = "/users.csv")管理，避免注解臃肿 - 需要测试 null 或空值时，
@ValueSource不支持，应组合@NullSource、@EmptySource或改用@MethodSource
配套依赖不能少
Maven 中需明确添加参数化模块：
<dependency><groupid>org.junit.jupiter</groupid><artifactid>junit-jupiter-params</artifactid><scope>test</scope></dependency>
缺少该依赖会导致编译通过但运行时报 NoClassDefFoundError: org.junit.jupiter.params.ParameterizedTest。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
