不推荐用 brew install composer，应先通过 Homebrew 安装 PHP（brew install php），再用官方脚本安装 Composer（curl -sS https://getcomposer.org/installer | php），并移至 /opt/homebrew/bin/composer，最后配置阿里云镜像源。
brew install composer 在当前（2026年）的 macOS 上**不推荐，且大概率失败或不可用**——Homebrew 社区已于 2023 年正式弃用该包，M1/M2 芯片下尤其常见 command not found: composer、PHP Parse error 或版本卡在 2.2.x 等问题。
真正可靠的方式是：**用 Homebrew 装 PHP，再用官方脚本装 Composer**。下面直奔关键环节。
确认 Homebrew 是否装在正确路径（M1/M2 用户必查）
Apple Silicon Mac 必须使用 /opt/homebrew 路径下的 Homebrew，否则后续所有路径都会错位。
- 运行
which brew—— 正常输出应为/opt/homebrew/bin/brew - 若显示
/usr/local/bin/brew，说明装的是 Intel 版，需彻底卸载重装：rm -rf /usr/local/bin/brew /usr/local/share/doc/homebrew /usr/local/share/man/man1/brew.1 /usr/local/share/zsh/site-functions/_brew /usr/local/etc/bash_completion.d/brew
arch -arm64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 重装后立即配置环境变量：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile
必须先装 PHP，且确保 php 命令可用
Composer 是 PHP 写的，没有可用的 CLI 版 PHP，Composer 根本跑不起来。macOS 自带 PHP 已被苹果完全移除（12+ 系统），不能依赖。
- 执行
brew install php（自动安装最新稳定版，如 PHP 8.3） - 验证：
php -v应输出版本号；which php必须是/opt/homebrew/bin/php - 若
php命令报错，检查~/.zprofile是否已加载 Homebrew 的环境变量（见上一步），不要往~/.zshrc里乱加 PATH
用官方脚本安装 Composer（唯一稳定方式）
别碰 brew install composer，它不更新、不兼容 ARM64、不绑定你刚装的 PHP，极易出现「明明装了却 command not found」。
- 下载并执行安装器：
curl -sS https://getcomposer.org/installer | php（生成composer.phar） - 移到系统可执行路径：
sudo mv composer.phar /opt/homebrew/bin/composer - 赋权：
sudo chmod +x /opt/homebrew/bin/composer - 验证：
composer --version输出类似Composer version 2.7.7即成功
国内用户务必配阿里云镜像源（否则 90% 情况会超时）
默认源 https://repo.packagist.org 在国内访问极不稳定，composer install 卡住、报 Connection timed out 是常态。
- 执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应返回阿里云地址 - 这步不是“可选”，是实际项目中能跑起来的前提
~/.zprofile 后没运行 source ~/.zprofile，或者开了新终端但没重新加载——结果反复重装 Composer，却始终 which composer 无输出。路径对了、权限给了、镜像配了，但环境变量没活过来，一切白搭。 
