OpenToonz 多语言指南：3 步切换界面语言，一文讲透本地化原理与贡献流程

OpenToonz 多语言指南3 步切换界面语言一文讲透本地化原理与贡献流程【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz如果你正在找OpenToonz 中文界面或者如何切换 OpenToonz 语言的答案这篇文章从最上手的一步开始讲起先用 3 步把界面换成你的母语再盘一盘现在到底能选哪些语言然后拆开语言包看看背后发生了什么最后附上从零添加一门语言的完整工作流和切换不生效时的排查清单。切换 OpenToonz 界面语言最快方法最快的路径就三步全程在图形界面里点几下打开偏好设置菜单里进入Preferences偏好设置。找到Language语言选项这里是一个下拉列表列出的就是当前可用的语言。选中目标语言后完全退出并重启程序语言包是在启动阶段加载的重启后菜单、工具栏、对话框就都换成了新语言。两个新手最容易踩的点一是必须重启只关窗口不退出进程是看不到效果的二是没有你想要的语言怎么办——下拉列表不是固定的后面第 4 节会讲怎么补上。OpenToonz 支持哪些语言语言包完整盘点下拉列表里能选多少种语言取决于翻译目录 toonz/sources/translations/ 下实际存在多少个语言文件夹。目前仓库里收着11 个语言目录比你想象的要多语言目录名简体中文chinese日本語japanese한국어koreanEspañol西班牙语spanishFrançais法语frenchDeutsch德语germanItaliano意大利语italianРусский俄语russianČeština捷克语czechNorsk bokmål挪威语norwegian_bokmalPortuguês do Brasil巴西葡语portuguese_brazil没出现在列表里的语言比如阿拉伯语、繁体中文意味着仓库里还没有对应的翻译文件——这不是程序不支持而是还没人做。这也正好是第 4 节贡献语言包的切入点。另外说明一点即使选了某种语言如果某个按钮的词条还没被翻译那一处仍会显示英文原文。所以各语言的完成度有高有低遇到零星英文不必奇怪。语言包背后发生了什么换语言的本质其实和餐厅同一道菜印多语种菜单是一个道理界面文案是固定的菜名每个语言文件夹里装的就是一张对照表——英文原名 → 本地语言译名。对照表用的是 Qt 框架的文件格式。你可能听过 TS 和 QM 两种后缀用一句话区分TS 文件人读的 XML 格式对照表翻译人员在上面填写译文QM 文件机器读的编译产物程序运行时真正加载的是它。OpenToonz 的界面不是一整块而是由七个模块拼起来的所以每个语言目录下都有 7 个翻译文件一一对应翻译文件管什么toonz.ts主程序界面菜单、对话框toonzqt.ts工具栏与通用面板tnzcore.ts核心基础库common/toonzlib.ts工具库toonzlib/colorfx.ts颜色特效colorfx/tnztools.ts工具功能tnztools/image.ts图像与文件导出相关image/启动时程序会按你在偏好设置里选的语言依次把这 7 张对照表装进 Qt 自带的翻译加载器代码里的QTranslator类。toonz/sources/toonz/main.cpp 里的核心逻辑用白话讲就是两句话QString languagePathString TEnv::getConfigDir() loc/ 当前选择的语言; QTranslator translator; translator.load(toonz, languagePathString);第一行拼出配置目录/loc/你的语言这个文件夹路径第二行把该文件夹下的toonz翻译表加载进来并安装。剩下的 6 个模块就是同样的动作重复 6 遍。翻译目录loc就在你的配置目录config下程序只认这个位置——这也是排查问题的第一个检查点见下节。给 OpenToonz 加一门语言翻译工作流实操想贡献一门新语言或补全现有语言整套流程是拉代码 → 生成 TS → 填写译文 → 发布。拿到源码git clone仓库如果需要在 gitcode 上获取地址是 https://gitcode.com/GitHub_Trending/op/opentoonz 。生成翻译源文件进入 翻译脚本目录运行./update.sh 语言代码 # 例如 ./update.sh portuguese_brazil这个 update.sh 脚本 会调用 Qt 的lupdate工具扫描上面 7 个模块的源码把里面所有带tr()标记的可翻译字符串抽出来写成 7 个.ts文件放进以你语言代码命名的新目录。填写译文用Qt LinguistQt 官方图形化翻译工具打开 TS 文件逐条把译文填进 Translation 列。术语建议先翻几条定下口径比如 Xsheet 到底译成摄影表还是保留原文再批量推进。提交你的翻译文件把 7 个.ts文件按目录规范提交并让项目把它们打包进发布版的loc目录。装好之后你的语言就会出现在前面第 1 节那个下拉列表里其他用户切换语言时就能直接选了。提醒一句TS 文件里会标记已翻译/未翻译状态Linguist 的进度统计功能可以帮你看到还差多少条适合按模块分批推进。OpenToonz 语言切换不生效5 个排查技巧最后集中处理那些我切了语言但没变的问题按概率从高到低查没重启最常见的情况。确认是完全退出进程结束而不是只关了主窗口再打开。翻译文件没到位程序只从配置目录下的loc/语言名/加载翻译。检查这个路径里有没有对应的.qm文件如果你是从源码运行还要确认 TS 已经用lrelease编译成了 QM——只提交 TS 的话程序运行时读不到翻译。下拉列表里没有你的语言说明该语言的翻译文件还没随程序一起分发回到第 4 节的工作流把文件补进loc目录即可。部分界面仍是英文单个词条漏译或该模块的翻译文件缺失属于正常现象不影响其他部分显示新语言。文字显示异常确认系统和字体支持目标语言字符日韩文字尤其需要对应字体一般更新系统字体即可解决。另外一个小技巧语言偏好是按用户配置保存的多人共用一台电脑时各自的配置目录里会记住各自的界面语言互不干扰。把要点收拢一下切换语言就是Preferences 里选一个 重启能选哪些语言取决于translations/目录下的 11 个语言文件夹原理上就是把 7 个模块的菜名对照表装进 Qt 的翻译加载器想加新语言就跑一遍update.sh加 Qt Linguist出了问题先查重启、再查loc目录。剩下的就是动手了——你的母语也许就差一份翻译文件就能进 OpenToonz 的界面。【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考