Composer全局二进制文件默认路径不在系统PATH中,需手动添加:先运行composer global config bin-dir --absolute确认路径,再将该路径加入系统PATH环境变量,最后重载配置并验证。

安装完全局包后,Composer 默认会把二进制文件放在 ~/.composer/vendor/bin(Linux/macOS)或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin(Windows),但这个路径通常不在系统 PATH 里,所以命令无法直接执行。
确认 Composer 全局 bin 目录位置
先查清楚你的全局 bin 路径,避免配错:
- 运行
composer global config bin-dir --absolute,它会输出实际路径,比如/home/you/.composer/vendor/bin - 也可以直接看
composer global config home,然后拼出vendor/bin子目录
把 bin 目录加进系统 PATH
根据你的系统和 shell 类型,修改对应的配置文件:
-
Linux/macOS(Bash):编辑
~/.bashrc或~/.bash_profile,末尾加上:export PATH="$HOME/.composer/vendor/bin:$PATH" -
Linux/macOS(Zsh):编辑
~/.zshrc,加同样一行 -
Windows(CMD/PowerShell):在「系统属性 → 高级 → 环境变量」中,找到「用户变量」里的
Path,新增一行,填入你查到的完整 bin 路径(如C:\Users\YourName\AppData\Roaming\Composer\vendor\bin)
改完别忘了重载配置:终端里执行 source ~/.bashrc(或对应文件),或者新开一个终端窗口。
验证是否生效
运行两步检查:
- 输入
echo $PATH(macOS/Linux)或echo %PATH%(Windows CMD),确认刚加的路径在里面 - 运行
which xxx(Linux/macOS)或where xxx(Windows),xxx 是你全局安装的命令名(比如laravel、phpunit),能返回路径就说明成功了
基本上就这些。不复杂但容易忽略的是:改完 PATH 后没重载 shell 配置,或者路径写错了(比如漏掉 vendor/bin)。确认路径、加对位置、重载终端,三步走完就能用了。










