根本原因是Composer全局安装路径权限冲突，正确做法是用户级安装并配置$PATH：确保COMPOSER_HOME为~/.composer，将~/.composer/vendor/bin加入$PATH，重装工具，且修改后需source配置或重启shell。
Composer 报 EACCES 错误，直接加 sudo 不行
根本原因不是“权限不够”，而是 Composer 默认把全局二进制文件（比如 laravel、phpunit）装到系统级路径（如 /usr/local/bin），而你没写入权限。硬加 sudo composer global require 会导致后续所有全局命令都得用 sudo 才能运行——这不是解决，是埋雷。
- 全局安装的包会依赖
~/.composer/vendor/bin这个目录，它默认不在$PATH里 -
sudo composer global require实际把文件写进/root/.composer/...，普通用户根本访问不到 - 一旦用了
sudo，后续composer global list看不到包，which xxx找不到命令，连 debug 都卡住
正确做法：改用用户级安装 + 补全 $PATH
Composer 官方推荐且唯一可持续的方式，就是让所有全局操作都在当前用户目录下完成，不碰系统路径。
- 确认
COMPOSER_HOME没被错误设为/root/.composer：echo $COMPOSER_HOME，如果不是空或~/.composer，就删掉对应export COMPOSER_HOME=...行 - 确保
~/.composer/vendor/bin已加入$PATH：检查echo $PATH是否含该路径；没有就加到~/.bashrc或~/.zshrc末尾：export PATH="$HOME/.composer/vendor/bin:$PATH" - 重装一次全局工具（如
laravel/installer）：先composer global remove laravel/installer，再composer global require laravel/installer
遇到 Could not open input file: composer.phar 怎么办
这是典型的 composer 命令本身没装对，和全局 require 无关。别急着重装 PHP 或换源。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 先查
which composer，如果输出为空，说明composer没进$PATH，或者你只下载了composer.phar但没做可执行链接 - 推荐用官方安装脚本（不用
sudo）：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"→php composer-setup.php --filename=composer --install-dir=$HOME/bin - 确保
$HOME/bin在$PATH前面，否则可能被系统自带的老版本覆盖（比如 Ubuntu 自带的/usr/bin/composer是阉割版）
CI/CD 或 Docker 里权限问题更隐蔽
在容器或部署脚本中，USER 切换后容易丢掉 COMPOSER_HOME 或 $PATH 设置，导致 composer install 成功但 vendor/bin/xxx 脚本跑不起来。
- Dockerfile 中避免
sudo，改用RUN chown -R www-data:www-data /var/www+USER www-data - CI 脚本里显式设置
COMPOSER_HOME=/tmp/composer，防止缓存污染或权限冲突 - 如果必须用 root 用户（比如某些旧镜像），至少把
~/.composer改成/tmp/composer并挂载为 volume，别让它落到不可写的层里
最常被跳过的一步：改完 $PATH 后忘了 source ~/.bashrc 或新开 shell，结果试了十次都以为配置无效。
