应避免使用 sudo composer install，因其会导致 vendor 目录、缓存及临时文件被 root 占有，引发后续权限错误；正确做法是用 chown 修复属主或重建 vendor，Docker 中需多阶段构建或固定非 root 用户运行。
composer install 提示 permission denied 怎么办
直接改目录权限，别急着 sudo。常见错误是把 vendor/ 或 composer.json 所在目录设成了 root 所有，比如之前用 sudo composer install 运行过一次，后续所有操作都会卡在这儿。
先确认问题根源：
- 运行 ls -ld vendor/，如果显示 owner 是 root，就对了
- 再看当前用户是否在 www-data 或 docker 等组里（尤其 Docker 环境）
修复方式（选其一）：
- sudo chown -R $USER:$USER ./vendor（仅限本地开发）
- rm -rf vendor/ && composer install（前提是没改过源码）
- 在 CI/CD 或容器里，统一用非 root 用户运行 composer，比如 Dockerfile 里加 USER 1001
为什么不能用 sudo composer install
因为 composer 本身会写缓存、生成 autoloader、调用脚本，这些行为一旦以 root 身份执行，就会污染全局状态：
-
~/.composer/cache/下的文件变成 root 所有，下次普通用户运行composer update就会失败 - 某些包的
post-install-cmd脚本可能创建日志或配置文件，结果生成在 root 权限路径下，PHP-FPM 或 Apache 就读不了 - 更隐蔽的是：有些插件（如
hirak/prestissimo）会在/tmp创建 socket，root 创建后普通用户无法重连
Linux/macOS 下 composer 权限问题的真正源头
不是 composer 本身有问题，而是它默认复用系统用户的主目录和 umask。最容易被忽略的点是：
– umask 值不对（比如 002 导致组写权限丢失），导致 vendor/ 里某些文件不可写，后续 composer dump-autoload 失败
– COMPOSER_HOME 指向了一个权限收紧的路径（如 /usr/local/share/composer），而你没意识到它被设过了
– Git clone 的子模块或软链接残留了 root 权限（尤其从别人打包的 zip 解压出来）
检查方法：
- echo $COMPOSER_HOME
- umask
- find . -user root -name "composer.*" 2>/dev/null
Docker 环境里 composer 权限错乱怎么收场
容器内用 root 跑 composer，宿主机挂载的 vendor/ 就会变成 root:root，本地 IDE 或 git diff 全部失灵。
标准解法只有两个：
- 构建阶段用多阶段 Dockerfile：build 阶段装依赖，copy 到 final 阶段时自动降权
- 运行阶段坚持用非 root 用户：RUN addgroup -g 1001 -f www && adduser -S app -u 1001，然后 USER app
- 绝对不要在 docker-compose.yml 里写 user: "root" 或留空（默认就是 root）
补救命令（宿主机执行）：sudo chown -R $(id -u):$(id -g) ./vendor
但注意：如果容器里还开着，得先 docker stop，否则文件锁会导致 chown 失败
事情说清了就结束
