工程开发
i18n
LobeHub 国际化助手,用于管理 react-i18next 翻译、键值命名规范及本地化工作流。
简介
i18n 助手是专为简化 LobeHub 生态系统本地化流程而设计的工具。它强制执行严格的开发标准,以确保应用程序中本地化文本的一致性、可维护性和可扩展性。通过直接与 react-i18next 框架集成,它为管理语言文件、实现翻译键值以及遵循项目特定的架构模式提供了明确的指导。
-
标准化使用点符号的扁平键名约定(例如 feature.context.action),以防止冲突并提高清晰度。
-
通过引导开发人员将键值新增至 src/locales/default/ 中的特定命名空间文件来管理翻译工作流。
-
提供在 .tsx 组件中使用 useTranslation 等 react-i18next 钩子的语法指导。
-
强制执行关于文件编辑的严格限制,强调只能修改预设的本地化原始文件,而自动生成的 JSON 文件应严格保留供构建流程使用。
-
支持高级 i18n 功能,例如使用 {{variableName}} 语法进行参数插值。
-
在实现新功能时使用此助手,以确保所有用户可见的字符串都正确抽象化到 i18n 系统中。
-
始终参考命名空间列表(common, chat, setting 等),以确保翻译逻辑分组。
-
请记住,在提交拉取请求之前执行 pnpm i18n 生成脚本,以确保各语言区域的同步一致性。
-
避免在翻译文件中嵌套对象;使用规定的扁平结构来维护架构稳定性。
-
当遇到翻译键冲突或将复杂变量整合到本地化字符串时,请咨询此工具。
仓库统计
- Star 数
- 75,828
- Fork 数
- 15,036
- Open Issue 数
- 740
- 主要语言
- TypeScript
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年4月29日 09:02