通过定义结构化错误类型AppError，将错误码与参数分离，实现错误信息与代码逻辑解耦；2. 使用JSON或YAML文件管理多语言错误消息，按语言分类并加载到内存查找表；3. 构建Localizer服务，根据请求语言标签查找并格式化错误消息模板；4. 在HTTP中间件中解析Accept-Language头确定语言偏好，统一渲染AppError为对应语言的错误提示。该方案实现Go项目中错误信息的国际化，提升可维护性与用户体验。
在Go语言项目中实现错误信息的国际化（i18n），关键在于将错误提示从代码逻辑中解耦，并根据用户的语言环境动态返回对应语言的错误消息。直接在代码中硬编码错误字符串不利于多语言支持，也不便于维护。下面介绍一种实用且易于集成的错误信息国际化处理方式。
使用 errors 包与 i18n 资源分离
Go 的 errors 包或更强大的 github.com/pkg/errors 提供了错误包装能力，但它们本身不支持多语言。我们可以定义一种结构化错误类型，将错误码与参数分离，而不是直接存储错误消息。
例如：
type AppError struct {
Code string
Params []interface{}
Cause error
}
这样，错误不再包含具体文本，而是通过 Code 指向一个资源键，Params 用于填充变量，比如“用户 {0} 不存在”。
立即学习“go语言免费学习笔记（深入）”；
管理多语言资源文件
将不同语言的错误消息存储在 JSON 或 YAML 文件中，按语言分类。例如：
// i18n/zh-CN/errors.json
{
"user_not_found": "用户 %s 不存在",
"invalid_input": "输入参数无效"
}
// i18n/en-US/errors.json
{
"user_not_found": "User %s not found",
"invalid_input": "Invalid input parameters"
}
启动时加载这些资源到内存中，构建一个以语言为键、错误码映射为值的查找表。可以使用 sync.Once 保证只加载一次。
实现本地化错误消息渲染
定义一个 Localizer 服务，根据当前请求的语言标签（如 zh-CN、en-US）查找对应的错误消息模板，并格式化参数。
示例方法：
func (l *Localizer) Localize(err *AppError, lang string) string {
template, exists := l.translations[lang][err.Code]
if !exists {
return err.Code // 或 fallback 到默认语言
}
return fmt.Sprintf(template, err.Params...)
}
在 HTTP 中间件中解析 Accept-Language 头，确定用户语言偏好，传入 Localizer。
实际使用示例
在业务逻辑中创建错误时只指定错误码和参数：
if user == nil {
return &AppError{
Code: "user_not_found",
Params: []interface{}{username},
}
}
在返回响应前，统一拦截 AppError 类型错误，调用 Localizer 渲染成目标语言的文本。
例如在 Gin 或 Echo 框架中使用统一错误处理中间件：
c.JSON(400, gin.H{
"error": localizer.Localize(appErr, lang),
})
基本上就这些。通过错误码驱动、资源外置、运行时渲染的方式，Go 项目可以实现灵活、可维护的错误信息国际化，同时保持代码清晰和性能可控。
