文本替换工具 - 查找替换与正则替换(捕获组、预览、撤销)

5847 字
29 分钟
文本替换工具 - 查找替换与正则替换(捕获组、预览、撤销)

🔁 一件干了十年还在手动点的事#

运维改一份 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/order
2026-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 这种标志配合。正则语法本身不熟的话,星点正则工具完整指南 里有从语法到调试的整套工具,先在那儿把规则调通,再拿回来批量跑,是个更稳的顺序。

🛠 操作步骤#

  1. 打开 文本替换工具,左侧粘贴要处理的原文;
  2. 在”查找”框填要改的内容,“替换为”框填新内容;
  3. 选择模式:普通文本(字面量)或正则;
  4. 视情况勾选”区分大小写”,选择范围”全部”或”首个”;
  5. 观察底部「当前查找可匹配 N 处」,用这个数字确认规则没写偏;
  6. 点”替换全部”或”替换第一个”,看提示里的匹配/替换数量;
  7. 左右对照检查结果,需要重来就点”撤销”回到原文;
  8. 确认无误后”复制”或”下载”(text-replaced.txt)。

先在小样本上跑,是比任何规则都可靠的习惯。截十行出来试,规则对了再上全量——这一步花三十秒,能省掉一次返工。

🔗 和其它文本工具串起来用#

替换很少是孤立的一步,常见的是三段式:

  • 替换前:文本脏,空行多、行尾带空格、换行符混着 CRLF 和 LF,先过 文本清理。否则你的查找内容里可能藏着看不见的字符,规则怎么写都不命中。
  • 替换后:需要核对改动范围,用 文本对比 把替换前和替换后的两份文本对着看,改动一目了然,比逐行读快得多。
  • 多步流水线:如果一次要”去空行 → 去重 → 替换 → 加前缀”,用 批量文本处理 把这些步骤排成链,每步都有预览,还能基于原始输入重算,不怕叠加。文本替换里的规则在那边是同一个”替换”步骤,结果一致。

具体到这一篇的定位,它解决的是”同一处改动要重复很多次”的问题,属于文本处理里最基础也最高频的一环。整个 11 个工具的选型逻辑,见 星点文本工具完整指南;如果你的需求是把重复行去掉而不是改写内容,文本去重工具指南 有更对口的做法。

❓ 常见问题#

普通模式支持正则吗? 不支持,也不需要。普通模式会把查找内容整体转义,`.`、`*`、`[`、`(` 都按字面字符匹配。想用通配、分组、边界,必须把模式切到"正则"。
为什么查找内容不能为空? 空模式在正则里会在每个字符间隙产生零宽匹配,替换后会在每个字之间插入内容,结果难以预期,所以工具直接禁止并给出说明。需要"给每行加东西",请用 `(.+)` 这类能匹配实际内容的规则。
替换内容里写 $1 没生效,出来还是 $1? 检查模式。普通模式下 `$1` 是三个普通字符,不解析捕获组;只有在正则模式下、并且查找内容里确实有括号分组时,`$1` 才会被替换成第一组的内容。
能匹配每一行的开头吗? 这个工具没有多行(m)开关,`^` 和 `$` 只对应整段文本的首尾。按行处理要靠 `.` 不匹配换行这一点,用 `(.+)` 配合"全部"逐行命中;需要更复杂的分行逻辑,去正则替换工具开 Flags 更合适。
替换会覆盖我的原始文本吗? 不会。左侧输入框的内容不会被改写,右侧只是结果。点"撤销"可以把结果区恢复成原文,也可以直接复制原文重新开始。没有保存动作,刷新页面就清空。
数据会上传吗? 不会。匹配和替换全部在浏览器本地完成,不上传、不联网、不执行你的输入。内部名单、配置、带手机号的日志都可以直接粘。
替换数量显示 1,是不是规则写错了? 先看范围开关。选"首个"时提示的替换数就是 1,这是正常的。想看这条规则总共能命中多少,看输入框下方的「当前查找可匹配 N 处」,那个数字不受范围开关影响。
中文能匹配吗? 能,直接写中文就行。但要注意 `\w` 在 JavaScript 里只认 ASCII 字母数字下划线,匹配不了中文,写 `(\w+)` 拿不到中文姓名。匹配中文请直接把字写进规则,或用 `[^,,]+` 这类排除式字符组。

💬 收尾#

文本替换的价值不在”能替换”,而在于把一次性的手工劳动变成一条可复用的规则。规则写对了,二十处和两千处的工作量是一样的;规则写错了,两千处也会一起错——所以真正需要花时间的是三件事:选对模式、把规则收窄、在按下按钮之前看清匹配数量。

普通模式解决大部分”确定的字词”,正则模式处理”一类模式”,捕获组负责重排内容,左右对照和撤销负责兜底。这四件事想清楚了,剩下的就是照抄场景里的写法。

立即体验:访问 文本替换工具

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

相关文章 智能推荐
1
正则替换怎么用 - 在线正则表达式批量替换工具
正则工具 正则替换怎么用?在线正则表达式替换工具支持 $1、$&、$<name> 等替换引用,实时显示替换前后文本与替换次数。含日期改写、去空格、加前缀、键值重排等 10+ 场景示例与 FAQ,浏览器本地处理。
2
文本行号工具 - 批量添加、移除与重建行号
文本工具 文本行号工具指南:给清单、代码片段、日志批量添加行号,可设起始值、步长、分隔符、补零、前缀并选择是否给空行编号;按 1.、1)、1:、数字加空格或自定义正则移除编号,移除前先看匹配行数;支持拆掉旧编号后按新规则重建。含补零宽度、行首数字被误删的真实原因、常见错误与 FAQ。
3
文本排序工具 - 字符、数字与自然排序(中文/文件名友好)
文本工具 在线文本排序工具指南:讲清字符串(语言感知)、数字、自然三种排序模式的差别,用同一组数据对照 2 与 10、file2 与 file10、中文姓名的实际结果;说明升序降序、忽略大小写、中文拼音排序、空行排前排后与稳定排序各管什么,附 Excel 文本列排序、混合内容误判数字等常见错误、操作步骤与 FAQ,全程浏览器本地处理。
4
文本分割与合并工具 - 按分隔符拆分、按行合并
文本工具 在线文本分割与合并工具使用指南:按换行、字面分隔符或正则把一段文本拆成条目,可输出每行一条或 JSON 数组;也能把多行按逗号、空格、分号、竖线、制表符或任意文本拼成一段。覆盖保留与移除空项、每项 trim、最大分割次数、忽略空行、前缀后缀与整体包裹,并说明分隔符按字面处理、. | * 不是正则、JSON 标准序列化,以及 CSV 字段内逗号、多余分隔符、下标错位、中文逗号四个常见错误。浏览器本地处理。
5
批量文本处理工具 - 多步骤清洗文本(去空行/去重/排序/替换)
文本工具 在线批量文本处理工具使用指南:把去空白、删空行、压缩空行、去重、排序、大小写、替换、添加或删除行号、换行符标准化、每行前后缀这 12 种步骤串成一条可重复执行的清洗链,支持逐步预览与变更数量统计,某一步失败会指出步骤名并停下,结果始终基于原始输入重算,不会叠加行号或前缀。含步骤顺序对照实测、三套可直接套用的步骤链与常见错误,浏览器本地处理。
随机文章 随机推荐
公告
🎉 已升级 2.0 版本,欢迎使用。
分类
标签
站点统计
文章
247
分类
31
标签
973
总字数
633,901
运行时长
0 天
最后活动
0 天前

目录