go-i18n v2 中 localize 是 i18n.Localizer 方法而非全局函数，需先创建 bundle、加载 active..json 资源、再调用 bundle.NewLocalizer；JSON 格式须严格符合 schema，文件名须匹配语言标签，缺失翻译默认返回 key，启用 WithDebug(true) 可定位问题。
go-i18n v2 为什么找不到 localize 函数
因为 go-i18n 在 v2 版本（即 github.com/nicksnyder/go-i18n/v2/i18n）中彻底重构了 API，localize 不再是顶层函数，而是 *i18n.Localizer 实例的方法。直接调用 localize("hello") 会报 undefined: localize。
- 必须先创建
*i18n.Bundle，再加载语言资源文件（如active.en.json），最后用bundle.NewLocalizer实例化本地化器 - 资源文件路径必须是绝对路径或相对于
os.Getwd()的有效路径；相对路径写错会导致no translation found - v2 不再自动 fallback 到默认语言，需显式传入
Language列表，例如[]string{"zh-CN", "en"}
如何正确加载 JSON 格式的多语言资源文件
go-i18n v2 只支持 JSON 和 TOML，且 JSON 必须严格符合其 schema：外层是对象，每个 key 是 message ID，value 是带 description 和 translation 的对象。格式不对会静默失败，不报错但返回空字符串。
- 正确结构示例：
{"hello": {"description": "greeting", "translation": "你好"}} - 文件名必须匹配语言标签规范，比如
active.zh-CN.json，不能写成zh.json或zh_CN.json，否则bundle.ParseFS找不到 - 用
bundle.ParseFS加载时，传入的fs.FS必须包含完整路径前缀；如果用os.DirFS("./locales")，那文件就得放在./locales/active.zh-CN.json - 别把
active.*.json和inactive.*.json混放——只有active前缀的才会被自动加载
HTTP 请求中怎么动态切换语言而不重启服务
不能每次请求都新建 *i18n.Localizer，它不是 goroutine-safe 的，且初始化开销大；也不能全局单例一个 localizer，因为语言要随请求变化。
- 推荐做法：全局持有一个
*i18n.Bundle，每个请求根据Accept-Language或 URL 参数（如?lang=ja）调用bundle.NewLocalizer创建临时 localizer -
bundle.NewLocalizer很轻量，只要 bundle 已预加载好资源，它只是做一次 map 查找，可安全用于高并发场景 - 注意缓存
Accept-Language解析结果，避免重复调用language.Parse；用language.Make构造 tag 比字符串拼接更可靠 - 如果用了 Gin/Echo，把 localizer 注入到 context 中比塞进 struct field 更清晰，也方便中间件统一处理
为什么 localizer.Localize 返回空字符串或原始 key
最常见原因是 message ID 在当前语言资源里根本不存在，而 go-i18n 默认行为是返回 key 本身（不是报错）。这会让 bug 隐蔽：界面突然显示 login_button 而不是按钮文字，却没有任何日志提示。
立即学习“go语言免费学习笔记（深入）”；
- 启用 debug 模式：初始化 bundle 时加
i18n.WithDebug(true)，缺失翻译时会 panic 并打印堆栈 - 检查
localizer.Localize(&i18n.LocalizeConfig{MessageID: "xxx"})的返回 error —— 它只在严重错误（如 message ID 类型非法）时非 nil，缺失翻译不会报错 - 确保传给
LocalizeConfig的MessageID和 JSON 文件里的 key 完全一致，包括大小写和下划线 - 如果用了复数（
plural）或占位符（one/other），JSON 结构必须嵌套正确，否则整个 message 被跳过
真正麻烦的不是配置多，而是所有环节都“静默成功”：路径对不上、key 写错、语言 tag 格式不对、JSON 缺字段……全都不报错，只默默回退到 key。上线前最好用脚本扫一遍所有模板里出现的 message ID，和资源文件做 diff。
