不能用 map[rune]*Node 构建中文敏感词 Trie 树，因 UTF-8 下 []byte 遍历会切碎中文导致匹配失效或 panic，必须统一用 []rune；且 children 未初始化易 panic、isEnd 误设致误杀、并发游标需独立、热更新需安全访问封装。
直接用 map[rune]*Node 构建 Trie 树，在 10 万+ 敏感词、高并发场景下会内存暴涨、构建超慢、GC 压力大，不是性能瓶颈，是设计缺陷。
为什么不能用 map[rune]*Node 处理中文敏感词
Go 字符串默认 UTF-8 编码，一个中文字符占 3 字节，[]byte 遍历会切碎“王”成三个非法字节单元，导致匹配失效或 panic。必须统一用 []rune：
- 插入词库时：
for _, r := range []rune(word)，不是for i := range word - 扫描文本时：
chars := []rune(text)，再for i, r := range chars - 若源头是 GBK/Big5 日志，别在匹配前用
golang.org/x/text/encoding转码——同步开销大、易成瓶颈；应在读取阶段就解码为 UTF-8[]byte，或改用基于[]byte的双数组 Trie 实现
isEnd = true 写错位置会导致误杀率飙升
常见错误是在循环中每走一步都设 node.isEnd = true，结果“王八蛋”路径上，“王”“王八”“王八蛋”全被标为结尾。用户输“王者”，系统立刻拦截。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 正确做法：只在完整遍历完
[]rune(word)后，对最终节点赋值node.isEnd = true - 如需支持前缀敏感（“王八”和“王八羔子”都算违规），必须新增字段如
isPrefix bool，不可复用isEnd - 初始化时
children是 nil 很正常，每次访问前必须判空：if node.children == nil { node.children = make(map[rune]*Node) }
并发匹配时游标必须 per-query 独立
sync.Pool 对 AC 或 Trie 匹配状态复用意义不大——树结构只读，但当前节点指针、已匹配长度、路径深度等状态必须每个请求独占，否则并发下相互覆盖。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
matcher := pool.Get().(*Matcher); matcher.Search(text)，且未重置内部游标 - 正确做法：每次
Search()都从root开始；或显式传入干净的上下文结构体，含current *Node字段 - 匹配逻辑不能一碰到
isEnd == true就return——否则“王八羔子坏”只命中“王八”，漏掉更长词；需支持重叠匹配，找到后重进树继续扫
热更新词库时 node.children 容易 panic
本地小数据测不出，压测时突然 panic: assignment to entry in nil map，堆栈指向 AddChild 或匹配循环里的 node.children[char]——这是访问了未初始化的 map[rune]*Node。
- 并发加载、热更新、配置变更都可能让某分支的
children仍是 nil，不能依赖“一次初始化就万事大吉” - 最稳妥的是封装访问方法：
func (n *Node) setChild(r rune, child *Node)，内部统一判空并初始化 - 真正难的不是建树，是让树在高并发、热更新、中英文混排、emoji 穿插的线上环境里不 panic、不漏词、不误杀
