首先确认PHP环境已正确配置,M1芯片Mac需通过Homebrew安装PHP并将其路径加入.zshrc;接着使用curl下载Composer安装器并移至/usr/local/bin目录,注意处理权限问题;最后配置国内镜像解决网络超时,运行composer --version验证安装成功。

在Mac M1芯片上安装Composer时遇到问题,通常与PHP环境、权限设置或网络访问有关。M1芯片使用ARM架构,部分工具链可能存在兼容性差异,但Composer本身是PHP脚本,只要PHP运行正常,安装过程和Intel Mac基本一致。重点在于确认环境就绪并处理常见卡点。
检查PHP环境是否正确配置
Composer依赖PHP运行,M1 Mac常通过Homebrew安装PHP,需确保命令行能调用正确版本。
- 在终端执行 php -v,查看是否有版本输出。若提示“command not found”,说明PHP未加入系统路径
- Homebrew安装的PHP通常位于 /opt/homebrew/bin/php,可通过 ls /opt/homebrew/bin/php* 确认
- 将PHP路径加入shell配置(如.zshrc):export PATH="/opt/homebrew/bin:$PATH",保存后执行 source ~/.zshrc
选择合适的安装方式并处理权限
推荐全局安装,避免每次进入项目目录才能使用。
- 下载安装器:curl -sS https://getcomposer.org/installer | php,会生成composer.phar
- 移动到全局目录:sudo mv composer.phar /usr/local/bin/composer
- M1 Mac的/usr/local/bin默认可能无写入权限,可先创建目录并授权:sudo mkdir -p /usr/local/bin && sudo chown $(whoami) /usr/local/bin,之后可免sudo操作
- 赋予执行权限:chmod +x /usr/local/bin/composer
解决网络连接超时或镜像问题
默认源在国外,M1设备联网时可能因DNS或防火墙导致请求挂起。
- 安装完成后立即配置国内镜像:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 若安装脚本本身下载失败,尝试分步操作:先用浏览器打开 https://getcomposer.org/installer 保存为installer.php,再执行 php installer.php
- 确认系统代理设置,若使用Clash、Surge等工具,确保TUN模式或全局模式开启










