企业官网建设流程全解析

OpenToonz 开源动画软件快速上手指南：从首次启动到个性化定制

【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz

OpenToonz 是一款功能完整的开源 2D 动画软件，源自日本动画工作室商片制作所用的 Toonz 系统，内置绘制、原画、描线、合成与特效等一整套流程功能，适合动画学习者、个人创作者和小型制作团队。这篇 OpenToonz 使用指南面向新手与普通用户：读完后你能自己把软件跑起来，知道去哪里找目录和配置，并完成常用的资源与界面个性化设置。

OpenToonz 首次运行：依赖准备、获取软件与第一次启动

依赖准备

• 先按系统查阅构建文档：Linux 看 doc/how_to_build_linux.md，Windows 看 doc/how_to_build_win.md，macOS 看 doc/how_to_build_macosx.md。
• 图像读写与压缩所用的基础库已预置于thirdparty/目录（zlib、libpng、libjpeg-turbo等，一句话解释：它们是软件打开和保存图片时依赖的部件），通常不需要你自己到处找。

获取软件

1. 普通使用：直接下载已编译好的发行版安装，即可开画。
2. 想改源码：执行git clone https://gitcode.com/GitHub_Trending/op/opentoonz获取仓库，再按上面的构建文档编译。

💡 项目用 CI（持续集成，即每次提交代码后自动跑的构建检查）在各平台验证编译，下图绿勾表示全部通过：

首次启动

安装或编译后运行可执行文件。首次启动会加载默认界面布局，默认配置落在stuff/config/下；新建一个场景，就可以开始画图了。

OpenToonz 目录结构速查：按使用意图找文件

记不住目录树也没关系，按"你想改什么"对照这张表即可：

📌 建议：先问自己"要改哪个文件"，再进对应目录，别在整棵目录树里翻找。

OpenToonz 资源与个性化配置：三个高频场景

用拍板素材标记镜头

stuff/library/clapperboards/附带拍板（clapperboard，即镜头开拍前"啪"一声合上、用于记录场次与镜头信息的板子）模板，board1.png是 1920x1080 的空白底版，可以直接拿来标注镜头信息：

相机校准对齐实拍与 2D 场景

stuff/library/camera calibration/checkerboard.tif是一张棋盘格校准图。把实拍画面和 2D 动画合成时，用它帮助软件推算相机位置，让实拍素材与 2D 场景的透视对得上。

批量任务、权限与界面主题

• stuff/config/batches.xml定义渲染队列、格式转换等批量任务。
• stuff/config/permissions.xml控制不同用户能使用哪些功能，适合团队协作。
• stuff/config/qss/存放界面样式文件（.qss样式表就是告诉界面用什么颜色、什么字体的说明书），想换深色界面从Dark/子目录入手。

⚠️ 手动修改以上 XML 或任何.qss之前，先复制一份原文件备份，改完要重启软件才生效。

OpenToonz 常见问题自查：现象、原因、解法三步对照

以下问题按"现象 → 原因 → 解法"整理，遇到时逐条对照：

1. 编译失败，报缺少依赖
   • 原因：thirdparty/目录不完整，或系统级库没有装齐。
   • 解法：核对依赖目录完整性，按 doc/how_to_build_linux.md 补装系统依赖。
2. 插件列表为空，或功能失效
   • 原因：插件目录放错位置，或缺少编译出的.so（Linux）/.dll（Windows）产物。
   • 解法：检查plugins/下结构是否正确、编译产物是否存在。
3. 界面主题错乱、按钮缺失
   • 原因：stuff/config/qss/下样式文件或缓存异常。
   • 解法：先备份，再恢复默认主题目录，重启软件重新加载。

如果是从源码构建且本地编译失败，可对照项目的成功构建记录——下图 Windows 构建耗时 29 分钟并通过，提交改动前可把同类检查当参考：

OpenToonz 让一套开源工具就能走完 2D 动画全流程。下一步建议跟着官方教程画一部第一支动画，再研究plugins/里的示例代码，写一个属于自己的特效插件。

【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz