财务的对账文件里金额带美元符号,导出前要把 $ 换成人民币符号。代码里写的是 text.replaceAll("$", "¥"),跑完发现一个都没换,日志也不报错。我第一反应是编码问题,把文件 hexdump 了一遍,$ 确实是 0x24。
翻了 Pattern 的文档才反应过来,"$" 在正则里是行尾锚点,匹配的是零宽位置,replaceAll 自然不会删掉任何字符。改成 replaceAll("\\$", "¥"),这次抛了 java.lang.IndexOutOfBoundsException: No group 1,因为替换串里的 $ 也有特殊含义,会被当成分组引用。
试过直接用 String.replace,字面替换确实能换掉 $,但同一段代码还要处理千分位逗号和多余空格,全是正则需求,拆成两次替换反而更难维护。
最后的写法是两边都转义,pattern 用 Pattern.quote,replacement 用 Matcher.quoteReplacement。这样 $ 和反斜杠都不会被解释,后续再加别的替换规则也不用每次重新想转义。
批量跑 3 万行时还遇到一个坑,文件是 GBK 读进来的,¥ 这个符号在 GBK 里对应 0xA3 0xA4,写回去用 UTF-8 就变成一个汉字。字符集必须在读和写两端都显式指定,别依赖平台默认值。
类似的问题还出现在 split 上,参数写成单个点号会按每个字符切开,返回一个空数组,日志里看不出任何异常。正则里的元字符有十多个,凡是用户输入拼进 pattern 的地方,一律先 quote。替换完还要校验长度,人民币符号在有些字体下占两个字符宽,导出到 Excel 列宽要跟着调整,否则整列显示成井号。
那次排查花了两个小时,最后靠一行的单元测试复现,后面给工具类补了十几个边界用例,包括空串、纯符号、带换行的文本,全部跑在 CI 上。
确认口径:3 万行样本里 1200 个 $ 全部替换成功,没有异常;故意传入 "$1" 和反斜杠,输出保持字面量;单测覆盖了空串和只有符号的行。
String out = text.replaceAll(
Pattern.quote("$"),
Matcher.quoteReplacement("¥")); 