@EnabledOnOs 是 JUnit 5 的条件注解，仅在指定操作系统（如 WINDOWS、LINUX、MAC）上运行测试方法或类，不匹配则跳过；支持多系统“或”组合，不可“与”，类级注解不影响 @BeforeAll/@AfterAll。
@EnabledOnOs 是 JUnit 5 提供的条件性测试启用注解，用于**仅在指定操作系统上运行测试方法或类**，从而实现跨平台差异化测试——比如 Windows 上执行路径校验，Linux 上验证权限脚本，macOS 上跳过不兼容的 GUI 操作。
明确支持的操作系统类型
该注解通过 OS 枚举值限定运行环境，可用值包括：
- WINDOWS（匹配 Windows 10/11、Windows Server 等）
- LINUX（匹配所有 Linux 发行版，内核识别为准）
-
MAC（对应 macOS，注意不是
MAC_OS_X或其他变体） - AIX、FREEBSD、UNKNOWN（较少使用）
JUnit 依据 System.getProperty("os.name") 的返回值做精确匹配，例如 "Mac OS X" → MAC，"Linux" → LINUX，大小写不敏感但字符串需整体吻合。
单个测试方法的平台限定
直接在测试方法上添加注解即可控制执行范围：
立即学习“Java免费学习笔记（深入）”；
NodeMaven – Premium Proxies for Account Management, Automation, and Scraping
下载
提供端到端的高端代理设置和使用指导，包括代理类型选择、地区定向、访问配置、API密钥验证和监控。
@Test
@EnabledOnOs(OS.WINDOWS)
void testWindowsOnlyRegistryAccess() {
// 只在 Windows 上运行：调用 Windows 注册表 API
assertTrue(RegistryUtil.isAvailable());
}
若当前系统不满足条件，该测试会自动跳过（显示为 SKIPPED），不会报错也不会执行方法体。
整个测试类的平台约束
加在类级别时，类中所有 @Test 方法都受限制：
@EnabledOnOs(OS.LINUX)
class LinuxFilePermissionTest {
@Test
void testChmodCommand() {
// 仅 Linux 执行 chmod 测试
assertEquals(0, runCommand("chmod", "755", "test.sh"));
}
@Test
void testSymbolicLink() {
// 同样只在 Linux 生效
assertTrue(Files.isSymbolicLink(Paths.get("/tmp/link")));
}
}
注意：类级注解不影响 @BeforeAll / @AfterAll 静态方法，它们仍会在所有平台执行（除非单独加注解）。
组合多个操作系统条件
用 @EnabledOnOs({OS.WINDOWS, OS.MAC}) 表示“Windows 或 macOS”，满足任一即运行；不能用逻辑“与”（比如同时是 Windows 和 macOS 不可能）。若需排除某系统，改用 @DisabledOnOs 更清晰：
-
@EnabledOnOs({OS.WINDOWS, OS.MAC})→ Windows 或 macOS 运行 -
@DisabledOnOs(OS.WINDOWS)→ 非 Windows 时运行（等价于 Linux + macOS + 其他）
避免混用 @EnabledOnOs 和 @DisabledOnOs 在同一目标上，行为未定义。
