生产环境必须用ac自动机，go生态最稳的是github.com/bobusumisu/ahocorasick，它支持unicode、可增量构建、不panic；禁用strings.contains逐条遍历和map[string]struct{}存储，因其无法处理嵌套词和重叠匹配。
敏感字过滤模块该用什么数据结构
直接用 strings.Contains 逐条遍历关键词，性能会随词库增大线性下降，1000个词就明显卡顿。生产环境必须用 AC 自动机（Aho-Corasick），Go 生态里最稳的是 github.com/BobuSumisu/ahocorasick ——它支持 Unicode、可增量构建、不 panic，比 golang.org/x/exp/ahocorasick（已归档）更可靠。
别用 map[string]struct{} 存关键词：无法处理“中”“中国”“中国人”这种包含关系；也别自己写多模式匹配——边界 case 太多，比如“*”通配、“abc|def”正则式、重叠匹配（“ababa”里匹配 “abab” 和 “baba”）。
- 初始化时调用
ahocorasick.NewTrie()构建 Trie 树，再用Build()编译失败函数 - 关键词含特殊字符（如括号、点号）要提前
regexp.QuoteMeta()转义，否则影响 AC 机匹配逻辑 - 如果词库动态更新频繁，用
trie.AddWord()+trie.Build()增量重建，但注意Build()是 O(n) 开销，别在请求中调用
配置加载和热更新怎么设计才不崩
硬编码词库等于放弃维护权。配置必须从文件或远程源加载，且支持热重载——但别用 fsnotify 监听文件改写，它在容器或 NFS 下不可靠；更别用轮询 os.Stat()，浪费 CPU。
推荐方案：启动时加载一次，再通过 HTTP 接口触发重载（如 POST /admin/reload-filter），内部用 sync.RWMutex 保护全局 *ahocorasick.Trie 变量。读操作走 RLock()，写操作用 Lock() + 原子替换指针。
- 配置格式用 YAML 或 JSON，字段至少包含
words（字符串数组）、replace（替换符，默认"*"）、case_sensitive（布尔值） - 加载失败时保留旧 trie，打印错误日志，绝不能 panic 或返回 nil trie
- HTTP 触发热更新接口必须加简单鉴权（如检查
X-Admin-Tokenheader），避免被恶意刷重载
如何正确做匹配与替换而不漏不炸
trie.FindAllStringIndex() 返回所有匹配位置，但直接按位置切片拼接容易出错：如果关键词重叠（如“abab”和“baba”在“ababa”中），多次替换会破坏原始偏移。必须按起始位置排序后，从右往左替换，或用 strings.Builder 一次性构造结果。
另外，纯文本替换可能误伤 HTML 标签（如把 <script></script> 里的 “script” 替换掉），若需保 HTML 结构，得先用 golang.org/x/net/html 解析 DOM，只对 TextNode 做过滤——但这会显著增加开销，除非业务明确要求。
- 替换前统一转小写（若
case_sensitive: false），但记录原始偏移用于定位，别直接对原字符串strings.ToLower() - 避免用
strings.ReplaceAll()循环替换每个词——它会重复扫描全文，O(n×m)，AC 机本意就是避免这个 - 返回结果时，如果业务需要返回“是否命中”+“命中词列表”，就用
trie.FindAllString()，别省略这一步去猜
并发安全与性能陷阱在哪
ahocorasick.Trie 本身是只读结构，构建后无状态，所以多个 goroutine 并发调用 FindAllStringIndex() 完全安全。真正危险的是你封装的全局变量——比如把 trie 放在包级变量里，又没加锁就直接赋值。
另一个坑是内存：一个 10 万词的 trie 占用约 20–30MB 内存，如果每次请求都 new 一个 trie（比如误写成闭包捕获 config 重新构建），GC 压力会陡增。必须确保 trie 实例全局唯一、复用。
- 用
sync.Once做初始化保护，但仅限首次加载；热更新时走 mutex 替换指针，不是重新 new - 压测时重点看
runtime.ReadMemStats().HeapAlloc，如果每秒上涨几百 MB，大概率是 trie 被反复创建 - 如果 QPS 过万且词库超 5 万，考虑分 shard：按首字符哈希到不同 trie 实例，但会牺牲部分跨首字匹配能力（如“上海”“海上”），需权衡
配置不是越灵活越好，字段多了反而难维护；替换逻辑不是越复杂越安全，多数场景一行 trie.FindAllStringIndex(input) 就够用。真正卡住人的，永远是热更新时的竞态和词库加载失败的降级策略。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
