Guava 字符串操作：Java 高效处理实用指南

（2）核心操作

修剪匹配字符：trimFrom(CharSequence s)（首尾）、trimLeadingFrom（开头）、trimTrailingFrom（结尾）

// 移除首尾数字，输出 "abc"
String trimmed = CharMatcher.DIGIT.trimFrom("123abc456");

替换匹配字符：replaceFrom(CharSequence s, char replacement)

// 将所有制表符替换为空格，输出 "hello world"
String replaced = CharMatcher.TAB.replaceFrom("hello\t\tworld", ' ');

移除匹配字符：removeFrom(CharSequence s)

// 移除所有空白字符，输出 "helloworld"
String noWhitespace = CharMatcher.WHITESPACE.removeFrom("hello world\n");

保留匹配字符：retainFrom(CharSequence s)

// 提取字符串中的所有数字，输出 "12345"
String digits = CharMatcher.DIGIT.retainFrom("abc123def45");

（3）组合匹配器

通过 and/or/negate 实现复杂匹配规则：

// 匹配「非字母且非数字」的字符，输出 "!@#"
CharMatcher nonLetterDigit = CharMatcher.LETTER.or(CharMatcher.DIGIT).negate();
String specialChars = nonLetterDigit.retainFrom("abc123!@#def456");

3. Splitter：灵活的字符串分割

JDK 原生 String.split() 存在诸多痛点（如空字符串丢失、正则表达式陷阱），Guava Splitter 提供了更可控的分割能力。

（1）基础用法

// 按逗号分割，自动忽略空字符串，输出 ["a", "b", "c"]
List<String> split = Splitter.on(',').omitEmptyStrings()
    // 忽略空元素
    .trimResults() // 去除每个元素的空白
    .splitToList("a,, b ,c");

（2）核心特性

• on(char separator)：按单个字符分割；
• on(String separator)：按字符串分割；
• onPattern(String regex)：按正则表达式分割；
• limit(int limit)：限制分割结果数量；
• fixedLength(int length)：按固定长度分割。

示例：按固定长度分割字符串

// 输出 ["abc", "def", "g"]
List<String> fixedSplit = Splitter.fixedLength(3).splitToList("abcdefg");

4. Joiner：字符串拼接

Joiner 解决了 JDK 中拼接集合/数组时「空值处理」「分隔符拼接」的痛点。

（1）基础用法

// 拼接列表，输出 "a,b,c"
String joined = Joiner.on(',').skipNulls()
    // 跳过 null 元素
    .join(Arrays.asList("a", null, "b", "c"));
// 替换 null 元素，输出 "a,空,b,c"
String joinedWithNull = Joiner.on(',').useForNull("空").join(Arrays.asList("a", null, "b", "c"));

（2）拼接 Map

// 输出 "k1=v1,k2=v2"
Map<String, String> map = ImmutableMap.of("k1", "v1", "k2", "v2");
String mapJoined = Joiner.on(',').withKeyValueSeparator('=').join(map);

5. CaseFormat：大小写格式转换

CaseFormat 用于在不同命名规范（如驼峰、下划线、连字符）之间转换，适用于代码生成、配置解析等场景。

常用格式枚举

• LOWER_CAMEL：小驼峰（如 lowerCamel）；
• UPPER_CAMEL：大驼峰（如 UpperCamel）；
• LOWER_UNDERSCORE：下划线小写（如 lower_underscore）；
• UPPER_UNDERSCORE：下划线大写（如 UPPER_UNDERSCORE）；
• LOWER_HYPHEN：连字符小写（如 lower-hyphen）。

转换示例

// 下划线转小驼峰，输出 "helloWorld"
String camel = CaseFormat.LOWER_UNDERSCORE.to(CaseFormat.LOWER_CAMEL, "hello_world");
// 小驼峰转连字符，输出 "hello-world"
String hyphen = CaseFormat.LOWER_CAMEL.to(CaseFormat.LOWER_HYPHEN, "helloWorld");

6. Ascii：ASCII 字符处理

Ascii 类专注于 ASCII 字符的大小写转换、校验，相比 JDK Character 更高效（无需处理 Unicode）：

// ASCII 小写转大写，输出 "HELLO"
String upper = Ascii.toUpperCase("hello");
// 校验是否为 ASCII 可打印字符
boolean isPrintable = Ascii.isPrintable('a');

三、实战场景示例

场景 1：清洗用户输入

需求：过滤用户输入的昵称，仅保留字母、数字和下划线，其余字符替换为下划线，且首尾无空白。

String nickname = " 张三 123!@#_test ";
// 1. 去除首尾空白 2. 非字母/数字/下划线替换为下划线 3. 合并连续下划线
String cleaned = CharMatcher.WHITESPACE.trimFrom(nickname);
cleaned = CharMatcher.JAVA_LETTER_OR_DIGIT.or(CharMatcher.is('_')).negate().replaceFrom(cleaned, '_');
cleaned = CharMatcher.is('_').collapseFrom(cleaned, '_');
// 输出 "张三 123_test"（注：中文不在 ASCII 范围内，CharMatcher.JAVA_LETTER 包含中文）

场景 2：解析配置字符串

需求：解析形如 key1=value1;key2=value2;key3=value3 的配置字符串为 Map，忽略空行和注释行（以 # 开头）。

String config = "# 配置示例\nkey1=value1;;key2=value2;key3=value3";
Map<String, String> configMap = Splitter.on(';').omitEmptyStrings().trimResults().splitToStream(config)
    .filter(line -> !line.startsWith("#"))
    .map(line -> Splitter.on('=').limit(2).splitToList(line))
    .collect(Collectors.toMap(list -> list.get(0), list -> list.size() > 1 ? list.get(1) : ""));
// 输出 {key1=value1, key2=value2, key3=value3}

四、使用注意事项

1. 空值处理：Guava 工具类对 null 大多做了友好处理，但需注意 Splitter/Joiner 默认不处理 null，需显式调用 skipNulls()/useForNull()。
2. 性能考量：CharMatcher 是不可变类，预定义的匹配器（如 DIGIT/WHITESPACE）可复用，避免重复创建。

依赖引入：确保项目中引入 Guava 依赖（Maven 示例）：

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>32.1.3-jre</version>
    <!-- 最新版本可参考 Guava 官方仓库 -->
</dependency>

若为 Android 项目，使用 guava:32.1.3-android 版本。

五、总结

Guava 的字符串工具类通过封装高频场景、优化边界处理，大幅提升了 Java 字符串操作的效率和可读性。从基础的空值处理（Strings）到灵活的字符匹配（CharMatcher），再到可控的分割/拼接（Splitter/Joiner），几乎覆盖了日常开发中所有字符串处理需求。相比原生 JDK API，Guava 让代码更简洁、更健壮，是 Java 开发者提升效率的必备工具。

更多 Guava 字符串操作的细节，可参考官方文档：Guava StringsExplained。