学习(英文) / 指南(英文)

问题排查

如何排查 Ren'Py 中找不到的图片

Ren'Py图片缺失静态分析发布前检查

图片缺失可能来自文件移动、名称不一致或引用方式变化。先找到具体引用与对应文件,再尝试修改,避免用批量重命名掩盖问题。

1. 记录出现问题的位置

记下游戏运行到哪个场景时出现问题,以及相关提示中的图片名或路径。保存当前项目状态,便于比较修改前后的结果。

2. 对照引用检查文件

  • 文件是否实际存在,是否被移到了其他目录?
  • 文件名、扩展名和大小写是否一致?尤其要检查从其他操作系统复制来的文件。
  • 脚本引用的是图片名称还是文件路径?不要把两者混为一谈。
  • 图片名称或路径是否在运行时动态生成?这种情况需要结合代码与实际运行结果核实。

3. 使用 BranchPy 缩小排查范围

在 Studio 中打开项目并运行分析,查看与媒体资源和脚本引用有关的结果。将报告中的位置与实际文件对照;如果结果与游戏表现不同,先检查动态引用和相关定义。

“未使用”或“缺失”是需要核实的线索。不要仅凭分析提示删除文件,也不要把没有提示当作所有场景都已通过测试。

4. 一次修改一个原因

确认原因后,修正对应引用或恢复缺失文件。修改前保留备份。重新运行分析,再启动游戏检查原来的问题场景以及共享该图片的其他场景。

问题仍然存在?

整理可复现步骤、相关提示和最小必要代码,向社区(英文)反馈。不要公开整个私有项目、账户信息或未获授权的素材。

下载 BranchPy Studio 查看安装指南

← 为什么 GUI 文件显示为未使用(英文) 理解视觉小说分支(英文) →