Composer怎么在Mac安装 Composer怎么使用Brew配置环境【指南】

唯一可靠方式是先装匹配架构的php，再用官方脚本下载composer.phar并移至对应路径赋权；必须配置阿里云镜像源，且which composer输出路径须与brew一致，否则未真正生效。

确认 PHP 是否真可用（不是“有就行”，而是“路径对、版本新、能调用”）

macOS 12+ 已彻底移除系统自带 PHP，php -v 报错或显示 PHP 8.0 以下，都说明不能直接用。Homebrew 安装的 PHP 必须和你的芯片架构匹配——M 系列必须走 /opt/homebrew/bin/php，Intel 才是 /usr/local/bin/php。

• 运行 which brew：输出必须是 /opt/homebrew/bin/brew（M 系列）或 /usr/local/bin/brew（Intel），否则 Homebrew 装错了位置
• 运行 brew install php：它会装最新稳定版（如 PHP 8.3），不是旧版
• 运行 php -v 和 which php：两个命令都必须成功，且 which php 输出路径要和 which brew 一致层级（都是 /opt/homebrew/bin/xxx）
• 如果 php 命令仍无效，检查 ~/.zshrc 或 ~/.zprofile 是否含 export PATH="/opt/homebrew/bin:$PATH"（M 系列）或 export PATH="/usr/local/bin:$PATH"（Intel），然后执行 source ~/.zshrc

用官方脚本安装 composer.phar（唯一推荐方式）

Homebrew 的 composer 包不再更新，绑定的是旧 PHP，还可能因权限问题拒绝执行；而官方脚本能确保拿到 ARM64 兼容、PHP 版本解耦、当前最新版（如 v2.7.7）的可执行包。

拍我AI

AI视频生成平台PixVerse的国内版本

下载

• 执行 curl -sS https://getcomposer.org/installer | php：生成本地文件 composer.phar
• 移动到全局路径：sudo mv composer.phar /opt/homebrew/bin/composer（M1/M2）或 sudo mv composer.phar /usr/local/bin/composer（Intel）
• 立刻赋权：sudo chmod +x /opt/homebrew/bin/composer（对应路径）
• 验证：composer --version 应输出类似 Composer version 2.7.7；若报 command not found，说明路径没进 $PATH

配置阿里云镜像源（不配=90%概率卡死）

默认源 https://packagist.org 在国内访问极不稳定，composer install 或 composer require 经常卡住、报 Connection timed out，这不是网络问题，是源本身不可达。

• 运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 该命令写入全局配置（~/.composer/config.json），所有项目自动生效
• 验证是否生效：执行 composer config -g repo.packagist，应输出 https://mirrors.aliyun.com/composer/

为什么 which composer 比 composer --version 更关键？

很多人在 ~ 目录下跑通了 composer --version 就以为装好了，结果一进项目目录就报错——这说明 composer 只是当前目录临时能用，根本没进系统 PATH。真正可靠的验证是跨目录调用 + 查真实路径。

• 换到任意子目录，比如 cd ~/Sites/test，再运行 composer --version
• 运行 which composer：必须输出 /opt/homebrew/bin/composer（M 系列）或 /usr/local/bin/composer（Intel），而不是 ./composer 或 /Users/xxx/composer
• 如果 which composer 无输出，检查 echo $PATH 是否含对应路径；若缺失，确认 ~/.zshrc 或 ~/.zprofile 已添加且执行过 source