Composer 全局安装实际是执行 composer global require,将包装入 ~/.composer/vendor(或自定义 COMPOSER_HOME),其二进制文件软链接至 vendor/bin/ 目录,需手动将该 bin 路径加入系统 PATH 才能直接调用命令。

Composer 全局安装工具(composer global require)本身不依赖 composer global 这个子命令——它根本不存在。真正起作用的是 composer global 后接的 require、list、show 等操作,而最关键的其实是 COMPOSER_HOME 和系统 PATH 的配合。
全局安装命令实际是 composer global require
Composer 没有独立的 composer global 命令;所谓“全局安装”,就是运行:
composer global require laravel/installer
这条命令会把包安装到 Composer 的全局 vendor 目录(默认是 ~/.composer/vendor),但此时还不能直接在终端里敲 laravel 运行——因为可执行文件没进 PATH。
-
composer global require安装的二进制文件放在~/.composer/vendor/bin/(Linux/macOS)或%APPDATA%\Composer\vendor\bin\(Windows) - 该目录必须手动加进系统
PATH,否则 shell 找不到命令 -
composer global list可查看已全局安装的包,composer global show查具体信息
为什么 laravel 命令找不到?检查 PATH 和 COMPOSER_HOME
常见错误现象:执行 composer global require laravel/installer 成功,但随后运行 laravel 提示 command not found。
- 先确认全局 bin 目录路径:
composer config --global home输出的就是COMPOSER_HOME,再拼上/vendor/bin - Linux/macOS:在
~/.bashrc或~/.zshrc中追加export PATH="$HOME/.composer/vendor/bin:$PATH",然后source ~/.zshrc - Windows:在系统环境变量中把
%APPDATA%\Composer\vendor\bin加入PATH - 如果改过
COMPOSER_HOME(比如用composer config --global home /opt/composer),那 bin 路径就变成/opt/composer/vendor/bin,PATH 也要同步更新
全局安装包的可执行文件怎么定位?
Composer 把包里 bin 字段声明的脚本软链接到全局 vendor/bin/ 目录,不是复制。所以删掉全局 vendor 后所有命令立刻失效。
- 查看某个包提供了什么命令:
composer global show laravel/installer --all | grep bin - 直接看链接:
ls -l ~/.composer/vendor/bin/,会看到类似laravel -> ../laravel/installer/bin/laravel - 如果某工具安装后命令名和预期不符(比如
phpunit而非phpunit7),说明它在composer.json的bin字段里只写了phpunit,无法覆盖 - 不建议用
composer global require --dev:全局没有 dev 概念,该参数被忽略
Windows 下 PowerShell 和 CMD 的 PATH 差异容易被忽略
在 Windows 上,即使你已在「系统属性 → 环境变量」里加了 %APPDATA%\Composer\vendor\bin,PowerShell 可能仍找不到命令——因为 PowerShell 默认不读取旧版系统 PATH 缓存,且对路径中空格、Unicode 更敏感。
- 重启终端(不是仅关标签页,要彻底关闭 PowerShell 窗口再重开)
- 运行
$env:PATH看是否真包含该路径;若无,用[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";%APPDATA%\Composer\vendor\bin", "User")补上 - CMD 下可用
where laravel验证,PowerShell 下用Get-Command laravel - 某些杀毒软件(如 McAfee)会拦截
.bat或.cmd文件执行,导致全局命令静默失败










