当前位置：首页 > 文章列表 > 文章 > java教程 > Apache Commons Lang3 StringUtils判空与使用教程

Apache Commons Lang3 StringUtils判空与使用教程

2026-03-30 08:45:23 0浏览收藏

本文深入解析 Apache Commons Lang3 中 StringUtils 的核心字符串处理方法，重点厘清 isBlank() 与 isEmpty() 的本质区别——前者自动 trim 后判空，更适合表单、配置、JSON 等常见业务场景；后者仅看长度，适用于路径拼接、SQL 生成等对空白敏感的场合，并系统剖析 replace/replaceAll/replaceEach 的性能陷阱、split 系列方法在空字段保留与 null 安全上的关键差异，以及 capitalize/upperCase 等大小写操作中易被忽视的 locale 影响和边界行为，最终强调：真正决定代码健壮性的，不是记住 API 名称，而是每次调用前对字符串真实形态（null、空白、BOM、零宽字符、多语言环境）的审慎预判。

如何使用Apache Commons Lang3工具类_StringUtils判空与操作大全

StringUtils.isEmpty() 和 isBlank() 到底该用哪个？

判断字符串是否为空，isEmpty() 看的是长度是否为 0，isBlank() 还会额外 trim 后再判空。别一上来就用 isEmpty()，否则 " \t\n " 这种会被当成“非空”导致逻辑出错。

isEmpty(null) → true；isEmpty("") → true；isEmpty(" ") → false
isBlank(null) → true；isBlank("") → true；isBlank(" \t\n") → true
表单提交、配置读取、JSON 解析后字段校验，优先用 isBlank()
拼接路径、生成 SQL 片段等对空白敏感的场景，才考虑 isEmpty()

replace()、replaceAll()、replaceEach() 性能与语义差异

replace() 是字面量替换，不走正则；replaceAll() 底层调用 String.replaceAll()，会编译正则，有开销且可能抛 PatternSyntaxException；replaceEach() 适合多对一/多对多批量替换，但要注意数组长度必须一致，否则直接 IllegalArgumentException。

想把所有 "&" 换成 "and"，用 replace("&", "and")，别用 replaceAll()
要删掉所有数字：用 replaceAll("\\d+", "")，replace() 不支持
replaceEach(str, new String[]{"a", "b"}, new String[]{"x", "y"}) 中两个数组长度不等 → 立刻炸
高频调用场景（如日志清洗），避免在循环里反复调用 replaceAll()

split() 的坑：空字符串保留、limit 参数和 null 安全

StringUtils.split("a,,c", ",") 返回 ["a", "c"]，中间空串被丢了；而 String.split() 默认也丢，但加 -1 才保留。Commons Lang 的 split() 不支持 limit 的负数语义，得换 splitPreserveAllTokens()。

CSV 解析、日志字段切分，需要保留空字段 → 用 splitPreserveAllTokens(str, ",")
split("a,b,c", ",", 2) 只切一次，结果是 ["a", "b,c"]；但 splitPreserveAllTokens() 不支持 limit
split(null, ",") 返回 null；split("", ",") 返回空数组 []；注意 NPE 风险
分隔符含正则元字符（如 "."、"|"），split() 会按字面意思处理，不用转义；但 replaceAll() 就必须转