如何在 Mac 上卸载 qBittorrent
qBittorrent 的数据分在两个文件夹里,哪个都不是你的下载内容。下载好的文件在你设置的保存路径里,默认是 ~/Downloads,移除 App 从不碰它们,设置放在 ~/.config/qBittorrent,它追踪的 .torrent 文件、续传数据和日志放在 ~/Library/Application Support/qBittorrent,重装后还想接着下载或做种,就留着后面这个文件夹。这份指南覆盖从 qbittorrent.org 下载的官方版本和 Homebrew cask qbittorrent,两者装的是同一个 App。
停下传输,退出 qBittorrent
让正在进行的下载跑完,或者先暂停,再从 App 菜单退出 qBittorrent。卸载前不用删掉种子,真要删某个种子时,同时删除文件的那个选项别勾,除非你本来就想删掉下载内容。然后把 qBittorrent 从「应用程序」拖进废纸篓。
qBittorrent 的数据放在哪里
表里前两项来自 qBittorrent FAQ,其余来自 Homebrew cask 和 Mole 的实测。
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
~/.config/qBittorrent |
偏好设置,包括保存路径 | 重装后想恢复原来的设置,就先复制一份 |
~/Library/Application Support/qBittorrent |
qBittorrent 追踪的 .torrent 文件、续传数据和日志 |
以后还要续传或做种就留着,确定不再需要这些种子才移除 |
~/Library/Caches/qBittorrent |
缓存 | 可以放心移除 |
~/Library/Preferences/org.qbittorrent.qBittorrent.plist |
macOS 层面的 App 偏好设置 | 可以放心移除 |
~/Library/Preferences/qBittorrent |
3.3.6 之前的版本用的设置文件夹 | 存在的话可以放心移除 |
~/Library/Saved Application State/org.qbittorrent.qBittorrent.savedState |
窗口恢复状态 | 可以放心移除 |
保存路径故意没有写进这张表,卸载时永远不要删下载文件夹。
检查结果
在终端运行下面几条只读命令:
pgrep -il qbittorrent
ls -d ~/.config/qBittorrent
ls -d ~/Library/Application\ Support/qBittorrent
ls -d ~/Library/Caches/qBittorrent
pgrep没有输出,说明 qBittorrent 已经退出。- 每条
ls -d打印出路径说明文件夹还在,提示「No such file or directory」说明已经不在。你保留了设置和种子时,前两个还在是正常结果,缓存文件夹卸载后应该已经没了。
这里不检查下载文件夹,因为这份指南里没有任何一步会删它。
用 Homebrew 安装时
qbittorrent 这个 cask 的 zap 清单包括 ~/.config/qBittorrent(设置)、~/Library/Application Support/qBittorrent(种子文件和续传数据)、缓存、两处偏好设置和窗口恢复状态,运行 brew uninstall --cask --zap qbittorrent 会把这些全部移进废纸篓,不看 Mole 里勾了什么,它不包括下载文件夹。想保留设置和种子,只移除 App:
brew uninstall --cask qbittorrent
只有 zap 清单里的每一项都在你自己的 ~/Library 里、都是你留着勾选的行、也没有被其他已装应用认领时,Mole 才会加上 --zap。qBittorrent 的清单里有 ~/Library 之外的 ~/.config/qBittorrent,所以 Mole 卸载它时不带 --zap,只移走你勾选的行。
Mole 会列出什么
用 Mole 卸载时:
~/Library/Caches/qBittorrent、org.qbittorrent.qBittorrent偏好设置 plist、旧版的Preferences/qBittorrent文件夹和窗口恢复状态默认勾选。~/.config/qBittorrent和~/Library/Application Support/qBittorrent会列出但默认不勾选,你不勾,设置和种子就留着。- 卸载扫描不进入
~/Downloads,也不会遍历自定义目录来查找下载文件。
这次检查覆盖了什么
2026 年 9 月 19 日,安装官网下载的 qBittorrent,再用 Mole 的 Preview 构建卸载,这一轮显示了待确认列表。缓存和偏好设置默认勾选并被移走,~/.config/qBittorrent 和 ~/Library/Application Support/qBittorrent 没有勾选,留在了磁盘上,~/.config/qBittorrent 这一精确行是同一批测试里补进 Mole 的。记录里没有种子活动,所以这次测试不能说明真实的种子文件和续传数据会被保留,Homebrew cask 也不在测试范围内。
