根本原因是当前用户对目标目录无写入权限，常见于sudo安装导致vendor属主为root；应避免sudo，改用chown修复属主或移至家目录开发。
composer install 时提示 Permission denied 怎么办
根本原因不是 Composer 本身权限不够，而是它试图往当前用户没写入权限的目录（比如 /var/www/html/vendor）里写文件。常见于用 sudo composer install 初始化后，普通用户再运行就卡住——因为 vendor 目录属主变成了 root。
- 别用
sudo composer install，除非你明确知道后续所有操作都用 root 执行 - 修复已有权限：先确认当前用户是谁（
whoami），再执行sudo chown -R $USER:$USER vendor/（注意末尾斜杠） - 如果项目在系统级路径（如
/var/www），建议把整个项目移到用户家目录下开发，避免反复提权 - 某些共享主机或容器环境不支持改属主，此时应改用
COMPOSER_VENDOR_DIR指向用户有权限的路径，例如：COMPOSER_VENDOR_DIR="$HOME/myproject/vendor" composer install
为什么 composer create-project 生成的目录权限不对
这个命令默认会复制包里的文件结构，但不会保留原始文件的权限位；更关键的是，它依赖 git clone 或 tar 解压行为——而这些工具在不同系统上对执行位、组写权限的处理不一致。结果就是：有些 bin/ 下脚本没执行权限，或者 cache 目录无法被 PHP 进程写入。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 检查关键目录是否可写：
ls -ld vendor/ var/cache/（Laravel）、ls -ld vendor/（纯库项目） - 补权限最稳妥方式是：先删掉
vendor/和composer.lock，再用当前用户重装：rm -rf vendor composer.lock && composer install - 若必须保留 lock 文件且要跳过安装，可用
composer install --no-scripts避免触发需要权限的 post-install 脚本 - 不要手动
chmod 777 vendor/——这会让安全扫描直接报红，且掩盖了真正的属主问题
CI/CD 流水线里 composer install 权限失败怎么绕过
GitHub Actions、GitLab CI 默认以非 root 用户运行，但有些基础镜像（比如旧版 php:alpine）里 /tmp 或 ~/.composer 缓存目录权限混乱，导致 composer 自身缓存写入失败，进而影响依赖下载。
- 显式设置缓存路径到工作目录内：
COMPOSER_CACHE_DIR="$(pwd)/.composer-cache" composer install - 在
.gitlab-ci.yml或workflow中提前创建并授权：mkdir -p .composer-cache && chmod 700 .composer-cache - 禁用插件和脚本可大幅降低权限需求：
composer install --no-plugins --no-scripts --no-autoloader - Alpine 系统要注意：musl libc 下
phar解包有时会静默失败，加-v参数看是否卡在Extracting archive步骤
composer dump-autoload 报错 file_put_contents: Permission denied
这不是 autoload 文件生成失败，而是它试图写入的 vendor/composer/autoload_*.php 所在目录不可写。典型发生在部署后手动执行该命令，但 vendor/ 是只读挂载，或由另一用户生成（比如用 deploy 用户部署，再用 www-data 执行）。
- 确认
vendor/composer/是否可写：touch vendor/composer/test && rm vendor/composer/test - 如果是生产环境，应该在构建阶段就跑完
dump-autoload，上线后只读部署，不现场生成 - 临时调试可用
strace -e trace=file composer dump-autoload 2>&1 | grep EACCES定位具体哪个路径被拒 - 某些 IDE（如 PhpStorm）会在后台自动触发 autoload 重建，如果它用的不是你的当前用户，也会引发权限冲突——关掉 IDE 的 composer auto-sync 更省心
