先确认执行用户与项目目录归属一致，再修复vendor和缓存目录权限。1. 用whoami查看当前用户；2. 用ls -la检查vendor和~/.composer/cache归属；3. 若不符，用sudo chown -R $USER:www-data vendor/修改vendor权限；4. 用chmod -R 755 vendor/设读写权限；5. 检查composer缓存路径并用chown重置~/.composer归属；6. 必要时clear-cache清空缓存；7. 避免root运行Composer，统一用普通用户操作。
在使用 Composer 安装 PHP 依赖时，经常会遇到因 缓存目录 或 vendor 目录 权限不足导致的安装失败问题。这类错误通常表现为“Permission denied”、“Cannot create cache directory”或写入 vendor 失败等提示。下面教你如何快速定位并修复这些权限问题。
确认当前运行用户和项目归属
权限问题的核心是文件或目录的所有者与执行命令的用户不一致。先确认以下两点：
- 你在终端中使用的系统用户是谁（可通过 whoami 查看）
- 项目目录及其子目录（尤其是 vendor 和 ~/.composer/cache）归谁所有
运行以下命令查看目录权限：
ls -la /path/to/your/project/vendorls -la ~/.composer/cache
修复 vendor 目录权限
如果 vendor 目录已存在但无法写入，说明当前用户无权操作。可以更改其归属或权限：
- 修改 vendor 所属用户（假设你的用户名是 www-data）：
sudo chown -R $USER:www-data vendor/ - 设置合适的读写权限：
chmod -R 755 vendor/ - 若目录不存在，确保父目录可写，以便 Composer 自动创建
修复 Composer 缓存目录权限
Composer 默认将缓存写入用户主目录下的 .composer/cache。如果该目录权限异常，会导致全局操作失败。
- 检查缓存路径：
composer config --global cache-dir - 修复归属关系：
sudo chown -R $USER:$USER ~/.composer - 重置缓存权限：
chmod -R 775 ~/.composer/cache - 必要时清空缓存尝试重建：
composer clear-cache
避免在 root 下运行 Composer
用 root 用户执行 composer install 会生成 root 拥有的文件，后续普通用户无法修改，极易引发权限问题。
- 始终使用项目所属的普通用户运行 Composer 命令
- 不要随意加 sudo，除非你明确知道在做什么
- 如果必须用 sudo，指定用户环境：
sudo -u www-data composer install
基本上就这些。只要确保当前操作用户对 vendor 和 ~/.composer/cache 有读写权限，大多数 Composer 权限问题都能解决。关键是统一用户环境，避免混用 root 和普通用户操作项目文件。
