LocalizeConfig 需设置 TemplateData（非 nil map/导出 struct）和 PluralCount（float64 类型），翻译文件用 {{.Name}} 语法并按 CLDR 定义复数类别，language.Tag 必须精确解析（如 "zh-CN"）。
go-i18n/v2 的 LocalizeConfig 怎么配才能支持变量插值？
变量插值不是开箱即用的魔法，必须显式启用并匹配模板语法。go-i18n/v2 默认支持 text/template 语法，但如果你用错字段名或漏传参数，Localizer.Localize 会静默返回原始 key 或空字符串。
- 翻译文件里必须用
{{.Name}}、{{.Count}}这种点号引用，不能写成{Name}或$name -
LocalizeConfig的TemplateData字段要传 map 或 struct，键名必须和模板中一致（区分大小写） - 若传 struct，字段需导出（首字母大写），且最好加
jsontag 方便调试：type MsgData struct { Name string `json:"name"` Count int `json:"count"` } - 别把
TemplateData设成nil—— 即使翻译文本不含占位符，设空 map 也比不设更安全
为什么复数（plural）插值总 fallback 到默认语言？
CLDR 复数规则不是靠字符串判断的，而是依赖 language.Tag 和数值本身共同决定。直接传 "2" 字符串或没指定 PluralCount 字段，go-i18n/v2 就无法匹配复数形式。
- 翻译文件中必须定义
one、other等 CLDR 复数类别，例如："item_count": { "one": "一个项目", "other": "{{.Count}} 个项目" } - 调用
Localize时，LocalizeConfig必须设置PluralCount: float64(n)，不能传 int 或 string - 中文虽无语法复数，但
language.Chinese的 matcher 仍会走other分支；阿拉伯语等需zero/two等更多分支，得按 CLDR 规范写全 - 检查
language.Tag是否准确：用language.Parse("zh-CN")，别用"zh"或"zh_CN"—— 后者不被识别，直接 fallback
动态插值 + RTL（如阿拉伯语）怎么不出乱码或顺序错？
RTL 不是渲染层的事，而是文本生成阶段就要处理的方向嵌入。go-i18n/v2 本身不操作 Unicode BIDI 控制符，得靠你提前在模板或数据里注入 （LRO）或 （RLO）。
- 阿拉伯语翻译文本中，若含英文变量（如用户名
{{.Name}}），应在模板里包裹：مرحباً{{.Name}}，否则浏览器可能把名字左对齐 - 别依赖前端 CSS 的
direction: rtl兜底——它只影响块级布局，不影响内联文本流 - 测试时用真实 RTL 语言 tag：
language.Parse("ar-SA")，别用language.Arabic（它是宏语言，匹配精度低） - JSON/TOML 文件保存为 UTF-8 无 BOM 格式，Go 加载时才不会因编码问题截断 Unicode 字符
热重载翻译文件后插值失效或 panic 怎么办？
热重载只刷新消息内容，不重建 Bundle 结构。如果新文件语法错误（比如多了一个逗号、字段名拼错），bundle.Reload 会静默失败，后续 Localize 调用就可能 panic 或返回空。
立即学习“go语言免费学习笔记（深入）”；
- 每次
Reload后，务必检查err：if err := b.Reload(); err != nil { log.Printf("reload fail: %v", err) } - 不要在生产环境用
os.DirFS("./locales")直接热加载 —— embed 打包后fs.Stat返回 error，Reload不报错也不生效 - 插值 panic 常见于模板解析阶段：比如
{{.Name | printf "%s"}}中.Name是 nil，应改用{{with .Name}}{{. | printf "%s"}}{{end}} - 上线前用
goi18n lint命令校验所有.json文件结构，尤其检查description字段是否存在（v2 强制要求）
{{.Name}}，而是确保从 Accept-Language 解析、tag 匹配、bundle 加载、template 编译到 runtime 插值，每个环节都按 go-i18n/v2 的契约执行——漏掉任意一环，插值就变成不可见的静默失败。 
