“composer: command not found”根本原因是shell在PATH中未找到composer可执行文件，与Composer是否安装成功无关；常见情形包括：未将composer.phar所在目录（如/usr/local/bin或C:\ProgramData\ComposerSetup\bin）加入PATH、未赋予执行权限、终端未重载环境变量（如未source ~/.zshrc或未重启CMD）。
“composer: command not found”不是Composer没装好，而是系统根本没找到它——PATH没生效、安装路径错位、或终端没重载环境变量。
为什么终端认不出 composer 命令
这个报错和 Composer 本身是否能运行无关，只说明 shell 在当前 PATH 列表里查不到 composer 这个可执行文件。常见原因包括：
- 你用
php composer-setup.php下载了composer.phar，但没把它放到 PATH 路径下，也没加执行权限 - 你用
sudo curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer安装，但/usr/local/bin不在当前用户的 PATH 中（尤其 macOS 新版或某些 Linux 发行版） - 你改了
.bashrc或.zshrc加了 PATH，但没运行source ~/.zshrc，也没新开终端 - 你在 Windows 上用 Scoop 或 Chocolatey 安装，但没重启终端或没勾选“Add to PATH”选项
快速验证和修复 PATH 问题
别猜，直接查：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
which composer（macOS/Linux）或where composer（Windows），如果空白或报错，说明确实不在 PATH - 运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里有没有/usr/local/bin、C:\ProgramData\ComposerSetup\bin或你自定义的安装路径 - 如果
which composer返回空，但你知道composer.phar在~/Downloads/composer.phar，那就临时跑：php ~/Downloads/composer.phar install—— 这能绕过命令识别问题，先干活 - 要永久修复：把 composer 所在目录加进 PATH。例如 macOS 上编辑
~/.zshrc，追加一行：export PATH="$HOME/bin:/usr/local/bin:$PATH"，然后source ~/.zshrc
PhpStorm 里点「Composer → Install」没反应
这不是命令没装，是 IDE 没配对 PHP 环境和 Composer 路径：
- Settings → Languages & Frameworks → PHP → Composer →
Path to composer.phar必须填绝对路径，比如/usr/local/bin/composer，不能填composer或./composer.phar - 确保项目根目录下有
composer.json（哪怕空文件也行） - File → Project Structure → Project → Project SDK 必须选一个真实可用的 PHP 解释器，不能是
<No SDK> - 如果用了 Docker 或远程解释器，
composer得装在那个容器/远程机器里，且 PhpStorm 要能通过 SSH 或 Docker CLI 访问到它
PATH 错误最容易被当成“Composer坏了”反复重装，其实只要 which composer 一查就定位；更隐蔽的是 PhpStorm 里配置了路径却没配 SDK，或者 SDK 配了但没装 composer，这种组合问题得两个地方一起看。
