String.replaceFirst() 是 Java 中用于仅替换首个正则匹配项的方法，接收正则表达式和替换字符串两个参数，未匹配时返回原串；需注意元字符转义、捕获组引用及 null 判空。

string.replacefirst() 是 java 中精准控制替换范围的常用方法，适用于只修改首个匹配项的场景，比如修复格式错误、添加前缀、标准化输入等。

理解 replaceFirst() 的基本用法

该方法接收两个参数：第一个是正则表达式（不是普通子串），第二个是替换字符串。它仅对文本中第一个匹配正则的位置执行替换，其余保持不变。

• 若需字面量匹配（如替换第一个 "a+b"），须对正则元字符转义，例如 "a\+b"
• 若传入普通子串（如 "abc"）且其中不含正则符号，可直接使用，但本质仍是按正则解析
• 未匹配时，返回原字符串，不抛异常

常见特殊格式化需求与写法示例

以下是一些典型场景及对应代码：

• 给首个数字前加标记： "abc123def456".replaceFirst("(\d+)", "[NUM:$1]") → "abc[NUM:123]def456"
• 修正首处多余空格： " hello world ".replaceFirst("^\s+", "") → "hello world "
• 为首个 URL 添加协议（若缺失）： "example.com/path".replaceFirst("^(?!https?://)([a-zA-Z0-9.-]+\.[a-zA-Z]{2,})", "https://$1")
• 替换首个逗号为空格（用于清理 CSV 头）： "name,age,city".replaceFirst(",", " ") → "name age,city"

注意事项与避坑点

实际使用中容易忽略的关键细节：

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

• 正则中的捕获组（$1, $2）在替换字符串中生效，但需确保分组存在且被正确匹配
• 若正则写错（如忘记转义点号 . 写成 "a.b"），会误匹配任意字符，建议先用 Pattern.compile().matcher().find() 调试
• 区分 replaceFirst() 和 replaceAll()：后者全局替换，别混淆
• 对 null 输入要自行判空，该方法不处理 null，会抛 NullPointerException

替代方案参考（非正则场景）

如果只是简单子串替换且不想涉及正则，可用以下方式避免正则解析开销或转义麻烦：

立即学习“Java免费学习笔记（深入）”；

• 用 indexOf() + substring() 手动拼接：
  int idx = str.indexOf("old"); return idx == -1 ? str : str.substring(0, idx) + "new" + str.substring(idx + "old".length());
• 引入 Apache Commons Lang 的 StringUtils.replaceOnce()，语义更清晰，内部已处理边界情况