composer_home路径错配导致全局配置失效，因composer严格按该变量路径读config.json；若路径错误、含~或$home、权限不匹配，将静默跳过配置，需用composer config --global home验证并确保与实际$home/.composer一致。
COMPOSER_HOME 路径错配导致全局配置失效
Composer 读取全局配置时，会严格按 COMPOSER_HOME 环境变量指向的路径去找 config.json。一旦该变量被错误设置（比如指向了不存在的路径、含 ~ 或 $HOME），它就静默跳过整个配置——composer config -g repo.packagist 输出为空，不是没配，是根本没读到。
验证方式很简单：composer config --global home 输出的路径，必须和当前用户实际能访问的 $HOME/.composer（Linux/macOS）或 %APPDATA%\Composer（Windows）一致。不一致就说明 COMPOSER_HOME 被覆盖了。
常见踩坑点：
-
COMPOSER_HOME必须是绝对路径，~/composer或%USERPROFILE%\Composer都无效 - Docker/CI 中用
sudo配置，但 PHP 进程以www-data运行，结果读的是/var/www/.composer - 宝塔面板里 PHP 执行脚本未显式
export COMPOSER_HOME=/home/www/.composer，默认仍走/root/.composer
手动改 ~/.composer/config.json 导致 JSON 格式错误
直接编辑 ~/.composer/config.json 是高危操作。一个未闭合的引号、多写的逗号、或路径里漏转义的反斜杠，都会让 Composer 完全忽略该文件——不报错、不提示、composer config -g 也查不到你刚加的镜像。
唯一安全写法是：composer config --global cache-dir /path/to/cache。它自动处理 JSON 序列化、路径转义、字段合并，且不影响其他配置项。
注意：
- 路径必须是绝对路径，
~/composer-cache不会被解析，得写成/home/alex/composer-cache - 目录需提前创建，且当前用户有读写权限，否则后续
composer install报failed to open stream - 别碰
~/.composer/auth.json—— 它不走config --global命令，改错会导致私有包认证失败
PATH 没包含 vendor/bin 导致全局命令找不到
composer global require laravel/installer 成功后，laravel 命令仍报 command not found，问题不在 Composer，而在 shell 找不到可执行文件位置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真实路径由 composer global config bin-dir --absolute 决定，通常是 ~/.composer/vendor/bin（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows）。这个路径必须显式加入系统 PATH，Composer 不会自动帮你加。
操作要点：
- Linux/macOS：在
~/.zshrc或~/.bashrc末尾加export PATH="$HOME/.composer/vendor/bin:$PATH"，然后source ~/.zshrc - Windows：把
%APPDATA%\Composer\vendor\bin加进「系统环境变量」→ Path → 新建，不是「用户变量」 - 改完必须新开终端，旧终端不会重载
PATH
缓存/源目录归属错误引发“路径不存在”假象
报错里出现 file_put_contents(/xxx/vendor/autoload.php): Failed to open stream: No such file or directory，大概率不是路径真丢了，而是当前用户对 /xxx/vendor/ 或 ~/.composer/cache 没有所有权。
典型场景：一次 sudo composer install 让整个 vendor/ 归属变成 root，后续普通用户运行就失败。PHP 的 fopen() 在 Unix 权限模型下，只认属主，不认 chmod 777。
修复步骤：
- 先定位问题路径：
ls -ld vendor/、ls -ld $(composer config --global cache-dir) - 只要第三列显示
root，就执行：sudo chown -R $USER:$USER vendor/和sudo chown -R $USER:$USER $(composer config --global cache-dir) - 禁用
chmod -R 777—— 它会让 CI 工具拒收vendor/bin/下的可执行文件
嵌套权限混乱最难排查：ls -la vendor/ 可能发现个别子目录属 root，这时候别硬修，直接 rm -rf vendor/ 更稳妥。
