Composer全局工具安装：为什么装上了却用不了？
根本原因是PATH未包含Composer全局bin目录，需手动将$HOME/.composer/vendor/bin（Linux/macOS）或%APPDATA%\Composer\vendor\bin（Windows）加入系统PATH并重载配置，否则shell无法定位可执行文件。
用 composer global require 安装工具包确实简单，但安装成功绝不等于命令就能直接调用——除非你手动把那个隐藏的 vendor/bin 目录添加到系统的 PATH 环境变量里。
为什么 composer global require lara vel/installer 成功了却找不到 lara vel 命令
问题就出在路径隔离上。Composer 确实完成了它的工作：把包下载到全局目录，并在其中的 vendor/bin/ 下创建了可执行文件的软链接。然而，这个目录默认并不在系统搜索路径里。结果就是，你在终端里输入命令时，Shell 根本不知道要去哪里寻找它。
- 在 Linux 或 macOS 上，这个目录通常是
$HOME/.composer/vendor/bin（如果设置了COMPOSER_HOME环境变量，则路径为$COMPOSER_HOME/vendor/bin）。 - 在 Windows 上，路径则是
%APPDATA%\Composer\vendor\bin（注意，是vendor\bin，而不是Composer\bin）。 - 有个快速定位的方法：先运行
composer config --global home查看当前的COMPOSER_HOME目录；再运行composer global config bin-dir --absolute，这个命令会直接输出完整的bin目录绝对路径。 - 千万别被
composer global list显示的“已安装”状态迷惑了——这个列表只说明包已经躺在了vendor目录里，并不保证你在命令行里能调用它。
怎么让 lara vel、phpunit 这类命令真正生效
关键一步，就是把上面找到的那个 vendor/bin 路径，永久添加到系统的 PATH 环境变量中，并且重载配置使其生效。跳过这一步，百分之百会遇到 command not found 的错误。
- Linux/macOS 用户：打开你的 shell 配置文件（如果是 zsh 则是
~/.zshrc，如果是 bash 则是~/.bash_profile），在文件末尾添加一行：export PATH="$HOME/.composer/vendor/bin:$PATH"
然后，运行source ~/.zshrc（或source ~/.bash_profile）让配置立即生效。 - Windows 用户：打开「系统属性 → 高级 → 环境变量」，在「用户变量」区域找到并编辑
Path变量，新增一行：%APPDATA%\Composer\vendor\bin - 如何验证？
在 Linux/macOS 终端运行echo $PATH | grep composer，看看输出是否包含你的 composer 路径。
在 Windows 命令提示符运行echo %PATH%，检查路径是否存在。
最后，直接试试新命令：lara vel --version或phpunit --version，能输出版本信息就大功告成。
composer global 不是独立命令，--dev 参数会被忽略
这里有个常见的语法误解：composer global 本身不是一个可执行的命令，单独运行它会报错。它实际上是一个命名空间前缀，后面必须跟上具体的子命令，比如 require、list、update。
- 所以，唯一正确的写法是：
composer global require vendor/package-name。 - 另外，像
composer global require --dev phpunit/phpunit这样的命令，其中的--dev参数是完全无效的。因为全局安装的包是跨项目使用的，Composer 在这里并不区分开发依赖和稳定依赖。 - 想要升级所有已安装的全局包？使用
composer global update。切记，不要手动删除~/.composer/vendor目录，否则所有依赖它的命令行工具会立刻失效。 - 需要卸载某个全局包？Composer 没有
uninstall命令，正确做法是使用composer global remove vendor/package-name（此功能在 Composer 2.5 及以上版本支持）。
说起来，最容易踩的坑还不是路径配错，而是忘了重载配置。在 Linux/macOS 上，修改了 .zshrc 或 .bash_profile 后，如果不执行 source 命令，当前终端会话依然读不到新路径。Windows 用户也一样，修改环境变量后，必须重新打开一个命令提示符或终端窗口，新的 PATH 才会生效。旧窗口里的环境变量是不会自动更新的。
