Homebrew Cask 卸载默认仅删应用本体,--zap 参数可深度清理用户配置、缓存、日志等文件,命令为 brew uninstall --cask --zap [app-name];卸载后若/Applications中仍有残留,需手动 rm -rf 删除。
homebrew cask 卸载软件默认是安全删除,只移除应用本体和已知关联文件。如果遇到残留、冲突或卸载失败,需要“强制”清理——核心手段是 --zap 参数,它会删除更深层的用户配置、缓存、日志等文件。
用 --zap 强制清除 Cask 应用(推荐)
--zap 是 Homebrew Cask 提供的“深度卸载”模式,比普通 brew uninstall --cask 更彻底,适用于想清空所有痕迹的场景(比如重装前、换账号、排查异常)。
- 基本命令:
brew uninstall --cask --zap [app-name](例如:brew uninstall --cask --zap visualstudiocode) - 执行后会列出将被删除的所有路径(如
~/Library/Application Support/Code、~/Library/Preferences/com.microsoft.VSCode.helper.plist等),确认无误再按回车继续 - ⚠️ 注意:
--zap可能删掉多个应用共用的配置(如某些字体、通用偏好设置),非必要不建议对日常工具频繁使用
卸载后仍残留?手动补删关键位置
即使用了 --zap,部分 GUI 应用的主程序可能还留在 /Applications(尤其当安装时用了拖拽方式或符号链接)。这时需手动清理:
- 检查是否还在应用目录:
ls "/Applications/[App Name].app" - 确认后直接删除:
rm -rf "/Applications/[App Name].app" - 顺手扫一眼这几个高频残留区(可选):
~/Library/Caches/[App Name]*~/Library/Logs/[App Name]*~/Library/Saved Application State/[com.vendor.AppName].savedState
卸载失败?先查状态再强删
如果提示 “Not installed” 或 “No available formula”,说明 Homebrew 记录里已不存在该 Cask,但文件还在。这时不用 --zap,直接走文件清理:
- 用
brew search [app-name]确认是否真在 Cask 列表中 - 用
brew list --cask查看当前所有已记录的 Cask 应用 - 若不在列表中,就跳过 brew 命令,转为手动删
/Applications和~/Library下对应文件夹
附:常用 Cask 名称查询技巧
Cask 的内部名称常和 App 显示名不同(比如 “Google Chrome” 对应 google-chrome,“Microsoft Edge” 是 microsoft-edge)。不确定时:
- 搜索:
brew search chrome - 或查官网列表:
brew search --desc "browser" - 也可打开 formulae.brew.sh/cask 在线浏览


















