junit 5 中 @parameterizedtest 实现参数化测试，核心是“一个方法、多组数据、多次执行”，支持 @valuesource（基础类型）、@csvsource（多字段组合）、@methodsource（复杂动态数据）三种数据源，并可通过 name 属性自定义测试名称提升可读性。
JUnit 5 中用 @ParameterizedTest 实现参数化测试，核心是“一个方法、多组数据、多次执行”。它不再需要 JUnit 4 那样的 @RunWith(Parameterized.class)，结构更清晰，扩展性更强。关键在于选择合适的数据源注解，并确保方法签名与数据类型严格匹配。
基础类型数据：用 @ValueSource
适合测试字符串、数字、布尔值等简单类型。每组值单独触发一次测试执行：
- 必须配合
@ParameterizedTest使用，不能和@Test混用 - 方法参数类型要和
@ValueSource指定的类型一致（如ints对应int） - 支持
strings、ints、doubles、booleans、classes等内置类型
示例：
@ValueSource(strings = {"hello", "world", ""})
void shouldNotBeEmpty(String input) {
assertFalse(input.isEmpty());
}
多字段组合数据：用 @CsvSource
当需要同时传入输入值和期望结果时最常用，比如“输入 → 期望输出”配对：
- 每行 CSV 是一个测试用例，字段用逗号分隔，支持引号包裹含逗号的值
- 方法参数个数、类型、顺序必须与每行字段一一对应
- 可用
nullValues = "null"将字符串"null"映射为 Javanull
示例：
@ParameterizedTest@CsvSource({
"1, 2, 3",
"0, 0, 0",
"-1, 1, 0"
})
void addReturnsCorrectSum(int a, int b, int expected) {
assertEquals(expected, Calculator.add(a, b));
}
复杂或动态数据：用 @MethodSource
适用于构造对象、读取外部配置、生成随机数据或复用已有数据集合：
- 被引用的方法必须是
static，返回Stream<arguments></arguments>、Iterable<arguments></arguments>或数组 - 用
Arguments.of(...)打包多个参数成一组 - 可结合工厂方法、JSON 解析、数据库查询等方式灵活组织数据
示例：
@ParameterizedTest@MethodSource("validInputs")
void testWithCustomObjects(User user, boolean isActive) {
assertTrue(user.isValid());
assertEquals(isActive, user.isActive());
}
static Stream
return Stream.of(
Arguments.of(new User("alice"), true),
Arguments.of(new User("bob"), false)
);
}
增强可读性：自定义测试名称
默认显示为 [1] arg1=xxx, arg2=yyy，可通过 name 属性优化：
-
{index}表示执行序号（从 1 开始） -
{0}、{1}等表示第几个参数，按方法参数顺序编号 - 建议使用中文或语义化命名，便于快速定位失败用例
示例：
@ParameterizedTest(name = "验证正整数 {0} 是否为偶数")@ValueSource(ints = {2, 4, 6, 8})
void testEvenNumber(int value) {
assertEquals(0, value % 2);
}
