解决 Composer 安装失败需确保当前用户对项目目录及缓存路径有读写权限，先修正 vendor、composer.json 权限：chmod -R u+rw vendor/ composer.lock composer.json，再处理缓存目录：sudo chown -R $(whoami) ~/.cache/composer，避免使用 sudo 执行 Composer，应通过 chown 确保用户拥有项目目录权限，在共享环境中可设置全局缓存路径或置于用户可控目录。
当使用 Composer 安装或更新 PHP 包时，如果遇到因文件权限不足导致的安装失败，通常表现为无法写入 vendor 目录、缓存目录或 composer.json 所在路径。这类问题在 Linux 或 macOS 系统中尤为常见，特别是在共享主机或多用户环境中。
检查并修正项目目录权限
确保当前用户对项目根目录及其子目录有读写权限。进入项目目录后运行以下命令：
chmod -R u+rw vendor/ composer.lock composer.json如果没有 vendor 目录，先确保父目录可写：
chmod -R u+rw .注意：避免给其他用户（other）写权限，防止安全风险。
检查 Composer 缓存目录权限
Composer 默认将包缓存到用户主目录下的 ~/.composer（旧版本）或 ~/.cache/composer（新版本）。如果该目录权限受限，也会导致安装失败。
查看缓存路径：
composer config cache-dir然后确保当前用户拥有该目录的读写权限：
sudo chown -R $(whoami) ~/.cache/composer
或针对旧路径：
sudo chown -R $(whoami) ~/.composer避免使用 sudo 执行 Composer
不要用 sudo composer install 来绕过权限问题，这会导致生成的文件归属为 root 用户，后续操作会更麻烦。
正确做法是调整目录所有权，让当前用户拥有项目目录：
sudo chown -R $(whoami) /path/to/your/project在共享环境中的处理建议
如果你在共享主机或开发服务器上工作，可能无法修改某些目录的所有权。此时可以：
- 通过 composer config --global cache-dir 设置用户级缓存目录
- 将项目放在用户有完全控制权的路径下，如 ~/projects/
- 联系系统管理员确认权限策略
基本上就这些。只要确保当前用户对项目目录和 Composer 缓存路径有读写权限，大多数因权限引起的安装失败都能解决。关键是别用 sudo 强行执行，而是理清权限归属。
