@Disabled 注解用于跳过测试方法或类的执行，支持原因说明，JUnit 5.4+ 支持类级禁用，替代 JUnit 4 的 @Ignore；动态禁用推荐使用 @DisabledIf 或 @EnabledIf。

在 JUnit 5 中，使用 @Disabled 注解可以轻松跳过某个测试方法的执行，既不运行也不报错，常用于临时禁用尚未完成、环境依赖或已知失败的测试。

基本用法：直接标注测试方法

只需在待忽略的测试方法上添加 @Disabled，JUnit 运行时会自动跳过它，并在测试报告中标记为“disabled”：

• 注解可写在 @Test 方法上，不能放在类上（类级别禁用需用 @Disabled 在类声明处，但仅适用于 JUnit 5.4+）
• 支持添加可选原因说明，便于团队理解为何禁用：@Disabled("暂未实现登录逻辑")
• 被禁用的方法仍会被识别为测试方法，只是不执行；IDE 和构建工具（如 Maven）都会显示其状态

禁用整个测试类

若想跳过整个测试类的所有方法，可将 @Disabled 放在类定义上方：

@Disabled("集成环境不可用，跳过全部测试")
class PaymentServiceTest {
    @Test void testCharge() { /* ... */ }
    @Test void testRefund() { /* ... */ }
}

注意：该方式从 JUnit 5.4 开始正式支持，旧版本可能不识别类级 @Disabled。

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

立即学习“Java免费学习笔记（深入）”；

结合条件禁用（更灵活的替代方案）

如果禁用逻辑依赖环境（如只在 CI 环境跳过），@Disabled 不够动态。此时推荐使用 @EnabledIf 或 @DisabledIf 配合表达式或方法判断：

• @DisabledIf("isLocalEnvironment") —— 调用静态方法返回 boolean
• @EnabledIf(systemProperty = "env", matches = "prod") —— 按系统属性控制
• 这类注解需要配合 org.junit.jupiter.api.condition 包，比单纯 @Disabled 更适合自动化场景

与 @Ignore 的区别（JUnit 4 用户注意）

JUnit 4 的 @Ignore 在 JUnit 5 中已被弃用，统一替换为 @Disabled：

• @Ignore 在 JUnit 5 中仍能编译，但会触发警告，且部分工具可能不识别
• @Disabled 是官方推荐方式，语义更清晰，报告中显示一致
• 迁移时只需全局替换 @Ignore → @Disabled，无需改逻辑