必须用官方脚本安装Composer并配置阿里云镜像源：先brew install php确保PHP路径正确，再curl安装composer.phar并移至/opt/homebrew/bin/（M系列）或/usr/local/bin/，最后执行composer config -g repo.packagist https://mirrors.aliyun.com/composer/。
别用—— 这个命令在 2026 年的 macOS（尤其是 M1/M2）上大概率失败，或装出一个根本不能用的旧版本。
为什么
现在不可靠
Homebrew 社区早在 2023 年就将
包标记为
，不再维护。它不兼容 Apple Silicon 的原生路径，常把
放进错误位置（比如
），导致
找不到；更常见的是卡死在
，而当前稳定版已是
。你运行
看到的可能是“PHP Parse error”，或直接报
——这不是你操作错了，是包本身已失效。
必须先确认 PHP 路径是否正确
Composer 是 PHP 脚本，没对的 PHP 就跑不起来。macOS 12+ 已彻底移除系统自带 PHP，
报错、或显示
以下，都说明不能直接用。
运行
：必须是
（M 系列）或
（Intel），否则重装 Homebrew
执行
：它会装最新稳定版（如 PHP 8.3）
验证：
有输出，且
返回
或
如果
还找不到，检查
是否含
，然后运行
用官方脚本安装并手动部署
这是目前唯一能稳定复现、ARM64 兼容、且始终同步最新版的方式。脚本会自动适配你本地的 PHP 版本，不绑死旧环境。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
执行
：当前目录生成
移到全局路径：
• M1/M2：
• Intel：
立刻赋权：
（缺这步必报
）
验证：
应输出类似
国内用户必须配阿里云镜像源
默认源
在国内极不稳定，
十次九超时，卡在
或直接报
——不是你网络差，是源本身不可靠。
运行
验证是否生效：
应显示该镜像地址
最容易被忽略的点是：没确认 PHP 路径就急着装 Composer，结果装完
命令能敲出来，但一执行就报
或找不到扩展——因为背后调用的其实是系统残留的旧 PHP，而不是你用 brew 装的新版。
brew install composerbrew install composercomposerdeprecatedcomposer.phar~/.homebrew/binwhich composerv2.2.xv2.7.7composer --versioncommand not found: composerphp -vPHP 8.0which brew/opt/homebrew/bin/brew/usr/local/bin/brewbrew install phpphp -vwhich php/opt/homebrew/bin/php/usr/local/bin/phpphp~/.zshrcexport PATH="/opt/homebrew/bin:$PATH"source ~/.zshrccurl -sS https://getcomposer.org/installer | phpcomposer.pharsudo mv composer.phar /opt/homebrew/bin/composersudo mv composer.phar /usr/local/bin/composersudo chmod +x /opt/homebrew/bin/composerPermission deniedcomposer --versionComposer version 2.7.7https://packagist.orgcomposer installResolving dependenciesConnection timed outcomposer config -g repo.packagist composer https://mirrors.aliyun.com/composer/composer config -g repo.packagistcomposerPHP Fatal error