Go语言项目如何做多语言错误消息_Golang错误码与i18n翻译映射-Golang-PHP中文网

错误必须用结构体封装键、参数和翻译能力，因go的error接口仅含error()方法且不支持i18n；推荐使用go-i18n/v2实现按请求隔离的localizederror结构体。

go语言项目如何做多语言错误消息_golang错误码与i18n翻译映射

错误消息不能靠 fmt.Errorf 硬编码，必须用结构体封装键+参数+翻译能力

为什么 error 接口本身不支持 i18n

Go 的 error 接口只规定一个 Error() 方法返回 string，它不携带语言标签、不存占位符、也不支持运行时切换。你写 fmt.Errorf("用户不存在")，日志里永远是中文；写 fmt.Errorf("User not found")，API 返回永远是英文——没有中间态，也没法动态选。

常见错误现象：Error() 返回值被 HTTP 中间件、gRPC 错误码转换、日志采集器直接消费，一旦硬编码，就锁死语言，后续加多语言等于重写所有错误路径。

别在 DAO 层或 model 层调用 fmt.Errorf 或 errors.New 构造带自然语言的错误
别把 context.Context 一路透传到错误构造点再解析 Accept-Language——中间任意一层 panic 或跳过 middleware，locale 就断了
别用全局 *message.Printer 或单例 Localizer，goroutine 不安全，且无法按请求隔离语言

推荐方案：go-i18n/v2 + LocalizedError 结构体

用 github.com/nicksnyder/go-i18n/v2/i18n 是目前最稳的选择：它原生支持按请求绑定语言、CLDR 复数规则、JSON/TOML 文件热加载，且错误键（MessageID）和翻译内容完全解耦。

定义错误类型时，不要重写 Error() 做翻译，而是暴露 Translate(lang string) string 方法：

type LocalizedError struct {
    cause   error
    key     string
    args    map[string]interface{}
}

func (e *LocalizedError) Error() string {
    return e.key // 默认返回键名，方便日志追踪
}

func (e *LocalizedError) Translate(lang string) string {
    cfg := &i18n.LocalizeConfig{
        MessageID:    e.key,
        TemplateData: e.args,
    }
    msg, _ := localizer.Localize(cfg) // localizer 按请求构造
    return msg
}

文件命名必须严格为 active.zh-CN.json，不是 zh.json 或 cn.json，否则 bundle.LoadMessageFile 静默失败
JSON 内容必须含 description 和 translation 字段，仅 {"user_not_found": "用户不存在"} 无效
args 中的 key 名大小写必须与翻译文件中模板变量完全一致，{Name: "Alice"} 对应 "Hello {Name}"，写成 {name: "Alice"} 就不替换

HTTP handler 中如何安全注入语言上下文

语言信息必须在 handler 入口解析并构造 Localizer，而不是让错误自己去猜。错误对象只负责持有键和参数，不碰 HTTP 头、不依赖 context。

Golang Lint

Golang 项目 lint 最佳实践与 golangci‑lint 配置——运行 linter、编辑 .golangci.yml、使用 nolint指令抑制警告。

下载

典型流程：

从 r.Header.Get("Accept-Language") 提取候选语言列表 → 用 language.ParseAcceptLanguage 解析
用 language.NewMatcher(supportedLangs) 匹配第一个合法 language.Tag（如 zh-CN fallback 到 zh）
调 i18n.NewLocalizer(bundle, tag.String()) 得到 request-scoped Localizer
把这个 Localizer 作为参数传给 service 函数，或存入 requestCtx（context.WithValue），但绝不跨 goroutine 复用