Obsidian 清理未引用图片：上传 OSS 后，本地残留图片怎么处理？

Obsidian 写久以后，最容易失控的不是 Markdown 文件，而是图片。

尤其是你已经把图片上传到 OSS 或图床以后，笔记里的引用变成了线上链接，但 Vault 里的本地原图可能还在。时间一长，附件目录里就会留下很多未引用图片，也就是很多人说的僵尸图片、孤儿图片、废弃附件。

这些图片平时不一定影响你写作，但会持续占用本地空间。如果你还用 Git 同步 Obsidian Vault，它们也会让仓库越来越重。

这篇文章讲清楚三个问题：

1. Obsidian 里为什么会出现未引用图片
2. 上传 OSS 后，本地图片是不是可以直接删
3. NotePic 最新版本怎么帮助清理本地残留图片

为什么 Obsidian 里会出现未引用图片

Obsidian 的图片体验很顺手。

截图可以直接粘贴，图片可以放到附件目录，也可以用 wikilink 写法引用：

![[Pasted image 20260603102000.png]]
![[demo/settings.png]]

也有人更习惯 Markdown 图片写法：

![](./assets/cover.png)
![](../images/screenshot.png)

这些写法在 Obsidian 里通常都能正常显示。问题在于，图片文件和笔记内容是两类东西。

当你删除一段图片引用时，Obsidian 不一定会自动删除对应图片文件。当你重命名笔记、迁移目录、复制文章、上传图床后替换链接时，本地图片也可能继续留在附件目录。

久而久之，Vault 里就会出现三类图片：

• 仍然被笔记引用的图片
• 已经上传到 OSS，但本地还残留的图片
• 已经没有任何笔记引用的图片

第三类就是我们要重点处理的未引用图片。

什么是僵尸图片、孤儿图片和废弃附件

僵尸图片、孤儿图片、废弃图片、未引用附件、无用图片，它们说的基本是同一类问题：图片文件还在 Vault 里，但当前笔记里已经找不到引用它的地方。

比如附件目录里有这个文件：

99-附件/Pasted image 20260603102000.png

但整个 Vault 里已经没有任何笔记写引用它。

这种图片就很可能是未引用图片。

注意，我这里说的是“很可能”。图片清理不能只看文件名，也不能只看某一种 Markdown 写法。真正安全的清理，需要尽量识别 Obsidian wikilink、Markdown 图片、HTML 图片标签、引用式链接等多种写法。

上传 OSS 后，本地图片是不是可以直接删

不建议直接删。

上传 OSS 之后，笔记里的图片可能已经变成这样：

![](https://your-cdn.example.com/markdown/cover.png)

这时从“发布”角度看，文章确实不再依赖本地图片了。

但从“知识库维护”角度看，你还需要确认几件事：

1. 这张本地图片是否还被其他笔记引用
2. 是否还有草稿、旧文章、Canvas 或插件数据在使用它
3. OSS 链接是否已经确认可访问
4. 你是否还想保留本地原图作为素材
5. 当前 Git 工作区是否干净，方便清理后回滚

所以更稳妥的做法不是手动打开附件目录乱删，而是先扫描整个 Vault，找出哪些图片还在被引用，哪些图片已经没有引用关系。

普通图片清理插件解决了什么

如果你只想定期清理 Obsidian 未引用图片，社区里已经有一些工具可以解决一部分问题。

比如 Clear Unused Images、Nuke Orphans 这类插件，重点是扫描 Vault 中的图片和笔记引用关系，然后找出没有被引用的附件。

这类工具适合单纯的附件清理场景。

但 NotePic 最新版本面向的是另一个更具体的工作流：

先用 NotePic 把 Obsidian / Markdown 里的本地图片上传到自己的阿里云 OSS，并把笔记引用替换成线上链接。然后再清理上传后留在 Vault 里的本地残留图片。

NotePic 最新版本怎么扫描和清理本地图片

NotePic 最新版本新增了本地图片资产清理能力。

它的目标不是让你盲删附件目录，而是先把图片状态展示出来：

• Vault 里有哪些本地图片
• 哪些图片仍然被笔记引用
• 哪些图片看起来没有被引用
• 这些图片分别在哪些目录
• 总共占用了多少空间
• 删除前是否确认

这样做的好处是，你不用凭记忆判断这张图还要不要，而是先看引用关系和目录分布。

我的建议流程

如果你经常用 Obsidian 写文章并发布到多个平台，可以把图片处理分成两步：

第一步，发布前处理图片：

本地图片 -> 上传 OSS -> 替换 Markdown 链接

第二步，发布后清理残留：

扫描 Vault -> 找出未引用图片 -> 确认后删除

NotePic 最新版本想做的就是把这两步连起来。

如果你长期写作、维护知识库、用 Git 管理 Vault，第二步也很重要。否则你的文章已经不依赖本地图片了，本地仓库却还一直背着这些历史附件。

常见问题

Obsidian 未引用图片可以直接删除吗？

不建议直接删除。更稳妥的做法是先扫描引用关系，再看目录、大小和文件名，确认不是素材、草稿或特殊插件引用后再删除。

清理图片会不会影响历史笔记？

如果图片确实没有被任何历史笔记引用，不会影响。但如果图片被特殊方式使用，就可能出现问题。所以清理前建议确认 Git 状态或做好备份。

上传到 OSS 后，本地图片还需要保留吗？

不一定。如果你只需要线上发布，且笔记里的引用已经替换成 OSS 链接，本地原图可以考虑清理。但如果你还想保留原始素材，或者担心 OSS 链接后续变动，可以继续保留。

NotePic 和 Clear Unused Images 有什么不同？

Clear Unused Images 这类工具主要解决清理未引用附件。NotePic 最新版本的重点是把这个能力放进图片发布工作流里：先上传 OSS、替换链接，再检查并清理上传后留在 Vault 里的本地残留图片。

最后

NotePic 最新版本已经发布：

https://github.com/Luhui-Dev/NotePic-OSS-Obsidian/releases/tag/1.2.0

项目页：

https://luhuidev.com/NotePic-OSS/

如果你也在用 Obsidian 写作、发布文章、用 Git 管理 Vault，可以试试这个版本。遇到特殊引用或清理误判场景，也欢迎通过 GitHub Issue 反馈。