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"
注意事项与避坑点
实际使用中容易忽略的关键细节：
- 正则中的捕获组（
$1,$2）在替换字符串中生效，但需确保分组存在且被正确匹配 - 若正则写错（如忘记转义点号
.写成"a.b"），会误匹配任意字符，建议先用Pattern.compile().matcher().find()调试 - 区分
replaceFirst()和replaceAll()：后者全局替换，别混淆 - 对 null 输入要自行判空，该方法不处理 null，会抛
NullPointerException
替代方案参考（非正则场景）
如果只是简单子串替换且不想涉及正则，可用以下方式避免正则解析开销或转义麻烦：
- 用
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()，语义更清晰，内部已处理边界情况
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
