COMPOSER_HOME 是 Composer 确定全局主目录的唯一环境变量，设则必用，不设才退至默认路径；它支配 config.json、cache/、vendor/bin/ 等全部用户级路径，且不影响项目级配置。
COMPOSER_HOME 是 Composer 找全局配置的“唯一入口”
Composer 启动时，第一件事就是确定全局主目录在哪——它只认 COMPOSER_HOME 环境变量。设了，就无条件用它；没设，才退到默认路径（$HOME/.composer 或 %USERPROFILE%\AppData\Roaming\Composer）。它不是可选配置项，而是底层定位逻辑的开关。
-
COMPOSER_HOME一设，config.json、cache/、vendor/bin/、certificates/全部跟着走，不商量 - 它不影响项目级
composer.json和vendor/，只管用户级行为 - 运行
composer config --global home输出的路径，就是 Composer 实际解析后的结果，比echo $COMPOSER_HOME更可靠（因为后者可能被 shell 缓存或未生效）
临时改 vs 永久改：什么时候该用哪一种
临时改适合调试、CI 脚本或 Docker 构建；永久改用于日常开发环境统一管理。两者不能混用，否则容易出现“明明设了却没生效”的错觉。
- 临时生效（单次命令）：
COMPOSER_HOME=/tmp/my-composer composer global require laravel/installer - 永久生效（Linux/macOS）：在
~/.zshrc里加export COMPOSER_HOME="$HOME/.my-composer"，然后source ~/.zshrc - 永久生效（Windows）：系统环境变量里新建
COMPOSER_HOME，值必须是绝对路径，如C:\Users\Alice\composer，不能写%USERPROFILE%\composer - 常见错误：路径含
~或$HOME，Composer 不展开，直接当作字面路径创建，结果报Permission denied或找不到vendor/bin
CI/CD 和 Docker 中最常踩的三个坑
在 GitHub Actions、GitLab CI 或 Docker 构建中，COMPOSER_HOME 错配会导致缓存失效、全局命令不可用、甚至安装失败——而且往往没有明显报错，只是变慢或跳过某些步骤。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 没显式声明
COMPOSER_HOME：CI 默认路径可能被清空或权限受限，导致composer global require安装的工具（如laravel/installer）无法加入$PATH - 缓存目录挂载错位：设了
COMPOSER_HOME=/tmp/composer，但没把/tmp/composer/cache挂载为持久卷，每次构建都重下包 - PATH 没同步更新：即使
COMPOSER_HOME正确，也得手动把$COMPOSER_HOME/vendor/bin加进$PATH，否则laravel命令根本找不到 - 推荐做法：CI 中统一设
COMPOSER_HOME+COMPOSER_CACHE_DIR，并确保两者指向同一挂载点下的不同子目录
验证是否真生效：别只信 echo
很多人改完就 echo $COMPOSER_HOME，看到路径对了就以为万事大吉——但 Composer 可能根本没读到这个值，或者读到了但权限不对、路径不可写。
- 第一层验证：
composer config --global home—— 这个输出才是 Composer 自己认定的路径 - 第二层验证：
composer global status—— 看列出的 vendor 目录是不是你预期的位置 - 第三层验证：手动
ls -la $COMPOSER_HOME/cache，确认有文件且可写；如果看到Failed to create cache directory: Permission denied，说明路径存在但用户无写权 - 额外提醒：某些 IDE（如 PHPStorm）会预加载 shell 环境，改完
~/.zshrc后必须重启 IDE，否则它仍用旧路径
真正麻烦的不是设不对，而是设对了但没意识到 COMPOSER_HOME 一旦生效，所有全局行为（包括插件、证书、缓存）都绑定在这个路径上——迁移旧数据、同步多机配置、排查 autoload 失效，全得从它出发。漏掉权限、路径展开、PATH 同步这三点中的任意一个，就等于白设。
