在 Mac 上卸载 Obsidian

Obsidian 的库就是你自己保存的一整个笔记文件夹。卸载编辑器不需要删除它，重新安装后仍可打开原来的库。开始前先备份每一个库。本文覆盖官网下载版和 Homebrew cask。

先找到并备份库

在 Obsidian 中确认当前库的位置，退出应用后复制整个库文件夹，笔记、附件和隐藏的 .obsidian 配置一起保留。在 Finder 按 Shift + Command + . 可以显示隐藏文件。别只拷走 Markdown，却漏掉附件和插件配置。Obsidian 的数据存储说明

如果库放在 iCloud 云盘里（Obsidian 帮助文档把它建在 iCloud 云盘 › Obsidian 下），先确认所有文件都已下载完成，再把库复制到 iCloud 云盘以外的文件夹，并打开副本检查。要复制，不要移动：把文件夹移出 iCloud 云盘，会把它从 iCloud 和其他设备上一并移除。在多台设备间同步笔记

移除应用，保留笔记

退出 Obsidian，把「应用程序」中的 Obsidian 移到废纸篓。你的库不应被当作应用缓存删除。

Obsidian 自己的数据在哪里

Obsidian 把应用级设置和库分开存放：

全局设置目录的位置来自 Obsidian 帮助文档，文档还提醒不要把库建在这个目录里。删掉它不会影响存放在别处的库：重装后在 Manage Vaults 里用 Open folder as vault 重新打开原来的库即可。管理库

检查结果

在「终端」运行下面三条只读命令。把 VAULT_PATH 换成你备份副本的路径：

pgrep -ilf "Obsidian.app"
ls -d "$HOME/Library/Application Support/obsidian"
ls -a "VAULT_PATH"

pgrep 没有输出，说明 Obsidian 已不在运行。第二条报「No such file or directory」表示全局设置已不存在，列出路径表示它还在。最后一条应当列出你的笔记和 .obsidian；如果没有 .obsidian，说明备份丢了库设置和插件。

最后用 Finder 打开备份，检查几篇笔记和它们引用的附件。使用同步服务时还要核对另一设备上的最新内容，同步本身不能代替独立备份。

重装时找不到原来的库

先在 Finder 找到备份库里的 Markdown、附件和隐藏的 .obsidian 文件夹，确认它们仍在同一库目录，再从 Obsidian 打开现有库，不要创建同名空库来覆盖原位置。若插件配置没回来，检查备份是否包含 .obsidian/plugins，只复制笔记正文并不能恢复插件。

用 Homebrew 安装时

Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。

自己运行 brew uninstall --cask --zap obsidian 时，cask 的 zap 清单独立执行，不看 Mole 里的勾选。清单包括 ~/Library/Application Support/obsidian、偏好设置和窗口状态，不包括任何库。这个 cask 还装了 obsidian 命令行链接，它会随应用一起移除。Homebrew 的 Obsidian cask

想保留全局设置目录时运行：

brew uninstall --cask obsidian

Mole 会列出什么

偏好设置和窗口状态默认勾选，「卸载时一并移除数据和配置」默认关闭，此时 ~/Library/Application Support/obsidian 会列出但不勾选，全局设置可以留给重装，开启后这类应用自有数据可以预先勾选，想保留设置就取消勾选，里面 Chromium 缓存单独列出并默认勾选，Mole 不会列出保存在自选文件夹里的库。

这次检查覆盖了什么

2026 年 9 月 17 日的卸载走的是 Homebrew cask，用的是 Mole 的开发构建。2026 年 9 月 26 日又从官网磁盘映像装上 Obsidian 1.13.7，打开一次，用 Mole 的开发构建把所有行都勾上卸载，Mole 的状态页把 Obsidian 显示成一行，下面折叠了 6 个进程，应用和 ~/Library/Application Support/obsidian 在内一共 12 项都进了废纸篓，之后磁盘上一项都没有留下，也没有出现登录项或 LaunchAgent。两次都没有创建库，也没有测试同步或数据恢复。