工程开发
i18n avatar

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
在 GitHub 查看