RAGFlow离线部署避坑：tiktoken cl100k_base词表下载失败解决方案
2026/9/20 21:04:01
从零跑起来 OpenToonz 开源2D动画软件完整上手指南
【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz
OpenToonz 是一款开源的、功能完整的 2D 动画创作软件，把数字绘画、矢量描线、特效合成这些原本分散的工具整合进一个工作流，给想独立完成 2D 动画的个人动画师、美术学习者使用。
这篇文章的目标很直接：带你从拉代码到看见软件跑起来，然后告诉你笔刷、主题这些资源藏在哪，卡住了往哪查。
跑起来
- 装依赖。Linux 看 Linux 构建文档：一条 apt 命令就能装齐 Qt、Boost、OpenCV、libmypaint 这些系统库。Windows 看 中文构建文档：装 Visual Studio 2019、CMake、Qt 5.15，再把 boost 压缩包解压到
thirdparty/boost目录。 - 拉代码：
git clone https://gitcode.com/GitHub_Trending/op/opentoonz。Windows 上拉完记得执行git lfs pull——库文件（.lib/.dll）用的是 git 大文件存储（一种专门管理大文件的机制），不拉这一步就会缺文件。 - 初始化配置：把
stuff/目录整个复制到软件资源目录。Linux 放到~/.config/OpenToonz/；Windows 复制到任意位置后，在注册表里建一条TOONZROOT指向它。📌 这步不做，软件就找不到笔刷和主题。 - 编译：进
toonz/建个build子目录，用 CMake 指向toonz/sources/生成工程再编译，产物在toonz/build/里。构建时间比较长，这是正常现象。 - 启动：Linux 在
toonz/build/下运行./bin/OpenToonz（需带上lib目录的环境变量）；Windows 直接跑build/Release里的OpenToonz.exe。首次启动会加载默认配置和界面布局，打开就是一套标准动画工作台，不用额外配置。
要用的资源都在哪
OpenToonz 的内容资源几乎全在stuff/里，按你"想干什么"来找就行：
| 你想做的事 | 去哪找 | 里面有什么 |
|---|---|---|
| 换手绘笔刷手感 | mypaint 笔刷库 | 多套成品笔刷，.myb 是 MyPaint 笔刷格式 |
| 用矢量笔刷 | 矢量笔刷 | .pli 格式的矢量笔刷文件 |
| 做粒子效果 | 粒子贴图库 | 鸟群等现成粒子贴图 |
| 标记镜头信息 | 拍板模板 | 拍板图和预设文件，用于镜头编号、时间码 |
| 做 2D 跟踪校准 | 相机校准 | 棋盘格校准图和说明 |
| 换界面主题 | qss 主题目录 | Default、Dark、Darker 等主题样式表（.qss 是 Qt 的界面样式文件格式） |
| 改窗口布局 | 布局模板 | 上百份预制工作区布局 |
| 换全局调色板 | studiopalette | .tpl 调色板文件 |
| 自己写特效插件 | 示例插件 和 内置特效源码 | 模糊、几何变换等可参考的示例实现 |
| 先试别人提的新功能 | PR 测试文档 | 教你从 PR 页面下载现成构建包直接跑，不用自己编译 |
拍板模板长这样，中间横线就是给你写镜头信息的：
想测某个 PR 的新功能时，构建页会显示多平台检查结果，全绿就能放心下载：
卡住了查这里
构建时报一堆"缺依赖、找不到库"
- 症状：跑 CMake 或编译时，报某某库没找到，或者编译到某个头文件就失败。
- 根因：OpenToonz 依赖十几个系统库（Qt、Boost、OpenCV、libmypaint 等），系统默认都不装；Windows 上还有
git lfs pull这步容易漏。 - 处置：Linux 照 构建文档 里对应发行版的一行命令装齐；Windows 克隆后先补
git lfs pull。还解决不了就按文档提示用详细模式重新构建，拿第一条报错去搜。
程序能打开，但笔刷、主题是空的
- 症状：界面出来了，笔刷列表空空如也，界面像没穿衣服。
- 根因：笔刷、调色板、主题全在
stuff/目录里，软件按固定路径去找：Linux 是~/.config/OpenToonz/，Windows 是注册表里记的那个路径。没复制 stuff，它找到的就是一个空文件夹。 - 处置：把
stuff/复制到对应位置后重启；Windows 再顺手确认注册表键值指向的确实是有内容的 stuff 目录。
Windows 下导入 mov 视频报错
- 症状：导入 QuickTime 格式的视频时提示格式不支持或导入失败。
- 根因：这类格式靠一个叫
srv的 32 位小服务程序支持，它要用 Apple 的 QuickTime SDK 单独构建，源码里没有现成的。 - 处置：只画动画可以完全忽略；真要处理 mov，按 中文构建文档 的 srv 一节构建 32 位程序并放进安装目录。
换了主题不生效或界面错乱
- 症状：改了样式文件界面没变化，或升级后图标、主题乱了。
- 根因：主题样式表在 stuff/config/qss/ 下，只在启动时读取一次；自己魔改过 qss 的话，还可能和新版本内置样式冲突。
- 处置：先在软件设置里切回 Default 或 Dark 这类内置主题试试；自己改过的 qss 先移开再重启，恢复默认外观。
到这里，你已经能自己编译、配置并跑通 OpenToonz。下一步可以打开 示例插件，看看模糊和几何变换这两个小插件是怎么写的，试着写自己的第一个特效。
【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考