macos 上可通过 brew uninstall 精准卸载 homebrew 安装的软件：基础卸载 formula、--force 清多版本、--cask 卸图形应用、--zap 彻底清理 cask、--ignore-dependencies 强制移除被依赖包、批量卸载加 brew cleanup 清理残留。
如果您在 macOS 上通过 Homebrew 安装了软件包，但当前已不再需要，可通过 brew uninstall 命令精准移除。以下是多种可靠且可复现的操作路径，涵盖常规卸载、深度清理、跨类型（formula/cask）处理及依赖冲突应对：
一、基础卸载：使用 brew uninstall 移除公式包
该方法适用于通过 brew install 安装的标准开源软件（如 git、curl、python@3.11），仅删除主程序及其符号链接，不触及其他版本或依赖项。
1、打开终端应用。
2、执行 brew list 查看所有已安装的 formula 名称。
3、确认目标软件名后，输入命令：brew uninstall package-name（例如：brew uninstall wget）。
4、按回车执行，Homebrew 将自动解除链接并从 /usr/local/Cellar/ 中移除对应目录。
二、强制卸载全部版本：应对多版本残留
当同一 formula 存在多个历史版本（如 python@3.9、python@3.10、python@3.11 共存），默认 uninstall 仅删最新版。启用 --force 可一次性清除所有已安装版本及关联 keg 目录。
1、运行 brew list --versions | grep python 确认多版本存在。
2、执行命令：brew uninstall --force python@3.11（替换为实际包名）。
3、系统将遍历 /usr/local/Cellar/python@3.11/ 下所有子版本文件夹并彻底删除。
三、卸载图形化应用（Cask）：使用 --cask 参数
Homebrew Cask 用于管理 macOS 图形界面应用（如 Visual Studio Code、Google Chrome）。必须显式指定 --cask，否则命令无效。
1、列出已安装的 Cask 应用：brew list --casks。
2、执行卸载命令：brew uninstall --cask visualstudiocode。
3、该操作仅移除应用程序本体（位于 /Applications/）及基础链接，不清理用户偏好或缓存。
四、彻底清除 Cask 应用：启用 --zap 参数
--zap 调用 Cask 自带的专用卸载脚本，可删除应用在用户目录中散落的全部文件，包括偏好设置、日志、缓存与插件目录。
1、确保已安装目标 Cask（如 google-chrome）。
2、运行命令：brew uninstall --cask --zap google-chrome。
3、系统将依次清理：~/Library/Preferences/com.google.Chrome.plist、~/Library/Caches/com.google.Chrome、~/Library/Application Support/Google/Chrome 等路径。
五、绕过依赖检查：强制移除被依赖的包
当某 formula 被其他已安装包依赖时，Homebrew 默认拒绝卸载。若需强行移除（例如替换底层 OpenSSL 版本），可忽略依赖约束。
1、先检查依赖关系：brew deps --installed openssl，确认哪些包依赖它。
2、执行强制卸载：brew uninstall --ignore-dependencies openssl。
3、注意：此操作可能导致依赖该库的软件（如 curl、git）运行异常，需后续手动修复或重装。
六、批量卸载与残留清理协同操作
单次命令可同时卸载多个 formula，配合 brew cleanup 可立即清除旧版本缓存及未引用依赖，避免磁盘空间浪费。
1、输入批量卸载命令：brew uninstall node nginx ffmpeg（空格分隔多个包名）。
2、卸载完成后，立即执行：brew cleanup。
3、该命令将扫描 /usr/local/Cellar/，删除所有未被当前 formula 链接指向的旧版 keg，并清空 brew --cache 中的下载包。
