Java逻辑运算符仅有&&、||、!，专用于boolean类型且具短路特性；&、|、^是位运算符，无短路性，误用易致NPE或副作用；!优先级高于&&，复杂表达式需加括号明确逻辑。
Java里逻辑运算符就三个：&&（逻辑与）、||（逻辑或）、!（逻辑非），它们只作用于布尔值（boolean），结果也一定是 true 或 false。别把 &、|、^ 当成逻辑运算符用——那是位运算符，虽然也能用于布尔值，但没短路特性，且语义不同。
为什么 && 和 || 不能随便替换成 & 和 |
关键在「短路求值」：一旦能确定整个表达式的结果，就跳过后续计算。这不只是性能优化，更是避免空指针、越界或副作用的刚需。
-
str != null && str.length() > 5：如果str是null，&&不会执行str.length()，安全；换成&就直接抛NullPointerException -
list != null && !list.isEmpty() && list.get(0) > 0：前两个条件不满足时，第三个根本不会触发；用&会强制执行全部，风险陡增 -
isValid() || saveToDB()：若isValid()返回true，saveToDB()根本不调用——这常用于“兜底操作”，换成|就变成每次都执行，可能误写库
! 的优先级比 && 高，但容易被忽略
写 !a && b 没问题，等价于 (!a) && b；但写 !a == b 就危险了——! 只作用于 a，不是整个 a == b。这种错误在权限校验、状态翻转逻辑里高频出现。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- ❌ 错误写法：
if (!user.isActive == true)→ 实际是if ((!user.isActive) == true)，虽能运行但可读性差、易误解 - ✅ 推荐写法：
if (!user.isActive)或if (user.isActive == false)，语义清晰无歧义 - ⚠️ 复杂组合务必加括号：
if (!(a > 0 && b 比 <code>if (!a > 0 && b （语法错误）或 <code>if (!a > 0 && b （逻辑错）更安全
实际开发中哪些场景最依赖逻辑运算符的特性
不是所有 if 都需要嵌套，合理用 &&/|| 能让代码扁平、可读、易测。
立即学习“Java免费学习笔记（深入）”；
-
参数校验：
if (id > 0 && name != null && !name.trim().isEmpty())—— 一个表达式完成三重守门 -
缓存穿透防护：
if (cache == null || cache.isExpired()) { loadFromDB(); }—— 利用||短路避免重复加载 -
多条件过滤（Stream）：
list.stream().filter(item -> item.price > 100 && item.inStock && !item.isDeleted()).toList() -
避免 NPE 的链式判空：
if (order != null && order.getUser() != null && order.getUser().getAddress() != null)—— 虽然 Lombok 的@NonNull或 Optional 更优，但这是最直白的保底方案
真正容易出问题的，从来不是记不住 && 表示“且”，而是忘了它会在前半句为 false 时彻底跳过后面——这个“跳过”，既是保护伞，也是隐藏的执行路径盲区。调试时如果某段代码“莫名没执行”，先盯住它前面的 && 或 || 条件。
