如何在 Mac 上卸载思源笔记
思源笔记是本地优先的,笔记都在 Mac 上的一个工作空间文件夹里,没改过位置的话是 ~/SiYuan,没开思源的同步就只有这一份。移除应用不会碰这个文件夹,Mole 也不会列出它,所以真正要决定的是你自己,要么留着等重装,要么复制到安全的地方再自己删。这份指南覆盖从思源 GitHub Releases 下载的版本和 Homebrew cask siyuan。
先找到你的工作空间
思源会把打开过的工作空间记在 ~/.config/siyuan 里,较新的版本第一次启动就会建这个文件夹。删任何东西之前先看两处:
ls -d ~/SiYuan
cat ~/.config/siyuan/workspace.json
ls -d打印出~/SiYuan,说明默认工作空间存在,提示「No such file or directory」说明你没用默认位置,或者它已经不在了。cat会打印思源记下的工作空间路径,每一条都是一个要先备份的笔记文件夹。提示「No such file or directory」说明这个版本没写这份列表,回想一下当初设置思源时选的文件夹,卸载前先去看看。
退出并移除应用
- 按 Command + Q 退出思源,状态页里它是一行,六个进程,约 190 MB,会跟着应用一起退出。
- 把「应用程序」里的 SiYuan 移到废纸篓。
实测里它没有注册登录项或后台项目。
应用的数据放在哪里
在访达里按 Shift + Command + G,逐个打开下面的位置,不存在就跳过。思源没有公开说明这些路径,下表依据 Homebrew 的 zap 清单和实测记录。
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
你的工作空间,默认 ~/SiYuan |
笔记、附件和设置 | 先备份,确定不再需要这些笔记才删 |
~/.config/siyuan |
工作空间列表和应用日志 | 记下工作空间路径后再删 |
~/Library/Application Support/SiYuan-Electron |
桌面外壳自己的数据,启动一次后 1.9 MB,里面有 Cache、GPUCache 这类缓存子文件夹 |
随应用一起删 |
~/Library/Preferences/org.b3log.siyuan.plist |
偏好设置 | 随应用一起删 |
检查结果
应用进了废纸篓以后,运行下面两条只读命令:
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 还会在 /opt/homebrew/bin 里把内核链接成 siyuan 命令,卸载 cask 时 Homebrew 会一起删掉。它的 zap 清单包含 ~/.siyuan、~/Library/Application Support/SiYuan、偏好设置文件和窗口状态,其中 ~/.siyuan 在 ~/Library 外面,所以 Mole 卸载思源时从不加 --zap。清单里也没有默认工作空间 ~/SiYuan,自己运行 brew uninstall --cask --zap siyuan 不会动你的笔记。只想移除应用和命令链接:
brew uninstall --cask siyuan
思源笔记 GitHub · 默认工作空间路径 · Homebrew 的 siyuan cask
Mole 会列出什么
以下是 Mole 对 GitHub 下载版思源的处理:
- 偏好设置文件、最近项目记录、macOS 为它保留的临时文件夹,以及
~/Library/Application Support/SiYuan-Electron里面的缓存子文件夹,默认勾选。 ~/Library/Application Support/SiYuan-Electron本身是按应用名认出来的,会列出,但默认不勾选。~/.config/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 也没有测试。
