如何在 Mac 上卸载思源笔记
思源笔记把笔记、附件和工作空间设置放在本地工作空间里,macOS 版 3.8.5 和 3.8.6 初始位置是 ~/Library/Application Support/SiYuan,旧工作空间可能在 ~/SiYuan,也可以自行选择其他文件夹。移除应用数据或执行 Homebrew zap 前,先复制所有还要保留的工作空间。这份指南覆盖从思源 GitHub Releases 下载的版本和 Homebrew cask siyuan。
先找到你的工作空间
思源会把打开过的工作空间记在 ~/.config/siyuan 里,较新的版本第一次启动就会建这个文件夹。删任何东西之前,先看记录下来的路径和两个可能的位置:
ls -d "$HOME/Library/Application Support/SiYuan" "$HOME/SiYuan"
cat ~/.config/siyuan/workspace.json
ls -d会打印存在的位置,提示「No such file or directory」只说明那一处路径不存在,工作空间可能在别处,权限错误不能证明已经没了。cat会打印思源记下的工作空间路径,每一条都是一个要先备份的笔记文件夹。提示「No such file or directory」说明这个版本没写这份列表,回想一下当初设置思源时选的文件夹,卸载前先去看看。
复制前先退出思源,把整个工作空间复制到独立的备份位置,确认副本包含 data 文件夹和附件,备份不能放在准备删除的目录里,同步也不能代替独立备份。
退出并移除应用
- 按 Command + Q 退出思源,状态页里它是一行,六个进程,约 190 MB,会跟着应用一起退出。
- 把「应用程序」里的 SiYuan 移到废纸篓。
实测里它没有注册登录项或后台项目。
应用的数据放在哪里
在访达里按 Shift + Command + G,逐个打开下面的位置,不存在就跳过。工作空间位置依据思源的 macOS 源码,其他项目依据 Homebrew 的 zap 清单和实测记录。备份还要保留的数据并退出后,在上层文件夹里只选中对应的思源项目,移到废纸篓。
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
实际工作空间,macOS 版 3.8.5 和 3.8.6 初始为 ~/Library/Application Support/SiYuan |
笔记、附件和设置 | 先备份,确定不再需要这些笔记才删 |
~/.config/siyuan |
工作空间列表和应用日志 | 记下工作空间路径后再删 |
~/Library/Application Support/SiYuan-Electron |
桌面外壳自己的数据,启动一次后 1.9 MB,里面有 Cache、GPUCache 这类缓存子文件夹 |
随应用一起删 |
~/Library/Preferences/org.b3log.siyuan.plist |
偏好设置 | 随应用一起删 |
~/.siyuan |
cask 列出的其他思源状态 | 先检查、备份还要保留的内容再删 |
~/Library/Saved Application State/org.b3log.siyuan.savedState |
窗口状态 | 随应用一起删 |
检查结果
应用进了废纸篓以后,运行下面两条只读命令:
pgrep -il siyuan
ls -d "$HOME/Library/Application Support/SiYuan-Electron" ~/.config/siyuan
pgrep没有输出,说明思源没在运行,列出进程就是应用或它的某一部分还开着,先正常退出思源,再去动工作空间。ls -d会打印仍然存在的文件夹,在 Mole 里没勾的话,哪一个还在都是预期内的,提示「No such file or directory」就是已经没了。
用 Homebrew 安装时
移除 Homebrew 安装的应用时,Mole 会调用 Homebrew 卸载,只有 cask 的 zap 清单里每一条路径都在 ~/Library 里、没有一条是你没勾的行、也没有别的已装应用在用,才会加上 --zap,否则不加 --zap,你勾上的行仍由 Mole 自己清理。
siyuan 这个 cask 会在 Homebrew 的 bin 目录建立 siyuan 内核命令链接,brew --prefix 可以查看当前安装的前缀,普通卸载会连同应用移除这个受管理的链接。当前 zap 清单包含 ~/.siyuan、~/Library/Application Support/SiYuan、偏好设置和窗口状态,Application Support 这一项可能就是完整的笔记工作空间,所以 brew uninstall --cask --zap siyuan 会有删除笔记的风险,执行前先核实独立的工作空间备份。~/.siyuan 在 ~/Library 外面,Mole 对这个 cask 不执行 zap,只处理已勾选的行。移除应用和受管理的命令链接而不执行 zap:
brew uninstall --cask siyuan
思源笔记 GitHub · macOS 工作空间源码 · Homebrew 的 siyuan cask
Mole 会列出什么
关闭「卸载时一并移除数据和配置」时,Mole 对 GitHub 下载版思源的处理如下:
- 偏好设置文件、最近项目记录、macOS 为它保留的临时文件夹,以及
~/Library/Application Support/SiYuan-Electron里面的缓存子文件夹,默认勾选。 ~/Library/Application Support/SiYuan-Electron本身是按应用名认出来的,会列出,但默认不勾选。~/.config/siyuan会列出,但默认不勾选。- 现存的
~/Library/Application Support/SiYuan也可能作为应用数据列出,它可能就是笔记工作空间,先备份,要保留就取消勾选。Mole 不会查找自选工作空间位置或旧的~/SiYuan。
开启「卸载时一并移除数据和配置」后,上述支持文件夹和工作空间列表文件夹中符合条件的数据行可能预先勾选,继续前核对工作空间和其他数据文件夹,要保留的都取消勾选。
这次检查覆盖了什么
2026 年 9 月 26 日,把官方下载的思源 3.8.5 拷进「应用程序」,没有经过 Homebrew,启动一次,再用 Mole 的开发构建卸载,测试时把列出的项目全部勾上。状态页里它是一行 SiYuan,六个进程,约 190 MB,应用和列出的 11 行全部进了废纸篓,~/Library/Application Support/SiYuan-Electron 也在其中。这个版本第一次启动写下的 ~/.config/siyuan 当时不在列表里,留了下来,Mole 里它的那一行就是因此加上的,前后没有出现启动项。更早的两次用的是官方安装包里的 3.8.4,2026 年 9 月 20 日配 Mole 1.15 Preview 构建 280,9 月 21 日配 Preview 构建 282,全部勾选时都移走了 Application Support/SiYuan-Electron,那个版本也没有写 ~/.config/siyuan 或 ~/.siyuan。几次都没有建工作空间和笔记,没有开同步,Homebrew cask 也没有测试。
