根本原因是 ~/.composer 目录或其子目录属主为 root，应先用 ls -ld $(composer config --global home) 确认归属，再执行 sudo chown -r $user:$user ~/.composer 修复所有权，并 chmod -r u+rw ~/.composer 加固可写性，禁用 chmod -r 777。
根本不是权限位不够，而是 ~/.composer 目录或其子目录被 root 占了——查归属，修归属，别碰 chmod。
看报错路径，立刻定位是哪个目录在拦你
错误里带的路径就是线索，比如：Writing cache file ~/.composer/cache/repo/https---packagist.org/ 失败，问题就在 ~/.composer/cache/；Could not write to /root/.composer/auth.json 则说明 COMPOSER_HOME 被错误指向了 /root/.composer。
- 执行
composer config --global home看当前全局配置根目录是哪 - 执行
ls -ld $(composer config --global home)检查该目录属主是不是$(whoami) - 如果输出第一列含
root root，就确认污染了
修复 ~/.composer 所有权，三步到位
chown 是解药，chmod -R 777 是毒药——后者会让 CI 拒收 bin 文件、Git 报 ownership changed、后续 composer global require 静默失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先归还控制权：
sudo chown -R $USER:$USER ~/.composer - 再加固可写性（防 umask 导致子目录无写）：
chmod -R u+rw ~/.composer - 验证是否生效：
ls -la ~/.composer | head -3应全为当前用户名，且cache/、vendor/bin/可写
global require 命令找不到？PATH 和 bin-dir 得对上
装成功但输 laravel 提示 command not found，大概率是 ~/.composer/vendor/bin 没进 $PATH，或者该路径本身权限受限。
- 确认 bin 目录位置：
composer config -g bin-dir（默认是~/.composer/vendor/bin） - 把它加进环境变量：在
~/.zshrc或~/.bashrc末尾加export PATH="$HOME/.composer/vendor/bin:$PATH"，然后source ~/.zshrc - 更稳妥方案：改用用户级 bin 目录避开权限纠缠：
mkdir -p ~/bin && composer config -g bin-dir ~/bin && export PATH="$HOME/bin:$PATH"
Docker / CI / Windows 下的隐性坑
这些环境不报错在明面，但一样卡住 composer global require：
- Docker 中容器 UID 是 0（root），宿主机挂载卷后文件属主变成 root → 启动时加
user:1000，或修复时用数字 UID：sudo chown -R 1000:1000 ~/.composer - CI 流水线（如 GitHub Actions）默认非 root 用户 → 开头加
mkdir -p .composer-cache && chmod 700 .composer-cache，再设COMPOSER_CACHE_DIR="$PWD/.composer-cache" - Windows 上报
Access is denied且错误出现在生成.bat文件时 → 杀软（如 Windows Defender）大概率拦截，临时禁用实时防护，或改用 Git Bash 运行
最容易被忽略的是嵌套污染：一次 sudo composer global require 可能让 ~/.composer/vendor/bin/ 下混进个别 root 所有文件，ls -la ~/.composer/vendor/bin 才能发现；这种情况下 chown -R 仍有效，但如果已破坏 auth.json 或插件结构，删掉整个 ~/.composer 重来反而更快。
