Homebrew安装卡在link阶段因/usr/local/bin下存在同名文件冲突；需先用ls -l和readlink确认文件性质，再通过--dry-run预览、手动删除或--overwrite安全解决，最后用brew doctor预防复发。
Mac上执行brew install后卡在brew link阶段，提示“Target /usr/local/bin/xxx already exists”，说明Homebrew试图创建的软链接目标路径已被其他文件（可能是旧版可执行文件、手动拷贝的二进制、或残留链接）占据，系统拒绝覆盖。
确认冲突文件性质
先别急着删，用ls -l查看那个已存在的文件到底是什么：
ls -l /usr/local/bin/mole
如果输出显示是普通文件（如-rwxr-xr-x），说明是手动放进去或旧版本残留；如果是软链接（lrwxr-xr-x），再用readlink /usr/local/bin/mole看它指向哪——可能指向一个早已卸载的Cellar路径，此时它已是断链，可安全清理。
【切勿直接rm -rf /usr/local/bin】 这会误删所有Homebrew管理的命令，导致整个环境瘫痪。
安全解除冲突的三种方法
方法一：模拟覆盖，预览影响范围（推荐首选）
执行 brew link --overwrite mole --dry-run
该命令不改动任何文件，只列出将被删除或覆盖的路径。若输出仅含/usr/local/bin/mole一行，说明无其他关联文件被波及，可放心执行下一步。
方法二：手动移除冲突项后重建链接
rm /usr/local/bin/mole → brew link mole
这一步最干净，尤其适合你确认该文件确实无用。注意：如果mole是其他软件（非Homebrew安装）的必需组件，删前请查清来源。
方法三：强制覆盖（适合批量处理多个冲突）
brew link --overwrite mole
此操作会直接删除原文件并创建新链接。适用于你已通过--dry-run确认过影响面，且接受Homebrew接管该路径的场景。
预防同类问题反复发生
执行 brew cleanup 后，再运行 brew doctor
brew doctor 会扫描/usr/local/bin下所有文件，标出非Homebrew管理但与Formula同名的“可疑项”。对这类提示，可逐个检查是否仍需保留；若确认冗余，用 rm 手动清理即可。
今后安装前，建议先 brew search xxx 确认是否已装过，避免重复install触发link冲突。
