javascript 的 replaceall() 会替换所有非重叠匹配,并返回新字符串,不修改原字符串。搜索值是字符串时按字面匹配;使用正则表达式时必须带 g 标志。替换字符串中的 $& 等写法还有特殊含义,若要把外部变量原样写入,可使用返回该变量的替换函数。以下示例可分别在 node.js 18 中执行。

使用字符串搜索值替换全部字面文本
搜索值里的点号、美元符号等字符不会自动变成正则语法。下面直接替换 a.b,既会处理两个完整匹配,也不会把 aXb 当作同一模式。未找到时,返回的字符串值与原文相等。
const assert = require('node:assert/strict');
const original = 'a.b / aXb / a.b';
const result = original.replaceAll('a.b', 'item');
assert.equal(result, 'item / aXb / item');
assert.equal(original, 'a.b / aXb / a.b');
assert.equal(original.replaceAll('missing', 'x'), original);
assert.equal('$10 + $20'.replaceAll('$', 'USD '), 'USD 10 + USD 20');
console.log(result);
搜索字符串为空时也有专门的插入规则,不应把空搜索值当作“没有匹配”。如果搜索词来自表单并且业务不允许为空,应先验证,再调用替换。

替换内容含美元语法时,用函数保持原样
第二个参数若是字符串,$& 表示本次匹配的原文,而不一定是两个字面字符。替换函数的返回值不会再按这类替换模板解释,适合插入需要原样保留的变量。
const assert = require('node:assert/strict');
const text = 'x x';
const replacement = '$&';
assert.equal(text.replaceAll('x', replacement), 'x x');
assert.equal(text.replaceAll('x', () => replacement), '$& $&');
const price = '$10';
assert.equal('PRICE/PRICE'.replaceAll('PRICE', () => price), '$10/$10');
console.log('字符串模板与字面替换检查通过');
字面替换不等于对 HTML、SQL 等目标格式自动转义。后续把结果放入什么位置,仍需遵守那个位置的数据处理规则;这里只解决 replaceAll 自身的替换模板语义。
使用正则表达式时显式添加 g
正则搜索仍按正则规则匹配,但 replaceAll 要求这个正则是全局模式。下面用空白匹配演示压缩连续空白,再捕获缺少 g 时的 TypeError,不让验证脚本直接中断。
const assert = require('node:assert/strict');
const text = 'a b\t\tc';
assert.equal(text.replaceAll(/\s+/g, ' '), 'a b c');
assert.throws(() => text.replaceAll(/\s+/, ' '), TypeError);
assert.equal('foo foo'.replaceAll(/foo/g, 'bar'), 'bar bar');
console.log('全局正则及缺失标志检查通过');
只替换一次时可使用 replace;替换全部字面搜索词时则直接传字符串,不必先拼接 RegExp。这样还能避免把用户输入的正则元字符误当成模式。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











