根本原因不是安装失败，而是shell找不到可执行文件；composer global require仅将包放入全局vendor目录并软链接bin脚本到vendor/bin，该路径未加入系统path，需手动配置并重载终端。
composer global require 为什么装完命令还是 command not found
不是安装失败，是 shell 根本没找到那个可执行文件。composer global require 只做两件事：把包放进 ~/.composer/vendor（Linux/macOS）或 %APPDATA%\Composer\vendor（Windows），再把 composer.json 里 bin 字段声明的脚本软链接到对应 vendor/bin 目录。不改系统 PATH，它就永远在“隐身”状态。
- 验证方式：
which laravel（macOS/Linux）或where laravel（Windows）无输出 → 路径没生效 - 检查当前
PATH：echo $PATH或echo %PATH%里没有~/.composer/vendor/bin或%APPDATA%\Composer\vendor\bin - 别靠记忆拼路径：运行
composer global config bin-dir --absolute，它会直接吐出真实路径，比如/home/alex/.composer/vendor/bin
怎么正确配置 PATH 让全局命令可用
必须手动把全局 bin 目录加进系统环境变量，且改完要重载或新开终端——旧窗口不会自动继承新 PATH。
- Linux/macOS：
~/.zshrc（zsh 用户）或~/.bash_profile（bash 用户）末尾加一行：export PATH="$HOME/.composer/vendor/bin:$PATH"，然后运行source ~/.zshrc - Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 在「用户变量」的
Path中新增完整路径，例如C:\Users\Alice\AppData\Roaming\Composer\vendor\bin（不能写%APPDATA%，系统不展开） - 如果改过
COMPOSER_HOME（如用composer config --global home /opt/composer），那bin路径就是/opt/composer/vendor/bin，PATH也得同步更新
composer global require 的常见误操作和限制
它不是万能安装器，有明确边界和行为陷阱。
-
--dev参数会被忽略：全局安装不区分require和require-dev，加了也白加 - 别用
sudo composer global require：会导致~/.composer归属变成root，后续所有全局操作权限失败；修复只需chown -R $USER ~/.composer - 只适合 CLI 工具类包：比如
laravel/installer、phpunit/phpunit、friendsofphp/php-cs-fixer；别装monolog/monolog这类库，装了也调不了，还可能污染 autoload - 它不注入项目运行时：全局包不会出现在项目
vendor/autoload.php里，require或use语句完全找不到它们
替代方案：composer global exec 是临时补救，不是长期解法
composer global exec 是 Composer 5.4+ 加入的功能，能绕过 PATH 缺失问题，直接在全局环境中调用已安装命令，比如 composer global exec laravel new blog。
- 前提是你已经用
composer global require安装过对应包，否则报错Command "laravel" is not defined - 不支持完整 TTY：像
psysh这类需要交互的命令可能卡住输入 - 每次都要多打前缀，高频使用反而更麻烦
- 它不解决底层问题：PHP 版本错配、autoload 冲突、扩展缺失等问题依然存在
最常被忽略的其实是路径拼写细节和 shell 配置重载动作——哪怕 export PATH=... 写对了，没 source 或没开新终端，命令就永远在“差一步”的状态。
