S06-B05 · 第三方工具库：Guava / Hutool / StringUtils

适用读者：项目里同时引了 Guava、Hutool、commons-lang3 的人。
前置：S06-B04。
覆盖旧文：A-1803(119 Guava) A-1804(181 Hutool) A-1807(59 StringUtils) A-1808(109 其他) = 468 点。
覆盖扩展：E-S06-007（三库重叠与选型）。
上一篇：S06-B04 · JDK 自带工具类：Arrays/Collections/Objects/Scanner
下一篇：S06-J01 · 多模块工程结构。

1. 一句话结论

三个库的定位完全不同：Guava 是"Google 的工程化补充"、Hutool 是"国产全家桶"、commons-lang3 是"最小侵入的字符串/对象工具"。选型看"你缺哪一块"，而不是"谁更全"。

库	定位	强项	代价
Guava	基础设施增强	不可变集合、`Cache`、`ListenableFuture`、`Preconditions`	体积较大；API 偏"函数式"
Hutool	全家桶（中文生态）	一行搞定常见操作（日期/文件/加密/HTTP）	封装深、异常易被吞；API 稳定性靠版本
commons-lang3	轻量补充	`StringUtils`/`ObjectUtils`/`DateUtils`	功能面窄

2. Guava 的不可替代部分（A-1803）

能力	为什么值得用
`ImmutableList/Map`	真不可变 + 拒绝 null（防"别人改了我的集合"）
`CacheBuilder`	带过期/容量上限的本地缓存（无需引入 Redis）
`ListenableFuture`	回调式异步（Java 8 前）；现在用 `CompletableFuture`（S05-J03）
`Preconditions`	参数校验（比手写 `if` 更清晰）
`Multimap/Multiset`	一对多、计数集合

判据："我需要不可变集合或本地缓存吗？" 需要 → Guava；否则别为了 Strings.isNullOrEmpty 引入整个 Guava。

3. Hutool 的取舍（A-1804）

优点	风险
中文文档、命名直观（`DateUtil`/`FileUtil`/`StrUtil`）	封装深：异常可能被包装成 `UtilException`，栈不直观
覆盖面广（加密、二维码、Excel、HTTP）	体积大（模块化后可缓解）
上手快	版本间 API 有变动

判据："这个操作 JDK 或 commons-lang3 能做吗？" 能 → 别引；不能且频繁用 → Hutool 值得。

4. 三库重叠时的选型（E-S06-007）

场景	首选	理由
字符串判空/截断/连接	commons-lang3 `StringUtils`	最轻、语义清晰
不可变集合、缓存	Guava	无可替代
日期/文件/加解密（快速开发）	Hutool	省代码
参数校验	`Objects.requireNonNull`（JDK）或 Guava `Preconditions`	非空判断别引库
JSON	Jackson（S06-B03）	不要用 Hutool 的 JSON 替代 Jackson（生态/注解一致）

反模式：同一个功能两套库都引 → 类冲突、行为不一致（StringUtils.isBlank 在 commons 与 Hutool 语义相同但边界不同）。

5. `MDC` 与 `ClassUtils`/`BeanUtils` 的注意事项（A-1808）

工具	注意
`MDC`	日志上下文；线程池里要手动清理（同 ThreadLocal 泄漏，S05-B04）
`BeanUtils.copyProperties`	反射拷贝，性能差；字段名不一致会静默丢失
`ClassUtils`	类名/包名处理，注意数组与内部类的名字格式

6. 五个误区

误区	真相
"Hutool 什么都有，一个就够"	异常封装深、体积大；JSON 别替代 Jackson
"Guava 只为字符串工具"	它的核心价值是不可变集合与缓存
"两个工具库共存没问题"	同类功能共存会导致行为不一致
"`BeanUtils.copyProperties` 方便又安全"	反射慢、字段不匹配会静默丢
"MDC 会自动清理"	线程池复用时要手动 `MDC.clear()`

7. 自检

Guava 哪两项能力最"不可替代"？
Hutool 的主要风险是什么？
三库重叠时，字符串判空该用哪个？
为什么 JSON 不建议用 Hutool 替代 Jackson？
MDC 在线程池里要注意什么？

8. 下一篇

S06-J01 · 多模块工程结构：parent / BOM / 聚合

工具库选完，进阶层开始：依赖版本到底该在哪一层管，聚合与继承有什么区别。

本篇属于系列《S06 · Java 工程化与组件》。旧文来源：A-1803/1804/1807/1808；扩展点 E-S06-007。