如何给iloader添加新语言i18next.ts与locales目录完整翻译流程【免费下载链接】iloaderUser friendly sideloader项目地址: https://gitcode.com/GitHub_Trending/iloa/iloaderiloader 是一款面向 Apple 设备的友好侧载工具User friendly sideloader。本文带你走完 iloader 添加新语言的完整翻译流程只需在 src/i18next.ts 注册语言、在 src/locales/ 目录新增一个 JSON 文件就能为项目贡献你母语的界面翻译全程无需改动后端代码。iloader 的多语言架构i18next.ts 如何驱动 locales 目录iloader 的前端基于 React国际化由 i18next 生态驱动依赖见 package.json 中的i18next与react-i18next。整个体系只有两个核心位置语言注册表src/i18next.ts 中的languages数组每一项是「语言代码 显示名」如[zh_cn, Simpified Chinese 简体中文)]翻译资源文件src/locales/ 下的 26 个 JSON 文件一个语言一个文件如 src/locales/en.json、src/locales/zh_cn.jsoni18next.ts通过import.meta.glob(./locales/*.json)自动扫描并加载locales 目录下的所有 JSON文件名去掉.json后缀直接成为语言代码。这意味着只要新文件放进目录i18n 就能识别它无需手动 import。同时配置了fallbackLng: en——任何未翻译的词条都会自动回退到英文界面不会出现空白。添加新语言的 3 个步骤最快路径官方 README.md 的 Translating 章节也给出了同样的指引。以添加葡萄牙语欧洲为例第一步在 i18next.ts 中注册语言打开 src/i18next.ts在languages数组中追加一行语言代码建议使用「小写语言码_地区码」风格参考现有的zh_tw、pt_br、cs_cz命名const languages [ // ... 现有语言 [pt_pt, Português (Portugal)] ] as const;该列表会被导出为sortedLanguages并直接渲染到设置页的语言下拉框中见 src/pages/Settings.tsx。第二步复制 en.json 生成新语言文件将 src/locales/en.json 复制为src/locales/pt_pt.json文件名必须与第一步的语言代码一致。这样能获得一份结构完整的模板避免漏掉任何界面词条。第三步翻译 JSON 内容翻译文件采用嵌套分组结构如common通用按钮、app应用框架、apple_id登录、settings设置等。翻译时注意两点保持键名与层级完全不变只改英文值保留插值变量例如active_device: Active: {{name}}中的{{name}}是动态数据占位符需原样保留完成后用 package.json 中的dev脚本启动项目在设置页语言下拉框中选择你的语言确认界面即时切换生效即可。语言如何生效切换、记忆与回退机制翻译提交后用户侧的体验由三部分保障自动检测i18next 搭配LanguageDetector插件首次启动时自动识别浏览器系统语言持久记忆设置页通过 Tauri Store 插件将lang写入本地存储重启应用仍保持你选择的语言英文兜底fallbackLng: en保证个别漏翻词条不会破坏界面常见问题语言代码命名没有规律吗约定是 ISO 风格单地区语言用de、fr多地区语言用下划线分隔地区如zh_cn/zh_tw/zh_hk。文件名、语言代码、下拉框值三处必须一致只修改已有语言可以吗可以直接编辑对应的src/locales/lang.json即可无需改动i18next.ts翻译完成后还有什么你可以在 README.md 的 Translators 名单中添加自己的名字项目对每位贡献者表示感谢总结为 iloader 添加新语言只有三步在 src/i18next.ts 注册语言 → 复制 src/locales/en.json 为新文件 → 逐条翻译并保留插值变量。得益于 i18next 的自动加载与英文回退机制即使翻译不完整也不影响用户使用放心贡献即可。【免费下载链接】iloaderUser friendly sideloader项目地址: https://gitcode.com/GitHub_Trending/iloa/iloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
