composer global require安装的命令找不到，根本原因是%APPDATA%\Composer\vendor\bin（Windows）或~/.composer/vendor/bin（Linux/macOS）未加入系统PATH环境变量，需手动添加并重启终端验证。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

composer global require 不是“系统级安装”，只是用户级全局

它不会把命令装进 /usr/local/bin 或 C:\Windows\System32 这类所有用户都能访问的路径，也不会要求 sudo 或管理员权限。实际安装位置是当前用户的家目录下：~/.composer/vendor/（Linux/macOS）或 %APPDATA%\Composer\vendor\（Windows）。这意味着：

• 只有你当前这个 shell 用户能用这些命令
• sudo -i、su 切换用户后，laravel 就会报 command not found
• CI/CD 用 www-data 或 jenkins 用户跑脚本时，即使你本地装过 phpstan，也会找不到命令

根本原因是：路径归属和 PATH 都绑定在你自己的用户环境里，不是操作系统层面的“系统级”。

为什么装完 laravel 还提示 command not found

因为 composer global require laravel/installer 只做了两件事：解压包到 ~/.composer/vendor/，再把 laravel 可执行文件软链接进 ~/.composer/vendor/bin/。它**不修改 PATH，也不改 shell 配置文件**。 所以你敲 laravel，shell 根本没去那个目录找——它只查 $PATH 里列出的路径。 常见错误包括：

• 以为“装完就能用”，没配 PATH
• 改了 COMPOSER_HOME（比如设成 /opt/composer），但 PATH 还指向默认路径
• macOS Catalina+ 用 zsh，却往 ~/.bash_profile 里写 export PATH，结果不生效
• Windows 加了 %APPDATA%\Composer\bin（少了个 \vendor），路径错误

怎么确认并正确配置全局 bin 路径

别靠记忆或文档硬背路径，尤其当你改过 COMPOSER_HOME。直接问 Composer：

• 查真实 bin 路径：composer global config bin-dir --absolute（输出类似 /home/alex/.composer/vendor/bin）
• 查全局根目录：composer config --global home --absolute，再拼上 /vendor/bin

然后按系统操作：

• Linux/macOS：把 export PATH="$HOME/.composer/vendor/bin:$PATH" 加到 ~/.zshrc（zsh）或 ~/.bash_profile（bash），再运行 source ~/.zshrc
• Windows：在「系统属性 → 高级 → 环境变量」中，**用户变量**的 Path 新增该路径，**必须新开 CMD/PowerShell 窗口**才生效

验证方式：

• Linux/macOS：echo $PATH | grep composer 看是否含该路径；再 which laravel
• Windows：where laravel 或直接 laravel --version

容易被忽略的权限和兼容性细节

最常踩的坑不是命令写错，而是环境状态不对：

• 千万别用 sudo composer global require——会导致 ~/.composer 归属变成 root，后续所有全局操作都因权限失败；修复方法：chown -R $USER ~/.composer
• --dev 参数在全局安装里完全无效，composer global require --dev phpunit/phpunit 和不加一样
• composer global exec 是临时补救方案（如 composer global exec phpunit --version），但它不能替代 PATH 配置，交互式工具（如 psysh）可能卡住
• 包名必须精确匹配 Packagist 上的命名，比如 Deployer 是 deployer/deployer，不是 deployer 或 deployer_composer

真正让命令“全局可用”的，从来不是 composer global require 这条命令本身，而是你手动把它放进 PATH 的那一步。漏掉这步，等于只建了仓库，没修通往仓库的路。