OpenToonz快速跑起来：这份免费2D动画软件实战指南
【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz
OpenToonz 是日本 DWANGO 发布的免费开源 2D 动画创作软件，基于吉卜力电影使用的 Toonz 系统打造。这篇文章带你走一遍真实操作链路：克隆代码、构建程序、首启后检查资源、按顺序排查常见故障，跟着做就行。
克隆代码：出问题先看哪里
读完这一节，你能在遇到构建失败、插件失灵或资源丢失时，快速定位该查哪个目录。先在终端执行下面命令拿到代码：
git clone https://gitcode.com/GitHub_Trending/op/opentoonz代码到手后，记住四个"仓库"就够：
- toonz/sources/是程序本体：主程序
toonz/、界面部件toonzqt/、特效引擎stdfx/，要改程序看这里。 - stuff/是素材仓：主题、画笔、布局、拍板模板都在里面，界面异常或资源丢失先来这里。
- thirdparty/存着 libjpeg-turbo、kiss_fft、OpenBLAS、SuperLU 等外部依赖，构建报错先查这里。
- doc/放各操作系统的构建指南和 PR 测试流程，全是
.md文件。
按系统构建：装依赖再验证
读完这一节，你能在自己机器上把 OpenToonz 程序装起来。先按系统装好依赖：
- Linux：doc/how_to_build_linux.md 列出 CMake 3.10+、Qt 5.15+、Boost、libmypaint、OpenCV 等必备组件。
- Windows：doc/how_to_build_win.md（另有简中版）。
- macOS：doc/how_to_build_macosx.md。
⚠️ 报"缺少依赖"类错误时，先核对
thirdparty/目录是否完整——多数情况是缺库，不是代码问题。
想加自定义效果，plugins/ 下的 blur、geom、multiplugin 三个示例插件是最好的参考，核心代码在plugins/blur/blur.cpp。
首次启动：先查这些内置资源
读完这一节，你能找到这款开源动画软件内置的画笔、主题和布局模板，直接拿来用。
- 界面主题：
stuff/config/qss/内置 Default、Dark、Light 等 8 套，每套一个.qss文件，换外观不用改代码。 - 画笔：
stuff/library/mypaint brushes/有 aotz、classic、ramon 等 9 套笔刷包，stuff/library/vector brushes/还有 41 支矢量笔刷。 - 布局：
stuff/profiles/layouts/存着 172 个布局 XML，恢复或定制界面从这里入手。 - 拍板模板：
stuff/library/clapperboards/images/board1.png是 1920x1080 规格，标记镜头号可直接套用。
用摄像机拍定格动画时，打印stuff/library/camera calibration/checkerboard.tif拍 10 张照，Camera Capture 窗口会自动校正畸变，步骤在同目录readme.txt里。
💡修改
stuff/config/下任何文件前先备份（尤其是batches.xml），改完必须重启程序才生效。 📌permissions.xml控制团队协作的功能访问，动它要格外小心。
常见故障：按这个顺序排查
读完这一节，你能快速定位构建失败、插件加载不出、界面错乱三类问题的成因。
- 构建失败：八成是依赖问题。先核对
thirdparty/是否完整，再对照对应系统的构建文档清单。 - 插件加载不出来：先查构建产物——
.so（Linux）/.dll（Windows）要存在于目录且可执行；结构问题对照plugins/下三个示例插件。 - 主题错乱、按钮缺失：多半是样式缓存乱了。恢复
stuff/config/qss/对应主题的.qss后重启；自己改样式参考 doc/how_to_stylesheet.md。
项目每次改动都经 CI 在 5 个平台验证构建，全通过长这样（Windows 约 29 分钟，Linux 约 4 分钟）：
改代码时以这张图为基准：5 项全绿才能提交，步骤见 doc/how_to_test_prs.md。
下一步建议
- 构建成功后，核对
stuff/config/safearea.ini和stuff/config/colornames.txt是否符合出片要求。 - 到
qss/里换一次主题，记得重启程序看效果。 - 准备深入源码前，先读 doc/development_checklist.md 了解团队开发规范。
【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
