nunu 多语言最佳实践

[zbing3]

nunu 在多语言方面有什么最佳实践么？帮忙分享一下呗？

[codingcn]

依据我个人经验，i18n主要分为三种场景（欢迎补充）：

场景一：服务端错误响应多语言

比如在多语言系统中，用户登录业务中服务器返回密码错误的msg，客户端直接弹出服务端响应的msg

解决方案：

可以直接集成下这个项目https://github.com/nicksnyder/go-i18n。

实现步骤非常简单，可以自己动手实操下。这个只讲解主要的集成步骤

1. 在项目中创建多语言文件，支持JSON, TOML, YAML

示例：i18n/zh-Hans.json

{
  "err.100": "记录不存在",
  "err.101": "参数生成出错",
  "err.102": "COS 上传失败",
}

2. 在internal/repository/repository.go中初始化注册i18n多语言文件
3. 添加一个http中间件读取客户端传递过来的地区标识并写到gin.Context中，一般是从http header中传参到服务器
4. 自己修改下v1.HandleError的实现，根据context中语言标识，重写为相应的语言msg

场景二：服务端动态内容多语言

比如一个多语言博客网站，中国的用户访问，会看到中文的博客内容，美国用户访问会看到英文的博客内容。

解决方案一：

服务端提前将每篇文章翻译好存在数据库，服务器根据客户端传过来的地区标识返回不同语言的文章。

我们可以借助gorm的Preload方法，很轻易的实现多语言联表读取。

model/article.go

type ArticleLang string

const (
	ArticleLangZhHans ArticleLang = "zh-Hans"
	ArticleLangZhHant ArticleLang = "zh-Hant"
	ArticleLangEn     ArticleLang = "en"
	ArticleLangJa     ArticleLang = "ja"
	ArticleLangFr     ArticleLang = "fr"
	ArticleLangEs     ArticleLang = "es"
	ArticleLangDe     ArticleLang = "de"
	ArticleLangRu     ArticleLang = "ru"
	ArticleLangKo     ArticleLang = "ko"
         // ...
)


// 文章表
type Article struct {
	ID           uint `gorm:"primarykey"`
        // 可以选择将原文的标题内容存到这。当然也可以不存这个表，也放到ArticleTranslation表去
	Title         string        
	Description  string         
        Content  string         
	Translation  ArticleTranslation
}


// 文章多语言翻译表，每种语言一条记录
type ArticleTranslation struct {
	ID            uint `gorm:"primarykey"`
	ArticleID  uint
	Lang         ArticleLang
	Title          string     
	Description   string     
        Content  string     
}

internal/repository/article.go

// lang 的获取是从http中间件中获取到的，然后存到`gin.Context`，参考场景一中的步骤
func (r categoryRepository) GetArticles(ctx context.Context, lang  model.ArticleLang) ([]*model.Article, error) {
	list := make([]*model.Article, 0)
	if err := r.DB(ctx).Preload("Translation", "lang = ?", lang).Find(&list).Error; err != nil {
		return nil, err
	}
	return list, nil
}

提示：如果需要更新文章，则两个表都需要同时新增相应的记录，可以异步调用翻译API往ArticleTranslation插入翻译结果。

解决方案二：

集成一些实时翻译工具，每次都进行实时翻译后才返回客户端。虽然可以通过缓存优化，但还是不推荐。

场景三：客户端一些按钮界面的多语言支持

解决方案：

通常客户端的界面都是死的，所以直接让客户端那边自己维护多语言文件，自行适配。