工程开发
go-i18n
管理 Go CLI 多语言国际化规则,包含语言环境文件结构、基于环境变量的语言检测以及 Key 命名规范。
简介
go-i18n 技能为 Skills-X CLI 提供了一套标准化的国际化管理框架。它专为需要新增用户界面文案、翻译 CLI 输出或更新现有语言文件的开发者所设计,旨在维护仓库的一致性。通过集中化语言检测与翻译逻辑,此技能确保所有 CLI 指令均支持动态语言切换,这对于开发者工具链的全球化普及至关重要。
-
自动处理语言检测优先级,支持 SKILLS_LANG、LANG 与 LC_ALL 环境变量。
-
定义严格的 Key 命名规范,使用如 app_, cmd_, list_, init_, err_ 等分类前缀,以防止冲突并提升可读性。
-
实作双文件语言环境系统 (zh.yaml 与 en.yaml),要求每次新增字符串时必须保持双方同步。
-
整合 Go embed 指令,将翻译数据于构建时直接封装进二进制文件,确保运行时期的高效能与无依赖性。
-
提供 i18n.T 与 i18n.Tf 辅助函数,用于简化字符串检索与格式化消息注入。
-
务必在应用程序启动流程初期使用 i18n.MustInit() 初始化 i18n 模块。
-
同时新增翻译至 zh.yaml 与 en.yaml;若遗失 Key 将会返回原始 Key 名称,此机制可作为内置的除错方式。
-
严禁在单一翻译 Key 中混用中英文;必要时应将字符串拆分为不同组件。
-
修改任何 YAML 设置后,请务必执行完整重建 (make build) 以确保变更被正确封装。
-
使用包含 SKILLS_LANG 环境变量的测试指令,在合并代码前验证字符串是否能正确于支持的语言环境间切换。
仓库统计
- Star 数
- 18
- Fork 数
- 1
- Open Issue 数
- 0
- 主要语言
- Go
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月3日 17:42