先做简单、可恢复的检查
尽可能先保存工作，保留原始文档，记录版本和出错动作。在新会话中尝试打开本地小 PNG。若 PNG 正常而某个 PSD 失败，优先排查文件；若任何图片都无法打开，先检查安装或渲染环境。
以下是诊断步骤，不是保证有效的修复。具体版本的问题变化很快，采用旧解决方案前，先在官方 Issues 搜索同样错误。
无法启动或启动后立即退出
- 核对安装包是否匹配操作系统与架构。
- 检查便携压缩包是否完整解压。
- 比对校验值并阅读发布说明。
- 记录完整系统提示。熟悉终端时，可从终端启动并收集输出。
- 若信息涉及图形初始化，记录 GPU 与驱动版本，使用系统或硬件厂商支持的驱动更新。
空白窗口、安装被阻止和二进制不兼容是不同问题，反馈时保留原始错误文字。
画布空白或显示效果不一致
确认当前文档标签和图层是否正确，检查图层可见性、不透明度与缩放。用只有一个图层的小图片进行对照。只有复杂项目显示不一致时，按 PSD 兼容性清单检查，避免同时改动大量设置。
反馈渲染问题时，附截图、GPU/驱动信息、文档尺寸，以及新文档是否同样出现问题。
Linux 下拖入文件没有反应
官方记录了 Wayland 下的文件拖放限制。先使用 File → Open，区分是拖放问题还是解码问题。反馈环境中注明 Wayland 或 X11。
文字显示不同或缺字
核对文档字体与本机可用字体，在新的文字图层里测试一个确定已安装的字体。区分输入问题与渲染问题：无法输入字符和已有文字缺字不是同一现象。
反馈时注明字体名、应用界面语言、系统和简短示例文字。本站语言切换不会改变编辑器语言或本机字体。
保存或导出失败
- 在可写入的本地目录使用新文件名。
- 检查磁盘剩余空间和输出格式。
- 测试一个小的新文档，判断是否只对某文件失败。
- 将可编辑项目与最终导出图分开保存。
- 显示成功后仍应重新打开检查，再决定是否替换原文件。
部分格式会合并图层或无法保留透明背景。导出成功不等于该格式能保存所有可编辑内容。
提交可用的问题报告
PhotoCraft 版本：
操作系统 / 架构：
安装包文件名：
GPU / 驱动（如相关）：
文档尺寸 / 图层数 / 颜色模式：
复现步骤：
预期结果：
实际结果 / 完整报错：
新建小文档是否也失败：
截图或脱敏样例：先搜索已有问题，再向相关 Issue 补充最小复现步骤，或新建 Issue。提交前移除日志和文件中的私密信息。
来源与适用范围
依据官方文档与本站编辑建议整理，不是全面兼容性实测。菜单名称和行为可能随版本变化。