根本原因是目录属主为root而非当前用户，应使用chown修复所有权，如sudo chown -r $user:$user vendor/ composer.lock及全局缓存目录，禁用chmod -r 777和sudo composer install。
绝大多数 Composer 安装扩展包时的 Permission denied 错误，不是缺权限，而是目录“认错了主人”——vendor/、composer.lock 或 ~/.composer 被 sudo 污染过，属主是 root，而你正以普通用户运行命令。
报错里带路径的那一行就是线索
终端不会撒谎。它明确告诉你哪个路径写不进去：
-
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 问题在vendor/ -
Could not write to /path/to/composer.lock→ 问题在composer.lock -
Writing cache file ~/.composer/cache/repo/...→ 问题在$(composer config --global cache-dir)
立刻检查这三处归属：
ls -ld vendor/ composer.lock $(composer config --global cache-dir)
只要任意一行第一列显示 root（比如 drwxr-xr-x 12 root root），就坐实是所有权错位，不是 rwx 权限数字不够。
用 chown 归还所有权，别碰 chmod -R 777
chmod -R 777 是临时止痛药，会埋雷：CI 工具拒收 vendor/bin/ 下的可执行文件、Git 提交提示 ownership changed、后续 composer update 可能只失败一半。
真正该做的是把目录“还给你”：
- 修复项目内：
sudo chown -R $USER:$USER vendor/ composer.lock - 修复全局缓存：
sudo chown -R $USER:$USER $(composer config --global cache-dir) - 整个
~/.composer都被root占了？sudo chown -R $USER:$USER ~/.composer
sudo 这里只是借权跑 chown，不是让你去跑 sudo composer install——后者才是污染源头。
composer global require 找不到命令？先看 COMPOSER_HOME 和 PATH
composer global require laravel/installer 成功后输 laravel 却提示 command not found，问题不在安装，而在路径没进 $PATH，或该路径本身权限受限。
确认二进制位置：composer config -g bin-dir，默认是 ~/.composer/vendor/bin。
把它加进环境变量：
- 在
~/.zshrc或~/.bashrc末尾加：export PATH="$HOME/.composer/vendor/bin:$PATH" - 更推荐方案：
mkdir -p ~/bin && composer config -g bin-dir ~/bin && export PATH="$HOME/bin:$PATH"
别用 sudo composer global require——它会把 laravel 装进 /root/.composer/vendor/bin，普通用户根本执行不到。
Docker 或 CI 环境里权限错得更隐蔽
宿主机挂载的代码目录 UID 是 1000，但容器以 UID 0（root）启动，vendor/ 就写不进去。
关键处理点：
- Docker 中显式创建非 root 用户，并确保 UID 与宿主机一致：
RUN adduser -S phpuser -u 1000 - GitHub Actions 等 CI 中，不要在
cache: composer后直接跑composer install；加一步chown -R $USER:$USER vendor，或直接删掉重来：rm -rf vendor && composer install - 多阶段构建更干净：builder 阶段完成安装，runtime 阶段只 COPY
vendor/
嵌套权限混乱最容易被忽略——一次 sudo composer install 可能让 vendor/ 下个别子目录 owner 还是 root，chown -R 都覆盖不到。这时候删掉重来反而最省时间，前提是已确认项目根目录、composer.lock 和缓存目录都归你所有。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
