Go strings.Replacer 怎样一次替换多组固定文本

在我整理文本入口时，最容易失控的不是替换本身，而是规则散落在多次 strings.ReplaceAll 调用里：规则一变，前后顺序就可能互相影响。需要同时处理多组固定字符串时，直接用 strings.NewReplacer 建立一个可复用的替换对象更清楚。

官方地址：https://pkg.go.dev/strings#NewReplacer

这篇只讨论固定文本的 old/new 成对参数、重叠匹配的顺序和 Replacer 的复用，不把正则表达式规则混进来。

先把多组规则集中起来

NewReplacer 接收交替出现的 old、new 字符串，例如 "内部"、"公开" 是一组，"草稿"、"正式" 是另一组。这样规则表和执行入口分开，后续阅读时能一眼看出哪些词会被替换。

我更倾向于在处理器初始化阶段创建 Replacer，让同一套规则服务多次输入。官方文档说明 Replacer 可以安全地被多个 goroutine 并发使用；这适合只读规则、重复处理文本的场景。规则如果来自用户输入，仍应先做业务层面的白名单和长度限制。

重叠键要提前安排顺序

多组规则最值得注意的是重叠键。假设输入里同时可能出现 golang 和 go，就把更具体的长键放在前面：

package textnormalizer

import "strings"

// NormalizeName 把固定别名集中转换，避免多次 ReplaceAll 互相改写。
func NormalizeName(input string) string {
	// 长键放在短键前面，避免短键先截走同一位置的匹配。
	r := strings.NewReplacer(
		"golang", "Go",
		"go", "G",
		"内部", "公开",
		"草稿", "正式",
	)
	return r.Replace(input)
}

官方规则是：替换按它们在目标文本中的位置处理，不产生重叠替换；同一位置有多个 old 字符串时，比较顺序由参数顺序决定。因此不要把参数顺序当作无关紧要的排版，长键、短键或带前缀的规则应先按产品语义排好。

在入口选择 Replace 还是 WriteString

需要得到新字符串时用 Replace 最直接；如果已经有一个 io.Writer，可以用 WriteString 直接写入，减少额外的中间拼接层。两者都应把 Replacer 作为规则对象，而不是每次调用都重新组织一遍参数。

package textnormalizer

import (
	"fmt"
	"strings"
)

// WriteNormalized 将归一化文本写入目标 writer，并保留写入错误。
func WriteNormalized(dst *strings.Builder, input string) error {
	r := strings.NewReplacer("内部", "公开", "草稿", "正式")
	// WriteString 返回写入错误；这里不把失败静默当成成功。
	if _, err := r.WriteString(dst, input); err != nil {
		return fmt.Errorf("写入归一化文本失败: %w", err)
	}
	return nil
}

上面的 strings.Builder 只是为了展示 io.Writer 边界，示例没有在本机执行。实际服务中可把 Replacer 放到配置对象或处理器中复用；如果规则需要按租户动态变化，就让每个配置快照拥有自己的 Replacer，不要在并发请求之间修改同一份规则。

规则维护不要靠串联清洗

把所有替换串成一长串调用，看起来简单，却会把前一次输出变成后一次输入。例如一条规则产生了另一个规则的 old 文本，结果就不再由原始输入直观决定。多组固定规则应维护在同一张表里，按匹配边界排序，并为重叠项写清注释。

如果需求出现通配符、捕获组、大小写条件或动态替换内容，就应单独评估正则表达式或自定义扫描逻辑，不要把用户输入直接拼进 NewReplacer。固定替换的好处正是边界简单：规则是明确的字符串对，输入输出可按表追踪。

常见疑问

NewReplacer 的参数必须是偶数吗？

是。参数按 old、new 成对解释，传入奇数个参数会触发 panic。因此规则来自切片或配置文件时，应在构造前检查长度和空键策略。

同一个 Replacer 能跨请求复用吗？

可以，前提是规则对象构造完成后不再修改，并且业务允许所有请求使用同一组固定规则。租户规则或热更新规则应切换完整对象，而不是边处理边改参数。

为什么不用多次 ReplaceAll？

单条规则用 ReplaceAll 没问题；当规则达到多组且存在重叠键时，NewReplacer 能把规则集中表达，并把参数顺序作为显式设计的一部分，减少串联调用带来的隐含影响。