如何在 Mac 上卸载 OpenCode
OpenCode 桌面版和单独安装的 OpenCode 命令行工具共用 ~/.config/opencode 和 ~/.cache/opencode,卸桌面版时这两个都该留着。本文覆盖从 opencode.ai 官网下载的 OpenCode 桌面版和 Homebrew cask opencode-desktop,命令行工具要不要一起删,用它自己的命令单独处理。
退出 OpenCode 桌面版
从应用菜单退出 OpenCode 桌面版,再打开「活动监视器」确认没有残留的 OpenCode 进程。
把 OpenCode 移到废纸篓
在 Finder 打开「应用程序」,把 OpenCode 移到废纸篓。
核对应用数据
在 Finder 按 Shift + Command + G,逐个输入下面的路径,不存在的直接跳过。
| 位置 | 装的是什么 | 如何处理 |
|---|---|---|
~/Library/Application Support/ai.opencode.desktop |
桌面版数据(这次测试 3.6 MB) | 随桌面版一起删即可 |
| 更新器的下载缓存(这次测试约 299 MB) | 下载好的更新文件 | 可以删除 |
~/.config/opencode |
配置,包括 opencode.json(见 OpenCode 配置文档),这次测试 61 MB |
和 OpenCode 命令行工具共用,还在用命令行就留着 |
~/.cache/opencode |
缓存数据,这次测试 8.4 MB | 和命令行工具共用,还在用命令行就留着 |
用 Homebrew 安装时
opencode-desktop 这个 cask 的 zap 清单只列了 ~/Library 里带桌面版 id ai.opencode.desktop 的路径,Application Support、Caches、HTTPStorages、Logs、Preferences、Saved Application State、WebKit,再加它的最近文稿记录,没有 ~/.config/opencode 和 ~/.cache/opencode,所以就算运行 brew uninstall --cask --zap opencode-desktop,命令行工具的文件也会留下,不加 --zap 就只删应用:
brew uninstall --cask opencode-desktop
Mole 卸载 Homebrew 装的 OpenCode 桌面版时,zap 清单里存在的每一项都对应 Mole 默认勾选的行,所以只要你没取消勾选其中一行,Mole 就会带上 --zap,取消了就不加。
单独处理命令行工具
OpenCode 的 CLI 参考文档里有一条 opencode uninstall,用来删除 OpenCode 和相关文件,--keep-config(-c)保留配置,--keep-data(-d)保留会话数据和快照,--dry-run 只显示会删什么、不真删,--force(-f)跳过确认。卸桌面版不会运行这条命令,想把命令行工具也删掉,先预览一遍:
opencode uninstall --dry-run
预览只列出命令行工具的卸载会删掉的内容,不删任何东西,提示「command not found」说明没装命令行工具,或者当前 shell 的 PATH 里找不到它。
核对卸载结果
pgrep -il opencode
ls -d "$HOME/Library/Application Support/ai.opencode.desktop"
ls -d "$HOME/.config/opencode" "$HOME/.cache/opencode"
command -v opencode
pgrep没有输出,说明没有 OpenCode 进程在运行,列出进程说明桌面版或命令行工具还在跑,先退出再继续。ls -d把 Application Support 路径打印出来,说明桌面版的数据还在,提示「No such file or directory」说明已经删掉。ls -d把配置和缓存路径打印出来,说明命令行工具的文件完好,只删桌面版时本来就该这样。command -v opencode打印出路径说明命令行工具还装着,没有输出只说明当前 shell 找不到它,不代表文件都没了。
Mole 会列出什么
对于从 opencode.ai 官网下载安装的 OpenCode 桌面版:
~/Library/Application Support/ai.opencode.desktop、更新器的下载缓存,以及其他以ai.opencode.desktop命名的行都会列出,默认勾选,扫描时~/Library/Application Support/com.apple.sharedfilelist下如果已有它的最近文稿记录,也在其中。~/.config/opencode和~/.cache/opencode不会列出,因为命令行工具也在用。
这次检查覆盖了什么
2026 年 9 月 22 日,从 opencode.ai 下载 OpenCode 桌面版 1.18.31,拷进「应用程序」,用一个开发构建的 Mole 退出并移除,同一轮还有另外九款应用。属于 OpenCode 的行都勾上了,应用本体(428.9 MB)、一份更新器缓存(299.3 MB)和 Application Support 文件夹(3.6 MB)进了废纸篓,~/.config/opencode(61 MB)和 ~/.cache/opencode(8.4 MB)没有列出,原样留着,OpenCode 的最近文稿记录卸载后也还在。登录、命令行工具自己的卸载、安装更新以及 Homebrew cask 都没有实测。
