Composer全局二进制文件（如laravel、phpunit）实际位于composer global config bin-dir --absolute输出的路径中，需手动加入系统PATH才能调用；该路径与which composer返回的Composer自身路径无关。
Composer全局安装的二进制文件（如 laravel、phpunit）不在 which composer 返回的路径里，而是在 composer global config bin-dir --absolute 输出的目录中 —— 这个路径必须手动加进系统 PATH 才能直接调用命令。
怎么查全局二进制文件实际在哪
别猜，直接问 Composer 自己：
- 运行
composer global config bin-dir --absolute，输出就是laravel、php-cs-fixer这些命令真实所在的目录（例如/home/you/.composer/vendor/bin或C:\Users\You\AppData\Roaming\Composer\vendor\bin） - 如果命令报错“command not found”，先确认这行是否执行成功；失败说明全局配置损坏或 Composer 未初始化
- Windows 用户注意：PowerShell 中该命令可能因路径分隔符显示异常，建议改用 CMD 或 Git Bash 执行
为什么 which composer 和全局命令路径是两回事
which composer 找的是 Composer 自身这个可执行文件（比如 /usr/local/bin/composer），它只是个入口，和你 global require 装的工具完全无关。
- 全局包代码存放在
composer global config home --absolute对应的vendor/目录下 - 它们的二进制脚本被 Composer 复制或软链到
bin-dir，不是自动出现在which composer的目录里 - 常见错误：去
/usr/local/bin翻找laravel，结果什么都没有 —— 因为它压根不在这儿
PATH 没生效？检查这三件事
即使 bin-dir 路径正确，终端仍找不到命令，大概率卡在这几步：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- Linux/macOS：检查
echo $PATH输出是否含该路径；没出现就说明没写进 shell 配置（如~/.zshrc），要加export PATH="$(composer global config bin-dir --absolute):$PATH" - Windows：在 CMD 中运行
echo %PATH%，确认含%APPDATA%\Composer\vendor\bin；若无，需在“系统属性 → 环境变量”中手动添加用户变量 - IDE（如 PHPStorm）启动时不会自动重载新 PATH，要么重启 IDE，要么在设置里指定 Shell path（如
/bin/zsh）让它继承当前终端环境
想换全局安装位置？别重装，改 COMPOSER_HOME
修改路径不是靠删重装，而是告诉 Composer “换个家”：
- Linux/macOS：在
~/.zshrc里加export COMPOSER_HOME="$HOME/.my-composer"，再运行composer global require，所有包就会落到新位置 - Windows：新建用户环境变量
COMPOSER_HOME，值设为C:\my-composer，之后bin-dir和vendor都会基于这个根目录生成 - 改完必须重新执行一次
composer global require（哪怕装同一个包），否则旧路径下的 bin 文件不会自动迁移
最容易被忽略的一点：composer global config bin-dir 和 composer config --global vendor-dir 是两个不同配置项，前者决定命令在哪执行，后者决定源码放哪；两者默认同属一个 home 下，但可以独立配置 —— 如果你动过 vendor-dir 却忘了同步更新 bin-dir，命令就真会消失。
