String.replaceAll() 替换全部子串
最后更新：2026-09-09
String.replaceAll() 替换全部子串
replaceAll 替换字符串中所有匹配的子串并返回新字符串，语义比正则 g 标志更直白，是 ES2021 引入的方法。
| 分类 | 字符串 |
|---|---|
| ES 版本 | ES2021 |
📝 语法
const 新字符串 = 字符串.replaceAll(要替换的模式, 替换内容);⚙️ 参数
| pattern | 字符串或正则（正则必须带 g 标志，否则抛 TypeError）。 |
|---|---|
| replacement | 替换字符串或回调函数。 |
返回值：全部替换后的新字符串。
是否修改原值：否（返回新值）
▶ 示例
编辑下方代码，点击运行，在输出面板查看结果：
运行结果：
2024/01/15 至 2024/03/20
你好 张三，欢迎来到 Web-Tutorial💡 提示 replaceAll 比 replace(/-/g, /) 更好读——简单文本替换的首选。
⚠️ 警告 replaceAll 传正则时必须带 g 标志，否则直接抛 TypeError——故意的防呆设计。
🌐 浏览器支持
| 浏览器 |  Chrome |
 Edge |
 Firefox |
 Safari |
 Opera |
|---|---|---|---|---|---|
| String.replaceAll() | ✓ v85 | ✓ v85 | ✓ v77 | ✓ v13.1 | ✓ v71 |
| 所有现代浏览器均支持 | |||||
🏷️ 相关条目
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
QreplaceAll 和 replace 的区别？
A功能等价，但 replaceAll 接受字符串参数（不需要转义正则特殊字符），可读性更好。
Q浏览器兼容性如何？
AES2021 方法：Chrome 85+ / Edge 85+ / Firefox 77+ / Safari 13.1+。老浏览器用 split+join 替代。
QreplaceAll 能用回调函数吗？
A能，与 replace 相同：text.replaceAll(/\d+/g, n => Number(n) * 2)。
