根本原因不是安装失败，而是Composer全局安装的二进制文件（如laravel）位于vendor/bin目录，该路径未加入系统PATH环境变量，导致Shell无法定位命令；需手动将composer global config bin-dir --absolute输出的路径添加到PATH并重载配置。
装了 composer global require 却调不出命令？不是安装失败，是系统根本没找到那个可执行文件。
为什么 composer global require 装完还报 command not found
因为 Composer 只把二进制文件（比如 laravel、php-cs-fixer）软链接到全局 vendor/bin/ 目录，而这个路径默认不在你的系统 PATH 里。Shell 查不到，自然报错。
-
composer global require laravel/installer实际只做了两件事：下载包到~/.composer/vendor/（Linux/macOS）或%APPDATA%\Composer\vendor\（Windows），再把laravel软链接放进对应vendor/bin/ - 它不会自动改
PATH，也不碰你的 shell 配置文件 - 你手动敲
laravel --version，和系统找/usr/bin/ls是同一套机制——必须在PATH列表中才能命中
怎么确认并添加正确的 vendor/bin 路径到 PATH
别猜路径，用命令查准的：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 先看全局根目录：
composer config --global home→ 输出类似/home/alice/.composer或C:\Users\Alice\AppData\Roaming\Composer - 再查 bin 实际位置：
composer global config bin-dir --absolute→ 直接输出完整路径，比如/home/alice/.composer/vendor/bin - 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\vendor\bin
验证是否真生效，别信 composer global list
composer global list 只说明包进了 vendor，不代表命令能跑。真正验证得靠系统本身：
- Linux/macOS：运行
echo $PATH，确认输出里有你刚加的vendor/bin路径；再执行which laravel，有输出才算成功 - Windows：运行
echo %PATH%，确认含目标路径；再执行where laravel或直接laravel --version - 常见失败点：改了
~/.bashrc却用 zsh，或 Windows 写了%APPDATA%没展开，或改完没重启终端 / 没source
更新全局包时，别乱删 ~/.composer/vendor
全局包不是“装一次就完事”。PHP 版本升级、安全补丁、工具兼容性都可能出问题，但更新方式很明确：
- 查哪些过期：
composer global outdated—— 它比update更轻量，不改锁文件，只告诉你该升谁 - 升单个包（推荐）：
composer global update friendsofphp/php-cs-fixer，比require更安全，不会意外拉新依赖 - 全量升级：
composer global update—— 它读的是~/.composer/composer.json，按版本约束拉最新兼容版 - 绝对不要手动删
~/.composer/vendor或改里面文件：所有软链接立刻失效，which laravel就会空着回来
最常被跳过的一步，就是把 vendor/bin 加进 PATH；最容易被忽略的细节，是 shell 配置文件选错、路径没展开、改完没重载。这些不是 Composer 的缺陷，而是 Unix/Windows 系统查找可执行文件的基本规则。
