Joplin 笔记图片不显示？原因与恢复方法

一、先判断：图是丢了还是没下载

换设备后图片不显示，先回原设备打开同一篇笔记。原设备正常就是同步或下载问题，原设备也不显示才是附件丢了。Joplin 的附件是独立资源文件，正文先同步、附件后下载，机制见官方附件文档。

如果同步本身一直在报错，先看 Joplin 同步失败排查指南，把同步修好再回来查图片。

二、常见原因：同步未完成、导入路径失效、剪藏没下载

同步未完成最常见：弱网下打开笔记，或同步中断，图片就缺席。从 Evernote/印象笔记导入的 ENEX 笔记，图片会重新生成资源 ID，导入后立刻换设备，旧链接容易失效。网页剪藏来的笔记，剪藏后没同步就关应用，图片只剩链接。

多设备同时编辑产生冲突副本时，冲突笔记里的图片引用也可能失效。

三、按顺序排查：原设备 → resources 目录 → 同步状态

先回原设备确认图片正常，再检查资源文件是否在：桌面端 帮助 → 打开配置目录，进入 resources 文件夹。Linux/macOS 默认在 ~/.config/joplin-desktop/resources，Windows 在 %UserProfile%\.config\joplin-desktop\resources。

文件在就手动同步，等它跑完。还不行就看 帮助 → 同步状态里的 Error 和 Conflicts。

四、恢复方法：重新下载、重导 JEX、回收站

资源文件缺失时，在 设置 → 同步 里执行「删除本地数据并重新下载」，Joplin 会重建本地库重新拉图。操作前先确认同步目标数据完整。

同步目标也缺图片时，用之前导出的 JEX 备份重新导入，流程见 Joplin 数据备份与恢复实战。图片误删的话，去回收站恢复笔记，Joplin 3.0 起回收站默认保留 90 天。

五、预防：自动同步 + 定期 JEX 备份

桌面端开启自动同步，间隔设短些，比如 5 分钟。手机端把「附件下载行为」保持 Always。超过 10MB 的资源在手机上不支持同步，插入前先压缩。

从 Evernote 迁移过来的老笔记，迁移后先完整同步一遍再开始用，细节回看 从 Evernote/印象笔记迁移到 Joplin 完整教程。剪藏图片问题见 Joplin 网页剪藏教程。

六、常见问题

电脑显示、手机不显示怎么办？

多半是同步没完成，先手动同步一次；手机端把「附件下载行为」保持 Always。

图片空白或一直转圈？

资源文件在本地但渲染失败，退出客户端重开即可。

加密后图片不显示？

确认主密码已输入、解密完成。论坛里这类案例很多，可翻官方论坛的讨论帖。

网上搜「joplin 图片不显示」的案例，九成落在这三类原因里，多数重新同步就解决。同步方案不稳的，参考 Joplin 同步方案对比 换更稳的通道。