根本原因是目录属主为root而非当前用户，需根据报错路径定位vendor/、composer.lock或~/.composer/cache等具体目录，用ls -ld确认归属，再通过删除重装或chown修复所有权。
不是项目“不可写”，而是 Composer 正在往一个它没权限的路径里写东西——vendor/、composer.lock 或 ~/.composer/cache 三者之一被 root 占了，或者 WSL/Windows 权限模型不兼容。直接删重装比硬 chmod 更快更安全。
vendor/ 目录报 Permission denied 怎么修
错误信息末尾出现 vendor/autoload.php、vendor/composer/installed.json 或 mkdir(): Permission denied in /path/to/project/vendor，基本锁死问题就在 vendor/。
- 先运行
ls -ld vendor/：如果输出第三列是root（例如drwxr-xr-x 3 root root），说明它被sudo composer install创建过 - 别用
sudo chown -R $USER:$USER vendor/：里面可能有软链接（比如指向~/.composer/vendor/bin的符号链接），硬改会破坏结构 - 安全做法是清空重来：
rm -rf vendor composer.lock && composer install - 顺手检查项目根目录：
ls -ld .，确保当前用户对.有rwx；若没有，临时补一句chmod u+rwx .
全局缓存目录（~/.composer/cache）被 root 占了
错误里含 Writing cache file ~/.composer/cache/repo/https---packagist.org 或执行 composer clear-cache 报 Access is denied，就是它。
- 查当前路径：
composer config --global cache-dir - 查归属：
ls -ld $(composer config --global cache-dir)，若 owner 不是当前用户，就是根源 - 推荐改路径而非硬修归属：
composer config --global cache-dir ~/.cache/composer - 再建目录并设权：
mkdir -p ~/.cache/composer && chown $USER:$USER ~/.cache/composer - 最后验证：
composer clear-cache不再报错才算生效
WSL 下 /mnt/c/ 路径执行失败，chmod 无效
在 /mnt/c/（即 Windows 分区）下跑 composer install，无论怎么 chmod 或 chown 都没用——NTFS 不支持 Linux uid/gid 模型，mkdir() 内部校验直接失败。
- 确认
/etc/wsl.conf中启用了metadata=true（否则所有权限命令全失效） - 临时绕过不推荐：改用 Docker 或把项目移到 WSL 原生路径（如
~/projects/） - 根本解法是避免跨系统挂载执行 Composer：Dockerfile 里
RUN composer install，而不是宿主机 bind mount 后运行
镜像源配置后仍慢或失败，别只盯 config
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 成功，但 composer update 还卡住，往往不是镜像没生效，而是缓存或 DNS 层出了问题。
- 先清缓存：
composer clear-cache，尤其当~/.composer/cache/归属异常时，缓存写不进去会导致静默降级回官方源 - 加
--verbose看真实请求地址：composer update --verbose | grep "GET http"，确认是否真走镜像域名 - 某些企业环境会拦截 HTTPS 请求或劫持 DNS，可临时试
curl -I https://mirrors.aliyun.com/composer/packages.json看是否返回 200 - 插件干扰常被忽略：加
--no-plugins --no-interaction测试，若成功，再逐个composer global remove排查
最易被忽略的是：报错路径未必是你以为要修的地方。Permission denied 往往是上游某个临时目录（比如 opcache 写缓存失败、插件初始化尝试访问 /etc/composer/）引发的连锁反应，得顺着错误末尾那行路径一层层查归属，而不是凭经验瞎 chmod。
