Composer安装失败后需彻底清理残留：先确认安装方式，再按路径删除主文件、~/.composer、缓存目录及XDG配置；清除shell别名、hash缓存和PATH引用；最后新开终端验证command not found且which无输出。
Composer 安装失败后，直接重装多半还会失败——因为残留的配置、缓存、PATH 引用甚至 shell 别名，会干扰新安装的识别和运行。彻底清理不是“删掉 composer 命令”就完事，而是要按安装来源分路径清除。
确认 Composer 是怎么装的，再决定怎么卸
不同安装方式留下的“尸体”位置完全不同，混着删容易漏或误删系统文件：
- 运行
which composer（Linux/macOS）或where composer（Windows），看输出路径：/usr/local/bin/composer→ 大概率是手动下载的composer.phar；/opt/homebrew/bin/composer→ 是brew装的；C:\ProgramData\ComposerSetup\bin\composer.bat→ 是 Windows 官方安装器 - Linux 上查包管理器状态：
dpkg -l | grep composer（Debian/Ubuntu）或rpm -qa | grep composer（RHEL/CentOS）；macOS 上查：brew list | grep composer -
关键原则：如果是
apt/brew/choco安装的，必须先用对应命令卸载（如sudo apt remove composer），否则只删文件会导致包数据库不一致，后续系统升级可能报错
手动安装残留的完整清除路径
如果你是用 curl -sS https://getcomposer.org/installer | php 或直接下载 composer.phar 安装的，以下目录一个都不能少：
- 删主可执行文件：
sudo rm $(which composer)（常见为/usr/local/bin/composer）；顺手检查当前目录有没有残留的composer.phar，也删掉 - 删用户级主目录：
rm -rf ~/.composer（含auth.json、config.json、vendor/全局包、cache/） - 删独立缓存目录（常被忽略）：
rm -rf ~/.cache/composer（Linux）、rm -rf ~/Library/Caches/composer（macOS）、%LOCALAPPDATA%\Composer\Cache（Windows） - 删 XDG 配置目录（新版或规范环境）：
rm -rf ~/.config/composer（部分 Linux 发行版或 macOS zsh + oh-my-zsh 用户会生成）
别忘了 shell 层的“幽灵引用”
即使所有文件都删光，终端仍可能“记得” composer —— 因为 hash 缓存、别名或 PATH 里还挂着旧路径：
- 运行
type composer：如果返回composer is aliased to ...或composer is a function，说明有 alias/function 覆盖，去~/.bashrc、~/.zshrc、~/.profile里搜alias composer=或function composer并删掉 - 运行
hash -d composer（Bash/Zsh）清除命令路径缓存；新开终端再试 - 检查 PATH 是否残留：
echo $PATH | tr ':' '\n' | grep -i composer；若发现类似/home/xxx/.composer/vendor/bin，就去 shell 配置里删掉对应export PATH=...行，然后source ~/.zshrc
验证是否真干净，别信“看起来没了”
清完不是结束，是验证开始。三个动作缺一不可：
- 新开终端（不能只是
source），运行composer --version→ 必须报command not found（Linux/macOS）或'composer' 不是内部或外部命令（Windows） - 运行
which composer或where composer→ 必须无任何输出 - 手动检查目录是否存在：
ls -la ~/.composer应提示No such file or directory；Windows 上在资源管理器地址栏粘贴%APPDATA%\Composer，应打不开
最容易被跳过的，是 ~/.cache/composer 和 shell 的 hash 缓存——它们不会影响 which，但会让新装的 Composer 读到旧缓存或走错配置路径，导致“明明重装了，却还是连不上镜像”。
