关键在传参方式：replace() 默认单次匹配，需显式加g才全局替换；replaceAll() 要求正则必须带g标志，否则报错，字符串参数则自动全量替换。

关键不在“用哪个”，而在“怎么传参数”。replace() 和 replaceAll() 行为差异的核心，是它们对正则表达式中 g 标志 的处理逻辑不同——这个细节一旦忽略，轻则替换不全，重则直接报错。

replace() 的陷阱：不加 g 就只换第一个，还不报错

replace() 接收正则时，默认行为是“单次匹配”。即使你本意是全局替换，只要漏写 g，它就安静地只动第一个，且完全不提示错误。这种 bug 很难被测试覆盖，尤其当输入恰好只有一个匹配项时，结果看起来还是“对的”。

• "a a a".replace(/a/, "x") → "x a a"（只换第一个）
• "a a a".replace(/a/g, "x") → "x x x"（加 g 才全换）
• 传字符串参数时，replace() 永远只换第一个，哪怕重复出现多次："abc abc".replace("abc", "xyz") → "xyz abc"

replaceAll() 的陷阱：非全局正则直接抛错

replaceAll() 要求正则必须带 g 标志，否则运行时报 TypeError: RegExp must have global flag。它不接受“半吊子”正则——不是不能用正则，而是必须合规。

• "a a a".replaceAll("a", "x") → ✅ 安全，字符串字面量，自动全量
• "a a a".replaceAll(/a/g, "x") → ✅ 合法，显式带 g
• "a a a".replaceAll(/a/, "x") → ❌ 报错，缺 g 不行

真正该警惕的混合场景

当你要动态构造正则（比如 pattern 来自用户输入或变量），容易忽略 g 的显式声明。用 new RegExp(pattern) 默认不带任何标志，必须手动补上：

• 错：new RegExp(userInput) → 缺 g，传给 replaceAll 会崩
• 对：new RegExp(userInput, "g") → 显式声明全局
• 更稳妥：new RegExp(userInput.replace(/[.*+?^${}()|[]\]/g, '\$&'), "g") → 先转义特殊字符，再加 g

选哪个？看需求，不看名字

别被 “All” 这个词牵着走。方法名只是提示，实际能力要看参数类型和标志位：

• 只换第一个 → 无脑用 replace("x", "y") 或 replace(/x/, "y")
• 全换固定字符串 → 优先 replaceAll("x", "y")，语义清、无正则风险
• 全换但需正则能力（如 i 忽略大小写、d+ 匹配数字）→ 只能用 replace(/x/gi, "y")，replaceAll 不支持 i/m 等修饰符单独使用（必须 g+i 同时存在）
• 需要基于匹配内容动态生成替换值（如把数字 ×2）→ 只能用 replace(/(d+)/g, (_, num) => +num * 2)，replaceAll 不支持回调函数