OpenToonz 界面本地化指南如何为 2D 动画软件添加多语言支持【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz刚装上 OpenToonz满屏英文菜单让你无从下手这篇指南带你三步切换界面语言讲清 OpenToonz 的国际化架构再手把手教你参与本地化开发——从更新翻译文件到用 Qt Linguist 提交译文。上手篇打开软件后如何切换界面语言先说结论语言开关就藏在偏好设置里。启动 OpenToonz 后打开 Preferences 面板在语言下拉列表中选择你的语言然后完全退出软件再重新打开——切换才会生效。程序启动时会主动查询你保存的语言偏好并据此加载对应的语言包。源码里这一步对应Preferences::instance()-getCurrentLanguage()这个调用也就是说语言选择一旦写入偏好设置之后每次启动都会自动应用不用再手动切换。切换成功后菜单、工具提示、对话框里的文字都会随之变化个别深度模块若某语言缺译文可能仍显示英文原文这属于正常的部分覆盖状态。语言包与模块分布翻译文件都放在哪语言包和翻译文件分两个位置存放这是理解 OpenToonz 国际化布局的关键位置内容运行时用户配置目录下的stuff/config/loc/编译好的语言包每种语言一个子目录内部存放.qm文件程序启动时从这里读取源码侧toonz/sources/translations/各语言的.ts源文件按语言建文件夹如chinese/、japanese/供译者编辑程序读取的运行时路径在代码中拼成TEnv::getConfigDir() loc再加上语言名子目录Windows 用反斜杠其他平台用正斜杠细节可在 toonz/sources/toonz/main.cpp 中核对。目前官方支持 9 种语言简体中文、日本語、한국어、Español、Français、Deutsch、Italiano、Čeština、Русский。此外源码的translations/目录里还有 norwegian_bokmal、portuguese_brazil 两个社区维护的语言文件夹。每个语言文件夹内有 7 份.ts文件对应 7 个功能模块.ts 文件覆盖的源码模块toonz.ts主程序界面toonzqt.ts工具栏与面板image.ts图像处理colorfx.ts颜色特效tnzcore.ts公共基础库common 目录toonzlib.ts核心库tnztools.ts工具功能原理篇翻译机制如何工作原理其实很简单三句话讲完程序启动时从偏好设置取出你选定的语言然后在配置目录的loc/下拼出对应语言的路径接着用QTranslator逐个加载各模块的.qm文件并注册到应用上。下面这段就是核心逻辑加载toonz.qm并安装到应用QString languagePathString QString::fromStdString(::to_string(TEnv::getConfigDir() loc)); languagePathString / Preferences::instance()-getCurrentLanguage(); QTranslator translator; translator.load(toonz, languagePathString); a.installTranslator(translator);它只对主界面这一份语言包做加载其余六个模块的.qm文件走同一套路依次installTranslator注册所有界面字符串随后就能自动完成替换。进阶篇参与本地化开发的完整路径想给 OpenToonz 补几条译文按下面四步走克隆仓库git clone https://gitcode.com/GitHub_Trending/op/opentoonz打开toonz/sources/translations/运行更新脚本并传入目标语言参数例如./update.sh chinese脚本内部依次用lupdate扫描 colorfx、common、tnztools、toonz、toonzlib、toonzqt、image 七个源码目录把新增或变更的可翻译字符串写进对应的.ts文件语言目录不存在时会自动创建。用 Qt Linguist 打开更新后的.ts文件逐条填写译文。翻译时注意保留%1这类占位符不要随意增删。完成后保存再用lrelease把.ts编译为.qm提交。如果改动较多可先关注 CI 构建状态确认 Linux、macOS、Windows 多平台编译都能通过避坑篇三个容易踩的坑译文里出现乱码方块通常是编码问题。编辑.ts文件时请确认编辑器以 UTF-8 保存中文、日文等非 ASCII 字符在编码不一致时最先阵亡。将来支持 RTL 语言时光译文字不够。阿拉伯语、希伯来语这类从右向左书写的语言Qt 本身支持布局方向但按钮、列表的对齐和图标位置都需要逐一验证不能默认与 LTR 语言一致。德语译文总是把按钮撑爆这是长度膨胀问题很多语言译文比英文长 30% 以上。翻译时留意界面空间必要时精简措辞而不是硬塞原文直译。写在最后语言切换藏在偏好设置里翻译文件按语言 × 模块两个维度铺开加载机制则交给 Qt 的QTranslator体系——理解这三层你就掌握了 OpenToonz 国际化的全貌。哪怕只是补齐几条译文也是在为全球动画创作者省下读菜单的时间。挑一门你熟悉的语言从toonz.ts开始试试项目后续还会继续扩充语言支持欢迎随时加入。【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考