异常教程

Java 实例 – 字符串替换（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 Java 开发中，字符串的替换操作是日常编码中常见的需求。无论是处理用户输入、数据清洗，还是实现特定的业务逻辑，字符串替换都能发挥重要作用。本文将以 “Java 实例 – 字符串替换” 为主题，通过循序渐进的方式，为编程初学者和中级开发者系统讲解 Java 中字符串替换的核心方法、使用场景及进阶技巧。通过结合代码示例和实际案例，帮助读者快速掌握这一技能。

字符串替换的基础概念与核心方法

在深入具体实现之前，我们需要明确几个关键概念：

  1. 不可变性：Java 中的 String 类是不可变的（Immutable），所有操作都会生成新对象，而非直接修改原对象。
  2. 替换的粒度：替换可以是单个字符、子字符串，或是通过正则表达式匹配的复杂模式。
  3. 方法选择：根据需求的不同，开发者可选择 String 类的内置方法、第三方工具类（如 Apache Commons Lang 的 StringUtils），或通过 StringBuilder 实现高效替换。

String 类的简单替换方法

Java 的 String 类提供了 replace() 和 replaceAll() 方法，分别适用于不同场景。

单字符或字符串的直接替换

使用 replace() 方法时，可以替换单个字符或指定的字符串片段：

String original = "Hello World!";  
String replaced1 = original.replace('o', 'a'); // 替换所有 'o' 为 'a'  
System.out.println(replaced1); // 输出 "Hella Warld!"  

String replaced2 = original.replace("World", "Java");  
System.out.println(replaced2); // 输出 "Hello Java!"

注意：replace() 方法会返回新字符串，原字符串 original 不会被修改。

正则表达式替换（replaceAll）

若需更复杂的模式匹配，如替换所有数字或特定符号，可使用 replaceAll() 方法。它接受正则表达式作为参数：

String text = "Price: $100.50, Quantity: 2";  
String replaced = text.replaceAll("\\d+", "###"); // 替换所有数字为 ###  
System.out.println(replaced); // 输出 "Price: $###.###, Quantity: ###"

关键点：正则表达式中的特殊字符（如 .、*、$）需要转义，因此在 Java 字符串中需使用双反斜杠 \\。

进阶技巧与常见问题解决

情况一：替换特定位置的字符

若需替换字符串中某个位置的字符，可结合 StringBuilder 实现：

StringBuilder sb = new StringBuilder("Java Programming");  
sb.replace(5, 14, "Script"); // 从索引5到13替换为 "Script"  
System.out.println(sb.toString()); // 输出 "Java Script"

比喻：StringBuilder 像一个可编辑的文档，允许你直接修改内容，而 String 则像只读文档，每次修改都需要生成新副本。

情况二：避免正则表达式陷阱

使用 replaceAll() 时，若目标字符串包含正则表达式元字符（如 .、*），需确保正确转义。例如，替换句点 . 需要写成 \\.：

String path = "file.txt";  
String replacedPath = path.replaceAll("\\.txt", ".log"); // 替换 .txt 为 .log  
System.out.println(replacedPath); // 输出 "file.log"

情况三：替换多字符模式

通过正则表达式组（Group）实现复杂替换。例如，将 John Doe 转换为 Doe, John：

String name = "John Doe";  
String reversedName = name.replaceAll("(.*) (.*)", "$2, $1");  
System.out.println(reversedName); // 输出 "Doe, John"

解析：正则表达式 (.*)(.*) 将字符串分为两组，$1 和 $2 分别代表第一组和第二组的内容。

第三方工具类的高效使用

Apache Commons Lang 的 StringUtils

Apache 的 StringUtils 类提供了更灵活的替换方法，例如 replaceEach() 可批量替换多个字符串：

import org.apache.commons.lang3.StringUtils;  

String text = "apple, banana, orange";  
String replacedText = StringUtils.replaceEach(  
    text,  
    new String[]{"apple", "banana"},  
    new String[]{"mango", "kiwi"}  
);  
System.out.println(replacedText); // 输出 "mango, kiwi, orange"

优势：减少多层嵌套的 replace() 调用，代码更简洁。

性能优化与最佳实践

场景一：频繁替换字符串时

若需对同一字符串进行多次替换，建议使用 StringBuilder 或 StringBuffer（线程安全版），避免因频繁生成新 String 对象导致内存浪费：

StringBuilder sb = new StringBuilder("Hello");  
sb.replace(0, 5, "Java"); // 替换整个字符串  
sb.append(" is fun!"); // 追加内容  
System.out.println(sb); // 输出 "Java is fun!"

场景二：正则表达式预编译

对于需要多次执行的正则替换，可预先编译 Pattern 对象，提升性能：

import java.util.regex.Pattern;  

Pattern pattern = Pattern.compile("\\d+");  
String text1 = "Order #12345";  
String replaced1 = pattern.matcher(text1).replaceAll("###");  

String text2 = "Code 67890";  
String replaced2 = pattern.matcher(text2).replaceAll("###");

解释：预先编译的 Pattern 对象可避免重复解析正则表达式，尤其在循环或高频操作中效果显著。

实战案例：敏感信息脱敏

需求：将用户输入的手机号 13812345678 转换为 138****5678。

解决方案：结合 substring() 和 replaceAll() 实现：

public static String maskPhoneNumber(String phone) {  
    if (phone == null || phone.length() != 11) {  
        return phone; // 非法输入直接返回  
    }  
    return phone.substring(0, 3) + "****" + phone.substring(7);  
}  

// 测试  
System.out.println(maskPhoneNumber("13812345678")); // 输出 "138****5678"

进阶版：使用正则表达式一次性替换中间四位：

public static String maskPhoneRegex(String phone) {  
    return phone.replaceAll("(\\d{3})\\d{4}(\\d{4})", "$1****$2");  
}

结论

通过本文的学习，读者应能掌握 “Java 实例 – 字符串替换” 的核心方法与最佳实践。无论是基础的 String.replace()，还是进阶的正则表达式和第三方工具类，每种方法都有其适用场景。在实际开发中，开发者需根据需求权衡性能、代码简洁性与可维护性。

建议读者通过以下步骤巩固知识：

  1. 动手练习：尝试用不同方法实现字符串替换的案例。
  2. 性能测试：对比 String 和 StringBuilder 在高频操作中的表现。
  3. 阅读源码：研究 StringUtils 的实现逻辑，理解其设计思想。

掌握字符串替换技巧不仅能提升编码效率，更能为处理复杂文本操作（如日志解析、数据格式化）奠定坚实基础。希望本文能成为你 Java 学习路上的实用指南！

最新发布

查看更多文章