Go regexp.Regexp.ReplaceAllStringFunc 怎样保留动态替换逻辑

如果替换结果要根据“当前匹配到的文本”临时计算，直接写死 ReplaceAllString 的第二个参数通常会把问题绕复杂。更合适的做法是使用 Regexp.ReplaceAllStringFunc：正则负责找出每个匹配，回调接收这个匹配并返回最终字符串。回调返回值会被直接放回原文，不会再次按 $1、${name} 解释。

记住一个迁移判断：固定结果用 ReplaceAllString，结果依赖匹配内容用 ReplaceAllStringFunc；如果返回文本里可能出现美元符号，函数式替换还能避免模板展开带来的意外。

先区分三种替换语义

旧代码最容易混淆的是“替换文本”和“替换函数”。ReplaceAllString 接受一个字符串模板，其中的美元符号可引用捕获组；ReplaceAllLiteralString 把替换字符串当作字面量；ReplaceAllStringFunc 则把每个完整匹配传给回调，回调返回什么就插入什么。

把动态逻辑放进 ReplaceAllStringFunc

下面的场景是把文本中的版本号统一成带标签的形式。回调只接收当前命中，例如 v1.2，因此可以先拆出数字，再决定输出。示例中的计数器用于展示调用关系；生产代码若不需要统计，应让回调保持纯函数，减少并发使用时的共享状态。

package main

import (
	"fmt"
	"regexp"
	"strconv"
	"strings"
)

func main() {
	// 只匹配 v 加数字和点组成的版本片段。
	re := regexp.MustCompile(`v[0-9]+(?:\.[0-9]+)+`)
	input := "客户端 v1.2，服务端 v2.10，文档保持原样。"

	result := re.ReplaceAllStringFunc(input, func(match string) string {
		// 去掉 v 后按点拆分，回调返回值会直接替换当前命中。
		parts := strings.Split(strings.TrimPrefix(match, "v"), ".")
		major, err := strconv.Atoi(parts[0])
		if err != nil {
			// 解析失败时保留原匹配，避免替换逻辑扩大损失。
			return match
		}
		return fmt.Sprintf("版本%d.%s", major, strings.Join(parts[1:], "."))
	})

	fmt.Println(result)
}

这个回调的输入是完整匹配，不是捕获组数组。如果需要捕获组参与计算，可以在回调内部再次使用一个更小的表达式解析，或者改用 FindAllStringSubmatch 先拿到结构化结果再自行拼接；不要误以为 ReplaceAllStringFunc 会把组参数自动传给函数。

为什么返回值里的 $ 不会再次展开

这是从 ReplaceAllString 迁移到函数式替换时最值得确认的差异。模板替换会把第二个参数当作模板处理，所以 $1 可能表示第一个捕获组；函数式替换把回调返回的字符串当作最终文本，不会再调用模板展开逻辑。

package main

import (
	"fmt"
	"regexp"
)

func main() {
	// 捕获数字只是为了展示：函数式替换不会把返回字符串里的 $1 当作组引用。
	re := regexp.MustCompile(`(USD)([0-9]+)`)
	input := "价格 USD20，折扣 USD5。"

	output := re.ReplaceAllStringFunc(input, func(match string) string {
		// 返回含 $ 的字面文本，适合需要保留占位符的场景。
		return "${保留}" + match
	})

	fmt.Println(output)
}

如果你的目标只是把所有命中改成固定字面量，也可以使用 ReplaceAllLiteralString。选择 ReplaceAllStringFunc 的理由，是替换文本确实需要读取匹配值，或者返回值来自一个计算过程。

迁移时的回归检查

1. 检查空匹配：确认正则不会在相邻位置产生你不需要的空匹配，必要时收紧量词。
2. 检查错误输入：不要把外部正则直接交给 MustCompile；配置来自用户时用 Compile 返回错误。
3. 检查副作用：回调可能被调用多次，不要依赖调用顺序去修改关键业务状态。
4. 检查字节与字符：正则包按 UTF-8 处理字符串，回调收到的是字符串，不要把它当作字节偏移量。
5. 检查原文保留：没有命中的片段会留在结果中，回调只负责替换命中部分。

若正则表达式本身来自配置，推荐把编译动作放在配置加载阶段；若只是把固定占位符替换成固定值，则优先选择字面量 API，避免为了一个简单替换引入回调。

常见问题

ReplaceAllStringFunc 能直接拿到捕获组吗？

不能。回调签名是 func(string) string，参数是完整匹配。要使用捕获组，可以在回调内部解析匹配，或改用带 submatch 的查找方法自行组装输出。

回调返回空字符串会怎样？

当前匹配会被删除，未匹配的原文仍会保留。这个行为适合按条件过滤文本，但要先确认正则不会误命中过宽的范围。

小结：把查找规则交给 regexp，把每个命中的业务决策交给回调；尤其留意函数式替换返回值不会触发 $ 模板展开，这正是它与固定模板替换的核心边界。