Composer报权限错误根本原因不是自身故障，而是操作系统阻止写入，关键看错误末尾路径：vendor/属root则删vendor和composer.lock后重装；~/.composer/cache属root则改归属或换路径；WSL下/mnt/c/不支持Linux权限，应移至原生路径。
Composer 报 mkdir(): Permission denied 或 file_put_contents(): failed to open stream: Permission denied，基本不是 Composer 本身坏了，而是它在某个路径上被操作系统拦住了——关键看错误末尾那个具体路径，然后查归属、不瞎 chmod。
报错末尾路径是 vendor/ 怎么办
90% 的本地开发权限问题出在这里，典型表现是运行 composer install 卡在创建 vendor/autoload.php 或写入 vendor/composer/installed.json。
- 先确认归属：
ls -ld vendor/，如果输出里第三、四字段是root root，说明之前误用了sudo composer install - 别直接
sudo chown -R $USER:$USER vendor/—— vendor 下可能有 Phar 包或符号链接，递归改属主会破坏结构 - 安全做法：删掉整个
vendor/和composer.lock，再用当前用户重装：rm -rf vendor composer.lock && composer install - 若
composer.lock不能删（如 CI 部署），至少确保目录本身可写：chown $USER:$USER vendor && chmod u+w vendor
~/.composer/cache 被 root 占了怎么清
这个目录一旦属主是 root，所有 composer install、composer update、composer global require 都会在「写缓存」阶段静默失败，错误不明显但必卡住。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查路径：
composer config --global cache-dir，再ls -ld $(composer config --global cache-dir) - 如果 owner 不是当前用户，执行：
sudo chown -R $USER:$USER $(composer config --global cache-dir) - 更推荐换路径：新建干净目录
mkdir -p ~/composer-cache，再composer config --global cache-dir ~/composer-cache - 改完立刻验证：
composer clear-cache，不再报错才算生效
全局 bin 命令找不到（如 laravel）的权限链问题
composer global require laravel/installer 成功，但输 laravel 提示 command not found，常因两处断开：bin 目录不可写 + PATH 没包含。
- 查 bin 目录在哪：
composer config -g bin-dir（默认是~/.composer/vendor/bin） - 检查该路径归属：
ls -ld $(composer config -g bin-dir)，若属主非你，执行：sudo chown -R $USER:$USER $(composer config -g bin-dir) - 确保已加入
$PATH：在~/.zshrc或~/.bashrc加export PATH="$HOME/.composer/vendor/bin:$PATH"，再source ~/.zshrc - 更稳妥做法：把 bin-dir 改到完全可控路径，如
mkdir -p ~/bin && composer config -g bin-dir ~/bin && export PATH="$HOME/bin:$PATH"
WSL 或 Docker 里 /mnt/c/ 或挂载卷报错怎么办
这类环境权限问题根子不在 Linux 权限模型，而在文件系统不支持 uid/gid 映射——chmod 和 chown 在 /mnt/c/ 下根本无效。
- WSL：把项目移到 WSL 原生路径（如
~/projects/myapp），再运行composer install - Docker：避免在宿主机对 bind mount 目录执行
composer install；应在Dockerfile里RUN composer install - 若必须宿主机操作，确认 WSL 的
/etc/wsl.conf启用了metadata=true，否则权限控制失效 - CI/CD（如 GitHub Actions）中，缓存解压后可能继承错误权限，加一步
chown -R $USER:$USER vendor或直接删 vendor 重装
真正麻烦的从来不是报错本身，而是权限问题常跨层存在——表面在 vendor/，根子可能在缓存路径、Docker UID 映射，甚至 WSL 的挂载配置。每次遇到，先盯住错误信息末尾那个完整路径，ls -ld 一眼看清归属，比盲目 chmod 777 管用得多。
