Guava 谷歌核心 Java 库

Guava 是什么

Guava 是 Google 开源的 Java 核心库集合，为 JDK 补充了大量实用能力：新的集合类型（Multimap、Multiset）、不可变集合、图结构库，以及并发、I/O、哈希、原生类型和字符串处理等工具。它在 Google 内部几乎所有 Java 项目中广泛使用，也被大量外部公司采用。

两种变体

Guava 提供两个版本，通过 Maven 版本号后缀区分：

• JRE 版：要求 JDK 1.8 及以上，版本形如 33.7.2-jre
• Android 版：面向 Android 或需要与 Android 兼容的库，版本形如 33.7.2-android

Android 版源码位于仓库的 android 目录。

引入方式

Maven 坐标的 groupId 为 com.google.guava，artifactId 为 guava：

<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>guava</artifactId>
  <version>33.7.2-jre</version>
</dependency>

Gradle 中可按需选择 implementation 或 api，Android 项目则替换为 -android 后缀版本。

文档与快照

• 官方站点 guava.dev 提供 API 文档，可直接在域名后拼接类名跳转，例如 guava.dev/ImmutableList
• master 分支快照版本为 999.0.0-HEAD-jre-SNAPSHOT（Android 版对应 -android-SNAPSHOT）
• 用户指南见 wiki 中的 Guava Explained

使用前必读的注意事项

1. @Beta API 不稳定：类或方法级标注 @Beta 的 API 可能被任意修改甚至移除。若你的代码本身是被他人依赖的库，强烈建议使用 Guava Beta Checker 检查，避免对外暴露 Beta API。
2. 非 Beta API 长期兼容：未标注 @Beta 的 API 将无限期保持二进制兼容，@Deprecated 的 API 也会保留（Beta 除外）。
3. 运行时依赖：链接期需要 com.google.guava:failureaccess:1.0.3，另有若干仅注解依赖。
4. 序列化不保证兼容：除非特别说明，所有对象的序列化形式都可能变化，不要持久化后假设未来版本可读。
5. 不防御恶意调用方：这些类并非为可信与不可信代码之间的通信而设计。
6. 平台差异：主线版本在 Linux 与 Windows 的多种 OpenJDK 上测试，com.google.common.io 的部分功能在非 Linux 环境可能不正常；Android 版单测覆盖到 API 24。

适合谁

如果你在写 Java 后端服务、基础库或 Android 应用，希望用更简洁、更安全的 API 处理集合、缓存、并发与字符串，Guava 是值得系统掌握的基建库。