Composer install失败时应优先检查错误路径末尾的目录或文件归属，用ls -ld确认第三列属主是否为当前用户，非则用sudo chown -R $USER:$USER修复，禁用chmod -R 777。
报错路径就是排查入口
Composer install失败时，终端输出的错误行里一定带完整路径，比如file_put_contents(/home/user/project/vendor/autoload.php): Permission denied，或Could not write to /home/user/project/composer.lock。这行不是提示信息，是定位线索——问题就出在路径末尾那个目录或文件上。
别猜是vendor、cache还是lock，直接用ls -ld查归属：
-
ls -ld vendor/→ 看属主是不是当前用户（第三列） ls -ld composer.lockls -ld $(composer config --global cache-dir)
只要任意一行第三列不是$(whoami)，就是所有权错配。注意：第一列drwxr-xr-x是权限位，不关键；第三列才是“谁 owns 这个东西”。
chown 是解药，chmod -R 777 是毒药
根本原因不是“没写权限”，而是“这目录归 root 管”。修复动作必须是chown -R $USER:$USER，不是改权限数字。
常见误操作：sudo chmod -R 777 vendor/。它会让 CI 拒收vendor/bin/phpunit、Git 提示ownership changed、后续composer dump-autoload静默失败。
正确做法分场景：
- 项目内目录（如
vendor/、composer.lock）：sudo chown -R $USER:$USER vendor/ composer.lock（注意末尾斜杠，避免漏掉子目录） - 全局缓存目录：
sudo chown -R $USER:$USER $(composer config --global cache-dir) - 整个
~/.composer被污染：sudo chown -R $USER:$USER ~/.composer，再补一句chmod -R u+rw ~/.composer防 umask 导致子目录不可写
PATH 和 bin-dir 不匹配导致命令找不到
装成功但输laravel提示command not found，大概率是~/.composer/vendor/bin没进$PATH，或者该路径本身权限受限。
先确认 bin 目录位置：composer config -g bin-dir（默认是~/.composer/vendor/bin）
再检查它是否可执行：
-
ls -ld $(composer config -g bin-dir)→ 属主必须是你，且至少有r-x权限 -
echo $PATH→ 确保输出里包含该路径
修复方式二选一：
- 加进 shell 配置：
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 改用用户级 bin 目录：
mkdir -p ~/bin && composer config -g bin-dir ~/bin && echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Docker / CI / Windows 下的隐性坑
这些环境往往不报明显错误，但composer global require会卡住或静默失败。
Linux/macOS 容器中常见 UID 不匹配：宿主机 UID 是 1000，容器却以 UID 0（root）运行，挂载进来的vendor/目录属主是 root，普通用户进程写不进去。
Windows 下重点看 ACL 权限：%APPDATA%\Roaming\Composer\Cache路径报Access is denied，说明当前 PHP 用户（如IIS_IUSRS或你的登录账户）没被授予“完全控制”。
解决方式：
- 图形界面：右键该文件夹 → “属性” → “安全” → “编辑…” → “添加…” → 输入当前用户名或
Users组 → 勾选“完全控制” - 管理员 PowerShell：
icacls "$env:APPDATA\Roaming\Composer\Cache" /grant "$env:USERNAME:(OI)(CI)F" /t - 规避默认路径：
composer config -g cache-dir "%USERPROFILE%\composer-cache"，再手动创建
真正麻烦的从来不是报错本身，而是错误路径里藏着的归属链——一个vendor/目录可能嵌套着 root-owned 的子目录，chown -R后仍要ls -la vendor/ | head -5再扫一眼，否则下次dump-autoload又会卡在某个看不见的vendor/package/src/里。
