composer怎么全局安装工具_global命令使用与环境变量配置【教程】

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%Composervendorbin（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%Composervendorbin 加入 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%Composervendorbin，PowerShell 可能仍找不到命令——因为 PowerShell 默认不读取旧版系统 PATH 缓存，且对路径中空格、Unicode 更敏感。

• 重启终端（不是仅关标签页，要彻底关闭 PowerShell 窗口再重开）
• 运行 $env:PATH 看是否真包含该路径；若无，用 [Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";%APPDATA%Composervendorbin", "User") 补上
• CMD 下可用 where laravel 验证，PowerShell 下用 Get-Command laravel
• 某些杀毒软件（如 McAfee）会拦截 .bat 或 .cmd 文件执行，导致全局命令静默失败