推荐用 homebrew 安装 composer:先 brew install php(自动启用 phar),再 brew install composer;安装后需将 homebrew 的 bin 路径加入 ~/.zshrc 并 source,否则 command not found。

Mac 上装 Composer,直接用 Homebrew 最稳,别碰官方 PHP 脚本安装方式——它默认绕过系统 PATH、权限混乱、升级困难,90% 的“安装完 composer 命令找不到”都源于此。
Homebrew 安装是唯一推荐路径
Mac 系统自带的 PHP 版本老旧且不维护,而 Composer 依赖 PHP 运行时;Homebrew 能统一管理 PHP + Composer 版本,避免冲突。手动下载 composer.phar 后仅 chmod +mv 到 /usr/local/bin,看似简单,实则埋下三个坑:PHP CLI 版本不匹配、composer 执行时提示 Class 'Phar' not found、后续更新需重下 phar 并重复操作。
- 先确认已装 Homebrew:
which brew,没装就去官网复制命令跑一遍 - 装 PHP(带 Phar 支持):
brew install php(自动启用phar扩展) - 再装 Composer:
brew install composer - 验证:
composer --version和which composer应返回/opt/homebrew/bin/composer(Apple Silicon)或/usr/local/bin/composer(Intel)
遇到 command not found: composer 怎么办
不是没装成功,而是 shell 没加载新 PATH。Homebrew 安装后会提示类似 “Add to your ~/.zshrc”,但很多人忽略这步,或改错了配置文件。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查当前 shell:
echo $SHELL,Mac 默认是/bin/zsh - 编辑配置:
nano ~/.zshrc,末尾加一行:export PATH="/opt/homebrew/bin:$PATH"(Apple Silicon)或export PATH="/usr/local/bin:$PATH"(Intel) - 重载配置:
source ~/.zshrc - 别用
sudo强行 ln 到 /usr/bin —— SIP 保护会拒绝,且破坏系统完整性
为什么不用官方 install.php 方式
官方脚本 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" 本质是下载一个 phar 文件,但它不解决根本问题:
- 执行时用的是系统 PHP(
/usr/bin/php),默认禁用phar扩展,报错Phar extension is disabled - 即使手动开启,
php.ini路径分散(/etc/php.ini、/opt/homebrew/etc/php/8.3/php.ini),容易配错 - 装完的
composer.phar没有自动加入 PATH,每次要用全路径,比如php composer.phar install - 升级靠
php composer.phar self-update,但权限常出问题,尤其当 phar 在用户目录外时
真正麻烦的从来不是“怎么装”,而是“装完谁在跑、用哪个 PHP、PATH 是否生效、扩展是否启用”。Homebrew 把这四件事打包对齐了,其他路子都是自己补洞。










