assert是开发阶段验证内部逻辑正确性的轻量级工具，需手动启用（-ea），适用于检查“理论上绝不该发生”的状态，不可替代业务校验或单元测试。

Java 的 assert 断言不是用来“调试”的，而是用于开发阶段辅助验证程序逻辑正确性的轻量级检查工具；它默认不启用，需手动开启才能生效。

什么时候该用 assert

assert 适合检查那些「理论上绝不该发生」的内部状态，比如：

• 私有方法参数的非法值（公有方法应抛 IllegalArgumentException）
• 循环不变式、算法中间状态（如二分查找中 left ≤ right）
• switch 分支覆盖了所有枚举值后，default 中加 assert false
• 私有工具类中“不可能为空”的引用，如 assert obj != null;

⚠️ 注意：不能用 assert 替代业务校验，也不能依赖它做关键逻辑控制或资源清理——JVM 关闭断言后这些代码直接跳过。

如何启用 assert 并在 IDE 中调试

Java 默认禁用 assert，必须显式开启。常见方式：

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

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 运行时加 JVM 参数：-ea（enable assertions），全局启用；-ea:com.example... 启用指定包
• IDEA 中：右键运行配置 → Modify Options → Add VM options → 输入 -ea
• Eclipse：Run Configurations → Arguments → VM arguments 栏填入 -ea

启用后，若断言失败（表达式为 false），会抛出 AssertionError，堆栈指向 assert 行。你可以在该行设断点，配合 Debug 模式单步观察变量值，确认为何条件不成立。

写法建议与避坑点

推荐写法更清晰、易诊断：

• 带提示消息：assert count > 0 : "count 应为正数，实际=" + count;
• 避免副作用：assert doSomething() : "不要在这里调用方法" —— 因为断言关闭后 doSomething() 不执行，可能引发逻辑差异
• 不要在 public 方法入口用 assert 校验参数，应改用 Objects.requireNonNull() 或手动 throw
• 测试代码（如 JUnit）里通常不用 assert，而用 assertEquals 等断言方法，它们始终生效且提供更好报错信息

和日志/单元测试的关系

assert 是开发期“自文档化 + 快速拦截”的补充手段，不是替代方案：

• 日志（如 SLF4J）用于记录运行时行为，可长期开启；assert 只在开发/测试环境启用
• 单元测试覆盖各种输入路径，是主动验证；assert 是被动守门，防止低级逻辑错误逃逸到后续代码
• 两者结合：写完一个私有方法，先加 assert 做即时防护，再写对应单元测试保证行为稳定

用对了，assert 能帮你早几秒发现 bug；用错了，它只是段被忽略的注释。