多语言配置不再繁琐get generate locales命令从JSON到多语言的完整指南【免费下载链接】get_cliOfficial Getx CLI项目地址: https://gitcode.com/gh_mirrors/ge/get_cliGetx CLIget_cliGet 官方命令行工具提供的get generate locales命令可以一键把 JSON 翻译文件转换成 Dart 本地化代码。只需准备几份 JSON 文件运行一条命令就能自动生成完整的AppTranslation、LocaleKeys与Locales类从此告别手写多语言代码的繁琐与出错风险。什么是 get generate locales 命令传统做法中给 Flutter 项目添加多语言支持往往需要手动维护大量 Map、键名常量和语言映射稍有不慎就会拼错键名或漏掉某个语言。get generate locales把这个过程完全自动化 读取指定目录下的所有.json翻译文件 将嵌套 JSON 自动展平为带下划线的键名 生成可直接引用的 Dart 代码文件✅ 自动校验 JSON 合法性与键名规范命令的完整实现位于 locales.dart你甚至可以直接参考 get_cli 自己的多语言文件如 translations/zh_CN.json来组织你的翻译目录。一键安装与基本使用方法在 Flutter 项目根目录执行以下命令即可get generate locales assets/locales其中assets/locales是翻译文件所在目录这是默认路径也可以换成任意目录。执行后你会看到类似这样的提示Generating locales.dart file生成的文件默认输出到lib/generated/locales.g.dart。就这么简单——一条命令完成多语言配置JSON 文件如何变成多语言代码准备好如下结构的翻译目录assets/locales/ ├── en.json ├── zh_CN.json └── pt_BR.json命令会按照以下规则处理每个文件1. 文件名即语言代码en.json对应语言enzh_CN.json对应zh_CN无需额外配置。2. 嵌套 JSON 自动展平比如en.json中写了{ buttons: { login: Login, logout: Logout } }展平后键名变为buttons_login、buttons_logout层级越深下划线越多。这样所有键都变成扁平常量引用时不会有拼写歧义。3. 自动生成三类代码AppTranslation语言代码到Locales映射的注册表LocaleKeys所有键名的static const常量防止键名拼错Locales每个语言一个static constMap存放实际翻译值生成的模板来自 generate_locales.dart你可以直接查看 get_cli 自己生成的成品文件 locales.g.dart 来了解最终结构。进阶技巧用 on 参数指定输出位置如果希望生成的多语言文件放在指定文件夹例如locales目录加上on参数get generate locales assets/locales on locales输出文件名固定为locales.g.dart带.g.dart后缀表示这是生成文件不应手动修改。常见错误与排查方法报错提示原因解决方法目录不存在传错路径或文件夹缺失检查路径拼写确认目录存在目录是空的目录里没有.json文件放入翻译文件后重试不是有效的 json 文件JSON 格式错误用 JSON 校验工具检查语法键名含不允许的特殊字符键名中出现数字开头或特殊符号键名仅使用字母、数字非开头、下划线另外注意翻译值中的单引号、换行符和$符号会被自动转义无需担心字符串冲突。如何在 Get 项目中使用生成的代码生成完成后配合 GetX 的国际化扩展参考 internationalization.dart 中的tr用法在页面中即可这样引用LocaleKeys.buttons_login.tr带参数的翻译则使用trArgsLocaleKeys.error_failed_to_connect.trArgs([www.example.com])切换语言、新增语言只需维护 JSON 文件并重新运行一次get generate locales代码始终与翻译文件保持同步。常见问题解答问每次改完 JSON 都要重新生成吗是的。翻译文件是唯一数据源修改后重新执行一次命令即可覆盖生成生成文件带overwrite机制不会报错。问支持哪些语言命名任何合法的 JSON 文件名都可以推荐直接使用语言代码或语言代码_国家代码格式如en、pt_BR、zh_CN。问生成的文件会被手动修改吗不会。文件头部标注了DO NOT EDIT所有改动都应通过 JSON 文件完成。从 JSON 到多语言代码get generate locales用一条命令串起了整个流程文件命名即配置、键名自动生成、翻译内容零转义成本。无论是个人项目还是团队协作都能让多语言维护变得简单、可靠、可追溯。 【免费下载链接】get_cliOfficial Getx CLI项目地址: https://gitcode.com/gh_mirrors/ge/get_cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考