角色立绘或背景图缺失

典型症状

• 编辑器里选了角色，预览窗口是空白或只有对话框
• 鉴赏模式里背景全黑、听不到 BGM
• 工程列表里的预览缩略图是空的

最可能原因：资源包没装或装错版本

90% 以上的角色/图片/BGM 缺失问题都是资源包的问题：

情况 A：从未装过资源包

• 自动安装（步骤 2A）因为网络原因失败了
• 或者压根没走到资源包安装步骤就进了编辑器

解决：重新走手动安装流程（见 自动安装 步骤 2B）。

情况 B：装了但版本不匹配

参考 版本匹配 的对照表核对两个版本号。差一版都不行。

解决：用正确版本号的资源包重新走手动安装。

情况 C：手动安装时切出了应用

移动端（Android / iOS）手动安装过程中不要切出应用——切出去安装会中断或损坏。

解决：在手动安装界面等进度条跑完、看到「重启」提示再切出去。

重装资源包的步骤

1. 准备好正确版本号的资源包 ZIP
2. 启动 AzureArchive 到加载界面
3. 点「手动安装」按钮
4. 选择 ZIP 文件
5. 画面会卡住白屏——这是正常现象，等
6. 进度走完 → 提示重启 → 重启
7. 重启后加载界面正常进入编辑器，预览窗口能看到角色

自定义角色 / 立绘差分

官方文档明确说明：自定义立绘差分必须是 SPINE 格式（不是普通 PNG/JPG）。如果你手头有普通图片想当自定义角色立绘，需要转成 SPINE 格式，且 AzureArchive 目前不支持 3.8.75 版本的 spine 文件——推荐 3.8.96 版本。

音乐/音效/背景一起缺失

如果角色、背景、BGM 三样全缺，一定是资源包整体没装好，不是单独某一项出问题。直接重装资源包即可，不要逐个排查。

重装没用的话

如果重装了正确版本的资源包还是缺角色：

1. 确认解压 manual_install 文件夹时 ZIP 内容确实是解压后的文件，不是 ZIP 本身放进去
2. 确认 manual_install 文件夹是手动创建的（不会自动生成）
3. Windows 用户确认 AppData 隐藏文件夹里的路径没错
4. 实在不行，F8 调日志看报错，贴给官方

一条经验

每次升级 AzureArchive 本体后，一定要重新核对资源包版本号——本体升了但资源包没升（或升错了），百分百会出现资源缺失问题。