composer命令能否运行取决于path环境变量是否包含其可执行文件路径，而非composer_home等配置；根本原因只有两个：composer.phar位置错误或所在目录未加入path。
composer 命令能在终端直接运行，**不是靠“设置全局变量”，而是靠把可执行文件（或包装器）放进系统 PATH 环境变量里**。所谓“设为全局变量”是常见误解，真正要动的是 PATH，不是 COMPOSER_HOME 或其他 Composer 配置项。
为什么composer命令找不到？根本原因只有两个
要么 composer.phar 文件没放对位置，要么它所在的目录没加进 PATH。其他所有报错（比如“command not found”、“不是内部或外部命令”）最终都归结于此。
- Linux/macOS：确认
/usr/local/bin/composer存在且有执行权限（chmod +x /usr/local/bin/composer）；若用自定义路径（如/opt/composer），必须把该路径加进PATH，不是只加composer.phar - Windows：不能只把
composer.phar放进 PHP 目录，必须配套建composer.bat，且这个.bat文件所在目录要加入PATH（例如C:\tools\composer\） - Mac M1/M2 用户注意：
/usr/local/bin可能被 SIP 保护，推荐改用$HOME/bin并确保它在PATH前置位（export PATH="$HOME/bin:$PATH"）
COMPOSER_HOME 和 composer 命令能不能运行完全无关
COMPOSER_HOME 控制的是全局配置、缓存、global require 安装的 CLI 工具存放位置（比如 laravel 命令），它不影响你敲 composer --version 能不能成功。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 设错
COMPOSER_HOME只会导致composer global require后命令不可用、composer config --global不生效，但composer install这类项目命令照常工作 -
COMPOSER_HOME必须是绝对路径，不能含~、$HOME、%USERPROFILE%；设完必须新开终端，再用composer config --list --global看 “Global configuration file” 路径是否匹配 - 验证
composer命令本身是否就绪，只看which composer（macOS/Linux）或where composer（Windows），跟COMPOSER_HOME输出无关
Windows 下最常踩的三个坑
Windows 用户卡在“命令不可用”的，90% 是这三个地方之一出了问题。
-
composer.bat编码不是 ANSI：用记事本另存为时选“ANSI”，别用 UTF-8（否则双击闪退、CMD 报错） - PATH 加的是
php.exe所在目录，但没确认composer.bat就放在那儿；或者加了composer.phar的路径，但.phar文件本身不能被 CMD 直接执行 - PHP 版本不一致：
php -v显示的是 8.2，但composer --version报 ext-zip 缺失——说明实际调用的 PHP CLI 是另一个旧版本（比如 WAMP 自带的），需检查where php和composer.bat里是否硬编码了 PHP 路径
Mac/Linux 用户容易忽略的权限细节
哪怕 composer 文件已在 /usr/local/bin/，也可能因权限或 SIP 导致执行失败。
- macOS Catalina 及以后，默认
/usr/bin只读，/usr/local/bin通常可写，但部分 M 系列 Mac 会限制；建议优先用sudo mkdir -p $HOME/bin && sudo mv composer.phar $HOME/bin/composer && chmod +x $HOME/bin/composer - Linux 上如果用
curl | php安装，输出提示 “successfully installed to: /usr/local/bin/composer.phar”，但没自动重命名为composer，得手动sudo mv composer.phar composer - Zsh 用户改完
PATH后，别只source ~/.zshrc，还要确认echo $SHELL是不是真指向 zsh；有些终端默认启动的是 bash，得改终端设置
composer 命令能否全局使用，本质是操作系统级的可执行路径查找问题，和 Composer 自身逻辑无关。PATH 没配对，其他所有配置都是空中楼阁。尤其 Windows 用户，别跳过 composer.bat 这一层——它不是可选项，是绕不开的兼容层。
