jsreplace 函数是 JavaScript 字符串原型自带的内置方法，主要作用是在原字符串里面查找匹配内容，然后把匹配到的内容替换成新内容，最终返回一个全新字符串，原字符串本身不会发生修改，这个是它非常关键的特性，很多新手误以为会直接修改原字符串，实际上字符串在 JS 里面属于不可变数据类型，所有替换操作都是生成新字符串，之所以设计这个函数，是日常开发经常需要处理文本清洗 关键字过滤 格式修正 字符转义这类需求，基础写法只能替换第一个匹配项，如果想要全局全部替换，就要配合正则表达式的全局修饰符，使用的时候先准备目标字符串，调用 jsreplace 函数，第一个参数传入要查找的内容，可以是普通字符串也可以是正则对象，第二个参数传入替换内容，可以是固定文本也可以是回调函数，执行之后拿到返回的新字符串，后续业务使用这个新字符串，熟练掌握之后可以完成绝大多数文本替换业务。

基础语法结构

string.replace (searchValue, replaceValue)

searchValue 查找目标，支持两种类型，普通字符串 正则表达式对象

replaceValue 替换内容，支持两种类型，固定替换字符串 回调函数

补充说明，当 searchValue 是普通字符串的时候，只会匹配并且替换第一次出现的内容，后面相同内容不会处理

核心特性清单

1 返回全新字符串，原始字符串保持不变

2 普通字符串作为查找参数，只替换首个匹配项

3 正则表达式配合 g 全局标记，可以替换全部匹配内容

4 区分大小写，默认是大小写敏感匹配

5 第二个参数支持回调函数，可以根据每一次匹配结果动态生成替换文本

6 正则里面支持捕获组，替换字符串可以使用 $ 符号引用捕获分组内容

7 空字符串作为查找目标的时候，会在字符串最前面插入替换内容

相关方法对比表格

深度运行原理

如果第一个参数是普通文本，jsreplace 函数会从头扫描字符串，找到第一处完全一致的子串，替换之后立刻停止扫描，不再继续查找后面内容。

如果第一个参数是正则对象，jsreplace 函数会按照正则规则匹配，带上 g 标记就循环扫描整段文本，每匹配成功一次，就调用第二个参数，如果第二个参数是回调函数，回调会接收匹配文本 下标 原字符串等参数，回调 return 的值就是本次替换的内容，这种动态替换能力是 jsreplace 函数非常强大的进阶功能。

替换字符串里面有特殊占位符，比如 $& 代表本次匹配到的完整文本，$1 代表第一个捕获组，$2 代表第二个捕获组，利用这个特性可以实现复杂文本重构，比如日期格式转换 手机号脱敏。

高频使用场景

第一 简单关键字替换，把文本里面指定词语替换成新词语

第二 全局替换空格换行，清理多余空白字符

第三 手机号身份证脱敏，配合捕获组保留部分数字

第四 日期格式转换，把横杠日期改成斜杠格式

第五 富文本简单过滤，替换危险标签字符

高频踩坑点

第一坑 普通字符串写法想要全局替换，结果只替换第一个，忘记添加正则 g 标记

第二坑 以为原字符串会被修改，没有接收 jsreplace 函数返回值，继续使用旧字符串

第三坑 大小写不匹配，文本里面大写字母没有被替换，需要添加 i 修饰符开启忽略大小写

第四坑 替换字符串里面本身包含 $ 符号，会被识别成捕获组占位符，需要额外转义

第五坑 低版本浏览器不支持 replaceAll，只能继续使用 jsreplace 函数搭配正则 g 实现全局替换

【常见问题】

问题 1 jsreplace 函数默认可以替换全部匹配内容吗

回答 1 jsreplace 函数如果第一个参数传入普通字符串，默认只替换第一个匹配内容，想要全部替换，需要使用正则表达式并且加上全局 g 标记，这是 jsreplace 函数最容易混淆的知识点。

问题 2 jsreplace 函数会不会修改原来的字符串

回答 1 jsreplace 函数不会修改原始字符串，它会生成并且返回一个全新字符串，业务代码必须接收这个返回值，否则替换后的内容无法保存，原字符串依旧保持原样。

问题 3 jsreplace 函数第二个参数可以写回调函数吗

回答 1 jsreplace 函数第二个参数支持传入回调函数，每一次匹配成功都会执行回调，回调返回的值作为本次替换文本，适合需要动态计算替换内容的复杂业务场景。

【免责申明】

本文内容仅作为 JavaScript jsreplace 函数技术学习参考，不同 JS 运行环境对正则相关特性存在版本差异，低版本环境需要兼容处理，本文不对项目上线后文本处理异常业务损失承担相关责任。