Resprite 常见问题排查：打不开、崩溃、保存失败、导出报错

打不开某个 .resprite 工程

可能原因 1：工程文件损坏

Resprite 会在编辑过程中自动备份到 iOS 安全区或桌面端备份目录：

• iOS：打开 Resprite 图库 → 找到损坏的工程 → 从安全区恢复。
• 桌面：备份目录在 Resprite 偏好设置里指定的位置 → 找最近的备份副本。

损坏的工程通常可以从安全区恢复到"损坏前最后一次自动备份"的状态——不会丢所有进度。

可能原因 2：Resprite 版本过旧

你在新版 Resprite 里创建的工程 → 可能无法在旧版 Resprite 里打开。Resprite 的工程格式随版本迭代，向后兼容但不向前兼容（新格式无法被旧版识别）。

解决：升级到最新版 Resprite 再打开。

可能原因 3：文件被锁定或权限不足

桌面端文件被系统设为只读 → Resprite 打开时会提示权限不足。手动解锁文件。

Resprite 启动就崩溃

iOS / Android

• 强制退出 Resprite → 重新打开。
• 如果反复崩溃：卸载 Resprite → 清理残留（iOS 长按 → 移除 App；Android 设置里清除数据）→ 重新安装。
• 注意：卸载 Resprite 会清空本地数据——请确认没有未备份的工程再卸载。

Windows / macOS

• 重启 Resprite。
• 重启电脑（解决显卡驱动临时卡死）。
• 显卡驱动更新到最新版（Resprite 的 Flutter 渲染引擎对显卡驱动敏感）。
• 确认系统满足最低要求（见 系统要求）。

保存失败

桌面端

• 磁盘空间不足 → 清理空间后重试。
• 文件被其他程序占用 → 关闭可能打开该文件的程序（比如 Finder 预览、Windows Media Player）。
• 云同步冲突：文件在云盘（iCloud、OneDrive）同步中 → 等同步完成再保存，或先保存到本地再上传。

iOS

• iCloud Drive 空间不足 → 清理 iCloud 空间。
• iOS 后台清理中 → 如果 Resprite 刚被后台挂起，可能需要前台运行几秒再保存。

导出报错

GIF 导出报颜色数超限

GIF 只有 256 色。Resprite 会自动量化超过 256 色的内容，但如果你的调色板非常复杂 → 量化后可能效果不好。

解决：

1. 在调色板里手动限制颜色数量（比如 32~64 色）。
2. 导出 GIF 时在对话框里调整抖动强度。
3. 或改用 APNG（无 256 色限制）。

PSD 导出提示不支持某些特性

Resprite 的瓦片图层导出 PSD 时会被栅格化（PSD 没有瓦片概念）。这是正常行为——不是 bug。

Resprite 的图层样式（描边 / 阴影）导出 PSD 时也会被栅格化。如果你希望这些样式在 Photoshop 里保持可编辑 → 不现实，这是 Resprite 独有的非破坏性效果。

精灵表导出后游戏引擎读不到

常见原因：

• 网格参数错了：导出时的"每行帧数"、"帧尺寸"与游戏引擎读取时的参数对不上。
• 缩放不一致：Resprite 里 2× 放大 → 游戏引擎里按 1× 读 → 位置全错位。
• JSON 文件位置不对：有些引擎要求 JSON 和 PNG 在同一目录。

解决：在 Resprite 导出对话框里反复确认参数，导出后用 Aseprite 或 Photoshop 打开精灵表检查是否排布正确。

云同步问题

iCloud Drive / OneDrive 同步 Resprite 工程

• 自动同步冲突：两端同时修改同一工程 → 云盘会生成"冲突副本"。解决：一端改完同步好，另一端再打开。
• 大文件同步慢：长动画的 .resprite 文件可能上百 MB → 云同步需要时间。导出为 PNG / 精灵表后同步更快（但丢了工程编辑能力）。

iOS / macOS AirDrop

AirDrop 是 iOS → macOS 最快的文件传输方式。但如果 macOS 端 Resprite 没开 → AirDrop 只能传文件到 Finder，不会自动在 Resprite 里打开。先打开 macOS Resprite，再 AirDrop。

以上为 Resprite 用户高频遇到的问题与解决方法。如未覆盖你的问题，建议查阅官方帮助中心 FAQ 或联系官方支持。