homebrew卸载开发工具需多步清理：先用brew uninstall或--cask --zap卸载主体，再执行brew autoremove和brew cleanup，手动删除配置、缓存、服务文件及失效软链接，重装前还需清理环境变量与镜像源。
homebrew 卸载开发工具不能只靠 brew uninstall，重装前必须清理软链接、缓存、配置残留和环境变量，否则容易出现命令冲突、路径错误或安装失败。
卸载单个开发工具（如 Node.js、Python、Git）
标准卸载仅移除主程序，不清理用户数据和配置文件：
- 命令行工具：直接运行
brew uninstall node或brew uninstall python@3.11 - GUI 应用（如 VS Code、Postman）：用
brew uninstall --cask visualstudiocode，加--zap可删偏好设置与缓存：brew uninstall --cask --zap zoom - 卸载后建议立刻执行
brew autoremove清理冗余依赖，再运行brew cleanup删除旧版本包和缓存
彻底清理工具残留文件
Homebrew 不会自动删除软件生成的配置、日志或数据目录，需手动检查：
macOS Automator Services
下载
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
- 用户级配置：查看
~/.config/、~/.<strong>toolname</strong>、~/Library/Application Support/<strong>ToolName</strong> - 缓存与日志：检查
~/Library/Caches/<strong>ToolName</strong>和~/Library/Logs/<strong>ToolName</strong> - 服务配置：若该工具注册了后台服务（如 MySQL、Redis），先停服
brew services stop mysql，再删~/Library/LaunchAgents/homebrew.mxcl.mysql.plist - 软链接断链：运行
find /usr/local/bin /opt/homebrew/bin -type l ! -e {} 2>/dev/null找出失效链接，确认无误后xargs rm删除
重置 Homebrew 环境（卸载 + 重装）
当多个工具冲突、PATH 错乱或 brew 自身异常时，推荐完整重置：
- 优先使用社区维护的一键脚本（自动适配芯片）：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)" - 手动补全清理（脚本未覆盖项）：
— 编辑~/.zshrc，删掉所有含/opt/homebrew/bin或/usr/local/bin的export PATH行
— 运行rm -rf ~/Library/Caches/Homebrew ~/Library/Logs/Homebrew
— Apple Silicon 用户额外执行sudo rm -rf /opt/homebrew，Intel 用户执行sudo rm -rf /usr/local/Homebrew /usr/local/bin/brew - 重装时用国内镜像加速：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
安装后立即验证：brew -v和brew doctor
重装后关键收尾操作
避免新环境“看似正常实则隐患”：
- 首次运行
brew update前，确认已切换镜像源（清华源最稳）：git -C $(brew --repo) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.gitgit -C $(brew --repo homebrew/core) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git - 检查
echo $PATH是否含正确路径（Apple Silicon 应为/opt/homebrew/bin，Intel 为/usr/local/bin），不含重复或旧路径 - 重新安装常用工具时，用
brew install --force覆盖可能残留的符号链接，再用brew link --force <strong>tool</strong>强制重建链接
