人言兑
·
go-i18n 国际化多语言完整使用教程
💡
原文中文，约13800字，阅读约需33分钟。
📝
内容提要
本教程介绍如何在 Go 项目中使用 go-i18n 库实现国际化，包括安装、消息提取、翻译文件管理、运行时加载、Localizer 使用和复数规则等，提供示例代码和 CLI 使用示例。go-i18n 支持 200 多种语言的复数规则，并使用 CLDR 数据确保国际化的准确性。通过 goi18n 工具提取和合并翻译文件，简化多语言支持流程。
🎯
关键要点
- 本教程介绍如何在 Go 项目中使用 go-i18n 库实现国际化支持。
- go-i18n 支持 200 多种语言的复数规则，并使用 CLDR 数据确保国际化的准确性。
- 安装 go-i18n 和 goi18n CLI 工具，便于提取和合并翻译文件。
- Bundle 是运行时的核心容器，包含默认语言和已加载的消息模板。
- Localizer 使用一组语言偏好来选择合适语言并渲染消息。
- goi18n CLI 工具提供 extract 和 merge 功能，用于提取和合并翻译文件。
- 支持多种消息文件格式，包括 TOML、JSON 和 YAML。
- 复数支持基于 CLDR 的规则，确保不同语言的复数形式正确处理。
- 可以使用 go:embed 将消息文件打包到二进制中。
- 提供了完整的示例代码，展示如何在运行时加载翻译文件并本地化消息。
❓
延伸问答
如何在 Go 项目中安装 go-i18n 库？
可以通过在项目中引入 go-i18n（v2）及常用序列化工具来安装，使用命令：go install github.com/nicksnyder/go-i18n/v2/goi18n@latest。
go-i18n 支持哪些消息文件格式？
go-i18n 支持 TOML、JSON 和 YAML 三种消息文件格式。
如何使用 goi18n CLI 提取翻译文件？
使用命令 goi18n extract 可以从 Go 源码中提取 i18n.Message 字面量，生成源语言消息文件。
go-i18n 如何处理复数形式？
go-i18n 使用 CLDR 的复数规则，支持 zero、one、two、few、many 和 other 分类，根据 PluralCount 选择正确的复数形式。
如何在运行时加载翻译文件？
可以通过创建 Bundle 并使用 LoadMessageFile 方法加载翻译文件，例如：bundle.LoadMessageFile("active.es.toml")。
go-i18n 中的 Localizer 是什么？
Localizer 是用于选择合适语言并渲染消息的本地化器，它使用一组语言偏好来确定最终使用的语言。
➡️
