@EnabledIfSystemProperty 是 JUnit 5.7+ 的条件注解，仅根据 JVM 系统属性（-Dkey=value）启用测试，不支持 OS 环境变量；支持精确匹配、正则匹配及存在性判断，可作用于方法或类。
@EnabledIfSystemProperty 是 JUnit 5.7+ 引入的条件化测试启用注解，用于根据 JVM 系统属性（不是操作系统环境变量）的值来决定是否运行某个测试类或方法。注意：它**不直接读取 OS 环境变量（如 ENV=prod）**，而是读取通过 -Dkey=value 启动参数传入的 JVM 系统属性。
一、正确理解 @EnabledIfSystemProperty 的作用范围
该注解只检查 JVM 系统属性（即 System.getProperty("key")），例如：
-
-Denv=test→ 可用@EnabledIfSystemProperty(named = "env", matches = "test") -
-Dos.name=Windows→ 可匹配系统名（但不推荐依赖此做跨平台逻辑） - 它 不能 读取
System.getenv("PATH")或System.getenv("CI")这类 OS 环境变量
二、基本用法：按系统属性开关单个测试方法
在测试方法上添加注解，指定属性名和匹配规则：
@Test
@EnabledIfSystemProperty(named = "run.integration", matches = "true")
void shouldRunOnlyWhenIntegrationFlagIsTrue() {
// 集成测试逻辑
}启动时需加 JVM 参数：java -Drun.integration=true ...
立即学习“Java免费学习笔记（深入）”；
三、支持多种匹配方式
除了精确匹配字符串，还可使用正则表达式：
-
matches = "dev|staging"→ 匹配 dev 或 staging -
matches = ".*ci.*"→ 忽略大小写匹配含 ci 的值（注意正则中需转义点号） - 若只需属性存在（不关心值），可用
matches = ".*"或更清晰地用@EnabledIfSystemProperty(named = "debug")（JUnit 默认当属性非 null 即满足）
四、在测试类上批量控制
加在类上可让整个类的测试都受控：
@EnabledIfSystemProperty(named = "profile", matches = "integration")
class DatabaseIntegrationTests {
@Test void testConnection() { /* ... */ }
@Test void testDataLoad() { /* ... */ }
}运行时传参：-Dprofile=integration，否则整个类跳过。
如果确实需要基于 OS 环境变量（如 CI=true 或 ENV=prod）控制测试，应改用 @EnabledIf 配合自定义条件类，例如：
@EnabledIf("isCiEnvironment")
@Test
void runsOnlyOnCi() { ... }
<p>static boolean isCiEnvironment() {
return "true".equalsIgnoreCase(System.getenv("CI"));
}不复杂但容易忽略
