文本替换工具 - 查找替换与正则替换(捕获组、预览、撤销)
🔁 一件干了十年还在手动点的事
运维改一份 nginx 配置,把老域名换掉。文件一百二十行,域名出现九次,Ctrl+F 找一次、选中、粘贴、按回车,重复九遍。第三遍之后人就开始走神,第六遍可能漏掉一行注释里的旧域名,上线后才发现有个回调地址没改。
运营改活动文案,全篇四十几处「限时特惠」要统一改成「限时优惠」。这次是十六处,下次是二十几处,每次都得从头找。
开发做日志清洗,把测试环境的 IP 段 10.20.30.x 全部替换成 *.*.*.*,再从几百行里挑出手机号打码。或者干脆是改个函数名:getUserInfo 改成 fetchUserInfo,整个文件二十多处调用。
这四件事的共同点是:要改的位置很多,但规则只有一条或两条。规则能说清楚,就不该用手去点。星点 文本替换工具 处理的就是这一层——你把规则写出来,它把所有命中的位置一次性改掉,改完告诉你改了几处,还能一键退回原文。
它不复杂,但有几个地方和大多数人的直觉相反:普通模式下 . 就是个句点;$1 在普通模式下是三个普通字符;空着查找框不让点替换。这些不是缺陷,是刻意设计的边界,下面逐个说清楚。
🧩 一次替换其实是三个决定
打开工具,界面上能动的选项不多,但每一个都在改变结果的范围。
第一个决定:用哪种模式找。 普通文本,还是正则。这决定了你填的查找内容会被当成”一串固定字符”还是”一套匹配规则”。
第二个决定:大小写算不算不一样。 默认区分,Error 和 error 是两个东西。
第三个决定:改第一处还是改所有。 范围选”首个”,只动最前面那一次命中;选”全部”,从头到尾一次改完。
三个决定组合起来是八种情况,但日常用得最多的是三种:普通模式 + 区分大小写 + 全部(改配置、改文案里的固定词)、普通模式 + 不区分大小写 + 全部(不确定原文哪种大小写写法时先兜一遍)、正则模式 + 全部(规则化的批量清洗)。
选择之前先想一个问题:我能不能用一句人话说清楚要改什么? 能,而且句中只出现了具体字词,用普通模式;不能,句子里出现”所有以 xxx 开头的""括号里的那一段""两个词之间的内容”,那就得用正则。
✍️ 普通模式:. * [ 就只是三个符号
这是最容易踩坑的地方,也是这个工具和命令行 sed、编辑器正则替换最大的不同。
普通模式会把查找内容整体转义后再去匹配。也就是说,你输入 file.txt,它找的是 file.txt 这七个字符,那个 . 只匹配句点本身。你输入 a[0],它找的就是方括号加零,不是”a 后面跟一个 0”。
我见过太多人在普通模式里写 file.txt,然后理直气壮地认为它会把 fileAtxt、file1txt 也一起处理掉——不会。这恰恰是普通模式的价值:改配置里的域名、版本号、带括号的变量名、带点的文件名时,你不需要考虑转义。
v1.2.3 换成 v1.3.0,普通模式下直接填,四个点都是点。要是在正则模式里做同样的事,你得写 v1\.2\.3,漏一个反斜杠,那个点就会变成”任意字符”,v1X2Y3 也会被改掉。
普通模式还有一个几乎没人注意的细节,但很关键:替换内容里写的 $1、$&,在普通模式下不生效,就是字面的三个字符。 工具在普通模式下走的是函数式替换,不解析美元符号。所以你从 Excel 拷了一段带 $ 的价格文本做替换,不会被误当成捕获组引用搞乱。只有切到正则模式,$1 才开始有含义。
🧠 正则模式:JavaScript 的正则,没有多余开关
切到正则模式,查找内容交给 JavaScript 的 RegExp 编译。这意味着你手上能用的是 JS 那套语法:\d、\w、\s、[^>]、(\w+)、(?:...)、(?=...)、\b,都按 JS 规范来,和 Chrome 开发者工具里写的是同一套。
但有一点必须提前讲清楚,否则很多人会卡住:这个工具没有单独的多行(m)、点号匹配换行(s)、Unicode(u)这些开关,选项区只有”区分大小写”和”首个/全部”。少一个开关,就多一条后果:
^和$只匹配整段文本的开头与结尾,不是每行的开头结尾。想给每一行加东西,别指望^。.默认不匹配换行符。所以.+在一段多行文本里,是逐行各匹配一次,而不是把整段吞成一块。这反而方便了逐行处理,后面场景里会用到。\w在 JS 里只认 ASCII 的字母、数字、下划线,匹配不了中文。(\w+)拿不到「张三」这种名字。
如果确实要跨行匹配,用显式的 \n,或者用 [\s\S] 这种”什么都匹配”的字符组代替 .。这不是技巧,是在没有 s 标志时的标准写法。
正则编译失败会有明确的报错,形如「正则表达式无效:…」,并且原文不会丢。工具不做 eval、不做 new Function,你的输入只被当作匹配模式,不会被当成代码执行。
🔠 大小写与范围:两个勾选框,两种不同的错
区分大小写默认打开。关掉它,匹配会带上 i 标志,error、Error、ERROR 全算命中。
这个开关的用法很具体:日志里查错误,常常是关掉大小写更省事,因为同一条日志可能来自不同框架,写法不统一。而改代码标识符时必须打开,userId 和 UserID 在两个地方是两种写法,混着改就出问题。
范围选”首个”还是”全部”,直接决定改几处。工具的做法很直白:选”全部”时正则带 g 标志,从头替换到尾;选”首个”时不带 g,String.replace 只处理第一次命中。
这里有个容易误读的地方,值得单独说:输入框下方那行「当前查找可匹配 N 处」,统计的永远是全部匹配数,和范围开关无关。它是个”这条规则能命中多少”的探针,你换一个字、加一个反斜杠,这个数字立刻变,用来验证规则对不对非常方便。
而点击替换后弹出的提示是「匹配 N 处,替换 N 处」。选”全部”时,N 就是真实的命中总数;选”首个”时,N 是 1——因为你只让它改一次。所以核对数量之前,先看一眼范围开关在哪一档,别拿着”只改了 1 处”去怀疑规则写错了。
两个数字在提示里总是一样,这也是有意的:这个工具不存在”匹配到了但不替换”的情况,能匹配就会替换,没有跳过、没有例外白名单。要”只改一部分”,办法是把规则写得更精确,而不是事后挑拣。
🔢 捕获组:把匹配到的内容搬进替换结果
正则替换比普通替换强的地方,不在于”能模糊匹配”,而在于能把匹配到的片段重新排列。
规则很简单:查找内容里用括号 ( ) 圈出来的部分叫捕获组,从左往右编号 $1、$2、$3;替换内容里写 $1,就等于把第一组的内容原样搬过来。另外 $& 代表整个匹配到的内容,不管里面有几个组。
拿最常见的邮箱做例子。原文:
张三的邮箱是 zhangsan@example.com李四的邮箱是 lisi@example.com想把「用户名@域名」的顺序倒过来,查找填 (\w+)@(\w+),替换填 $2@$1。
第一行里,\w+ 会一路吃到点号之前,所以匹配到的是 zhangsan@example,第一组是 zhangsan,第二组是 example,替换后变成 example@zhangsan,后面那个 .com 不在匹配范围内,原样留在原地。最终结果:
张三的邮箱是 example@zhangsan.com李四的邮箱是 lisi@example.com(第二行同理,会变成 example@lisi.com。)
这个例子顺带暴露了一件事:捕获组的边界决定结果对不对,不是”写个 $2@$1 就完事”。真要连域名后缀一起换,查找得写 (\w+)@([\w.]+),把点号也纳入第二组。
$& 的用法是”在命中内容外面套东西”。比如给文本里所有数字加方括号:查找 \d+,替换 [$&],共 12 件,单价 35 元 就变成 共 [12] 件,单价 [35] 元。不用分组,也不用管数字有几位。
再补一条实操规则:正则模式下,替换内容里的 $ 是有特殊含义的。想输出一个字面的美元符号,按 JS 的规则写 $$。所以「价格 100 美元」这种替换,要么在普通模式做($ 自动当字面量),要么在正则模式里写 $$100。这一点不注意,替换出来会少一个符号甚至变成空。
👀 预览、计数、撤销:原文其实一直没被动过
这个工具的排版是左右两栏:左边原始文本,右边替换结果。点替换,右边出结果,左边一个字都不变。
这个设计带来三个实际好处。
第一,对照着看。 你不用来回滚动找”刚才那处改了没”,左右并排扫一眼就知道。改配置这种低风险但需要确认的操作,扫一遍比读十遍规则快。
第二,原文永远在线。 觉得改坏了,不用重新粘贴。点”撤销”,右侧结果区会恢复成左侧原文——注意它的语义是”放弃这次结果”,退回原始状态,而不是回滚到上一次替换。因为这个工具从头到尾没有改写你的输入框,所以”回到最初”永远是安全的。
第三,真实的下限保护。 左侧原文可以复制、可以下载结果是 text-replaced.txt。整个过程在浏览器本地完成,文本不上传,工具也不联网执行任何东西。改客户名单、改内部配置、改带手机号的日志,不需要考虑数据出站的问题。
预览的意义在于:批量替换的风险不在”改不对”,而在”改得太多”。一条 .* 写下去,两千行文本可能被吞成一行。有了左右对照和实时的匹配计数,你在按下按钮之前就能看到”这条规则会命中 400 处”——400 这个数字本身就是警告。
🧪 四个能直接照抄的场景
场景一:批量改配置里的域名
从测试环境切生产,api.test.example.com 要全部换成 api.example.com。
- 模式:普通文本
- 查找:
api.test.example.com - 替换为:
api.example.com - 范围:全部,区分大小写
普通模式在这里是最优解:域名里三个点、中间还有连字符,都不需要转义。改完记得扫一眼注释行——注释里的旧域名也会被一起替换,这通常是好事,但如果注释是”示例:api.test.example.com”,你可能想保留它,那就把范围切成”首个”或者先手动把注释行摘出去。
场景二:日志里的 IP 与手机号脱敏
日志长这样:
2026-10-25 09:12:03 [INFO] client 10.20.30.41 GET /api/order2026-10-25 09:12:07 [WARN] client 10.20.30.88 timeout uid=13812345678把内网段打码,查找 (\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3}),替换 $1.$2.*.*,结果里 IP 变成 10.20.*.*,网段信息还在,主机位已经没了。
手机号打码用两条更省事:查找 (\d{3})\d{4}(\d{4}),替换 $1****$2,13812345678 变成 138****5678。中间四位被吞掉,前后缀保留。
这两条都属于”不区分大小写也可以,但没必要开”的情况——数字和点号没有大小写。
场景三:给每行加引号和逗号,粘进数组
手上是一列英文关键词,一行一个,要变成 'keyword', 的形式。前面说过这工具没有多行开关,但 . 不匹配换行,所以:
- 查找:
(.+) - 替换为:
'$1', - 范围:全部
因为 . 遇到换行就停,g 会逐行各匹配一次,每一行的整行内容进 $1,替换后加上引号和逗号。三行变三行,顺序不变。
代价是空行不会被处理(. 至少要匹配一个字符),也不会自动去掉行尾空格——如果原文有行尾空格,那个空格会一起被包进引号里。这就是为什么这个场景做完,通常还要去 文本清理工具 走一遍去空行、去行尾空白。两个工具是连着用的,不是二选一。
场景四:代码里改函数名,顺手补边界
getUserInfo 改名 fetchUserInfo,看着简单,直接普通模式全部替换有个隐患:文件里还有 getUserInfoById、getUserInfoList,这些调用也会被改成 fetchUserInfoById。
如果新名字只是把 get 换成 fetch,那没问题,改得正合适。但如果你本来只想改那一个函数、不想动其它名字相近的,就得加边界:
- 模式:正则
- 查找:
\bgetUserInfo\b - 替换为:
fetchUserInfo - 范围:全部
\b 是词边界,只在”前后都不是字母数字下划线”的地方命中,getUserInfoById 里的 getUserInfo 后面紧跟 B,不满足边界,就不会被改。这一条几乎是所有正则替换教程里被提到最多次、但实际最常忘记的。
⚠️ 五个反复出现的错误
错误一:在普通模式里等 . 当通配。 上面说过了,普通模式的 . 是句点。想通配必须切正则。反过来,在正则模式里忘了转义 .,file.txt 就变成了”file + 任意字符 + txt”,fileAtxt 也会中招。判断方法很简单:查找内容里有没有 . * + ? ( ) [ ] { } | ^ $ \,有任何一个,先问自己”我要的是这个符号本身,还是它的正则含义”。
错误二:空查找。 查找框空着,替换按钮不给执行,并给出提示说明原因。这不是防手抖,是防”每个位置都匹配”。空模式在正则里是零宽匹配,会在每个字符的间隙命中一次,abc 替换成 x 会得到 xaxbxcx 这种东西。结果既难解释,也几乎不可能是你想要的,所以直接禁掉比事后解释更干净。
错误三:替换完再点一次。 这是个隐蔽的坑。第一次把 utm_source=a 换成空,结果正确;手滑又点了一次替换——这次查找的还是 utm_source=a,已经没有了,命中 0 处,没事。但如果替换内容是”在命中位置插入某些东西”,比如查找 \d+ 替换 [$&],第二次执行就会在方括号里面再套一层方括号。规则是”自反”的(替换结果仍然满足查找规则)时,重复执行一定会叠加。 判断方法:看替换结果里还含不含查找内容,含就不要再点第二次,或者干脆每次都从左侧原文重新开始。
错误四:贪婪匹配把范围吃太大。 .* 和 .+ 默认是贪婪的,会尽量往右吃。想删掉一段 HTML 注释,写 <!--.*-->,如果一行里有两条注释,它会从左边的 <!-- 一路吃到右边的 -->,把中间正常内容一起删掉。收窄的办法有三种:把 . 换成不含边界的字符组(<!--[^-]*-->)、用最短匹配 .*?、或者用 [^>]+ 这类明确排除的写法。先看匹配计数,再点替换——计数明显大于你预期的条数,就是贪婪了。
错误五:以为改了大小写就是改了原文。 这条最容易被误解。区分大小写开关只影响匹配判断,不会把原文转成统一大小写,也不会把 $1 自动变成某个大小写。想顺手改大小写,这个工具不做,得走 大小写转换工具,或者替换完再处理一遍。工具的输出始终是”原文 + 你指定的改写”,不做任何额外加工。
🆚 和正则系列里的「正则替换」怎么分工
星点有两处能做替换:文本系列的 文本替换,和正则系列的 正则替换。功能有重叠,定位不一样。
| 文本替换(文本系列) | 正则替换(正则系列) | |
|---|---|---|
| 匹配方式 | 普通文本 / 正则二选一 | 专注正则 |
| 模式开关 | 区分大小写、首个/全部 | 正则表达式 + Flags(如 g、m、s) |
| 多行、点号匹配换行 | 无对应开关 | 通过 Flags 控制 |
| 替换引用 | $1、$& | $1、$&、命名组等更全 |
| 结果查看 | 左右对照 + 撤销 | 替换前后文本 + 替换次数 |
| 适合 | 大部分是固定字词,偶尔用一下正则 | 规则本身就是重点,需要调 Flags 和引用 |
选择其实不纠结:改的是”确定的字”,用文本替换;改的是”一类模式”,去正则替换。 前者的高频动作是”这段话里的公司名要换”,后者是”所有日期格式统一成 ISO”,需要 m、s 这种标志配合。正则语法本身不熟的话,星点正则工具完整指南 里有从语法到调试的整套工具,先在那儿把规则调通,再拿回来批量跑,是个更稳的顺序。
🛠 操作步骤
- 打开 文本替换工具,左侧粘贴要处理的原文;
- 在”查找”框填要改的内容,“替换为”框填新内容;
- 选择模式:普通文本(字面量)或正则;
- 视情况勾选”区分大小写”,选择范围”全部”或”首个”;
- 观察底部「当前查找可匹配 N 处」,用这个数字确认规则没写偏;
- 点”替换全部”或”替换第一个”,看提示里的匹配/替换数量;
- 左右对照检查结果,需要重来就点”撤销”回到原文;
- 确认无误后”复制”或”下载”(
text-replaced.txt)。
先在小样本上跑,是比任何规则都可靠的习惯。截十行出来试,规则对了再上全量——这一步花三十秒,能省掉一次返工。
🔗 和其它文本工具串起来用
替换很少是孤立的一步,常见的是三段式:
- 替换前:文本脏,空行多、行尾带空格、换行符混着 CRLF 和 LF,先过 文本清理。否则你的查找内容里可能藏着看不见的字符,规则怎么写都不命中。
- 替换后:需要核对改动范围,用 文本对比 把替换前和替换后的两份文本对着看,改动一目了然,比逐行读快得多。
- 多步流水线:如果一次要”去空行 → 去重 → 替换 → 加前缀”,用 批量文本处理 把这些步骤排成链,每步都有预览,还能基于原始输入重算,不怕叠加。文本替换里的规则在那边是同一个”替换”步骤,结果一致。
具体到这一篇的定位,它解决的是”同一处改动要重复很多次”的问题,属于文本处理里最基础也最高频的一环。整个 11 个工具的选型逻辑,见 星点文本工具完整指南;如果你的需求是把重复行去掉而不是改写内容,文本去重工具指南 有更对口的做法。
❓ 常见问题
普通模式支持正则吗?
不支持,也不需要。普通模式会把查找内容整体转义,`.`、`*`、`[`、`(` 都按字面字符匹配。想用通配、分组、边界,必须把模式切到"正则"。为什么查找内容不能为空?
空模式在正则里会在每个字符间隙产生零宽匹配,替换后会在每个字之间插入内容,结果难以预期,所以工具直接禁止并给出说明。需要"给每行加东西",请用 `(.+)` 这类能匹配实际内容的规则。替换内容里写 $1 没生效,出来还是 $1?
检查模式。普通模式下 `$1` 是三个普通字符,不解析捕获组;只有在正则模式下、并且查找内容里确实有括号分组时,`$1` 才会被替换成第一组的内容。能匹配每一行的开头吗?
这个工具没有多行(m)开关,`^` 和 `$` 只对应整段文本的首尾。按行处理要靠 `.` 不匹配换行这一点,用 `(.+)` 配合"全部"逐行命中;需要更复杂的分行逻辑,去正则替换工具开 Flags 更合适。替换会覆盖我的原始文本吗?
不会。左侧输入框的内容不会被改写,右侧只是结果。点"撤销"可以把结果区恢复成原文,也可以直接复制原文重新开始。没有保存动作,刷新页面就清空。数据会上传吗?
不会。匹配和替换全部在浏览器本地完成,不上传、不联网、不执行你的输入。内部名单、配置、带手机号的日志都可以直接粘。替换数量显示 1,是不是规则写错了?
先看范围开关。选"首个"时提示的替换数就是 1,这是正常的。想看这条规则总共能命中多少,看输入框下方的「当前查找可匹配 N 处」,那个数字不受范围开关影响。中文能匹配吗?
能,直接写中文就行。但要注意 `\w` 在 JavaScript 里只认 ASCII 字母数字下划线,匹配不了中文,写 `(\w+)` 拿不到中文姓名。匹配中文请直接把字写进规则,或用 `[^,,]+` 这类排除式字符组。💬 收尾
文本替换的价值不在”能替换”,而在于把一次性的手工劳动变成一条可复用的规则。规则写对了,二十处和两千处的工作量是一样的;规则写错了,两千处也会一起错——所以真正需要花时间的是三件事:选对模式、把规则收窄、在按下按钮之前看清匹配数量。
普通模式解决大部分”确定的字词”,正则模式处理”一类模式”,捕获组负责重排内容,左右对照和撤销负责兜底。这四件事想清楚了,剩下的就是照抄场景里的写法。
立即体验:访问 文本替换工具
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!