Java中使用@ParameterizedTest编写参数化测试需搭配JUnit 5参数源（如@ValueSource、@CsvSource、@MethodSource），通过junit-jupiter依赖实现多组数据驱动同一逻辑，支持单参、多参及复杂对象供给，并可自定义测试名称提升可读性。
在 Java 中使用 @ParameterizedTest 编写参数化单元测试，核心是搭配 JUnit 5 提供的参数源（如 @ValueSource、@CsvSource、@MethodSource 等），让同一个测试逻辑自动运行多组输入和预期结果，避免重复写多个相似的 @Test 方法。
添加依赖（确保使用 JUnit 5）
确认项目中已引入 JUnit 5 的必要模块：
-
junit-jupiter（包含@ParameterizedTest和基础断言） - 若用
@MethodSource引用外部方法，无需额外依赖；若用@CsvFileSource或自定义参数源，可能需要junit-jupiter-params（但该模块在 JUnit 5.9+ 已合并进junit-jupiter，一般不用单独引）
Maven 示例：
<dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter</artifactId> <version>5.10.2</version> <scope>test</scope> </dependency>
基本写法：用 @ValueSource 传简单值
适合测试单个参数的多种取值，比如验证一个工具方法对不同字符串的处理：
立即学习“Java免费学习笔记（深入）”；
@ParameterizedTest
@ValueSource(strings = {"hello", "world", ""})
void shouldReturnStringLength(String input) {
assertEquals(input.length(), StringUtils.length(input));
}
JUnit 会为数组中每个字符串执行一次该方法，分别传入 "hello"、"world"、""。
多参数组合：用 @CsvSource 或 @CsvFileSource
当需要同时传入输入值和期望输出时，@CsvSource 更直观：
@ParameterizedTest
@CsvSource({
"1, 2, 3",
"0, 0, 0",
"-1, 1, 0"
})
void shouldAddTwoNumbers(int a, int b, int expected) {
assertEquals(expected, Calculator.add(a, b));
}
每行 CSV 对应一次调用：第一列赋给 a，第二列给 b，第三列给 expected。支持类型自动转换（int、boolean、String 等）。
如果数据较多，可把 CSV 写在外部文件中，用 @CsvFileSource(resources = "/add-tests.csv") 加载。
复用复杂对象：用 @MethodSource 自定义参数供给器
适用于需要构造对象、调用数据库或读配置等较重逻辑的场景：
@ParameterizedTest
@MethodSource("provideValidEmails")
void shouldValidateEmail(String email) {
assertTrue(EmailValidator.isValid(email));
}
static Stream<String> provideValidEmails() {
return Stream.of("a@b.c", "test@example.org", "user+tag@domain.co.uk");
}
注意：@MethodSource 引用的方法必须是 static，返回类型需为 Stream、Collection、Iterable、Iterator 或数组。若要传多个参数的对象，可返回 Stream<arguments></arguments>：
static Stream<Arguments> provideLoginScenarios() {
return Stream.of(
Arguments.of("admin", "123", true),
Arguments.of("guest", "wrong", false)
);
}
@ParameterizedTest
@MethodSource("provideLoginScenarios")
void shouldAuthenticateUser(String username, String password, boolean expected) {
assertEquals(expected, AuthService.login(username, password));
}
补充技巧：命名测试实例、自定义显示名
默认情况下，JUnit 显示类似 [1] hello 这样的名称。可通过 name 属性提升可读性：
@ParameterizedTest(name = "{index}: \"{0}\" -> length {1}")
@CsvSource({
"hello, 5",
"Java, 4",
", 0"
})
void shouldReturnStringLength(String input, int expectedLength) {
assertEquals(expectedLength, input.length());
}
其中 {0} 表示第一个参数，{1} 表示第二个，{index} 是从 1 开始的序号。
