COMPOSER_HOME环境变量唯一决定全局插件安装路径，设则使用、不设则回退默认路径（Linux/macOS为~/.composer，Windows为%APPDATA%\Roaming\Composer）；它非可选配置，而是Composer启动时优先读取的权威路径，直接影响auth.json、config.json、缓存及vendor/bin下的全局命令。
COMPOSER_HOME 决定全局插件装在哪，不设就默认用 ~/.composer
Composer 全局插件（如 hirak/prestissimo 或 composer/composer-require-checker）安装路径完全由 COMPOSER_HOME 环境变量控制。它不是“可选配置”，而是 Composer 启动时第一件事：读这个变量，有就用，没有才 fallback 到 ~/.composer（Linux/macOS）或 %APPDATA%\Roaming\Composer（Windows）。
常见踩坑点：
- 改了
COMPOSER_HOME但没重启终端，composer global require仍写进旧目录 - 在 CI 脚本里漏传该变量，导致全局插件装错位置、后续命令找不到
- 设了相对路径（如
./my-composer），Linux/macOS 下可能解析失败，Windows 更不稳定 - 新目录建了但没手动复制
auth.json，私库认证静默失败，报401 Unauthorized却不提示原因
验证是否生效：运行 composer global config home，输出必须是你设的路径；再执行 ls $COMPOSER_HOME/vendor/bin（Linux/macOS）或 dir %COMPOSER_HOME%\vendor\bin（Windows），确认插件二进制文件真在那里。
COMPOSER_VENDOR_DIR 对全局安装完全无效，别白费劲
COMPOSER_VENDOR_DIR 只影响 composer install 在项目内安装依赖时的 vendor 目录位置，对 composer global require 零作用。它不会改变全局插件的存放路径，也不会让 global 命令去读你指定的 vendor 文件夹。
为什么有人误试这个变量？因为看到文档说“能改 vendor 位置”，但没注意上下文限定在“当前项目”。实际后果：
- 设了
COMPOSER_VENDOR_DIR后跑composer global require，变量被忽略，一切照旧 - 若同时用了 symlink 指向别处，反而可能破坏
vendor/autoload.php中硬编码的相对路径，导致全局命令运行时报Class not found - CI 流水线里加了这个变量却没效果，排查时间全耗在错误方向上
镜像配置不走项目级 config.json，必须用 -g 显式写入全局
你在项目里配了阿里云镜像：composer config repo.packagist composer https://mirrors.aliyun.com/composer/，这不影响 global require。它只读 ~/.composer/config.json（或 $COMPOSER_HOME/config.json），不认项目下的配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正起效的操作是：
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意中间的composertype参数不能少） - 必须加
composer clear-cache，否则旧的packages.json还在本地缓存里，根本不会发网络请求 - 用
composer global require monolog/monolog -vvv 2>&1 | grep "packages.json"实测，看到下载地址是镜像 URL 才算落地
失效典型场景：
- 用
sudo composer config -g，结果写进了/root/.composer/config.json，但普通用户运行global require读的是自己的家目录 -
php.ini里禁用了putenv()，config -g命令静默失败，config -g repo.packagist还显示旧值，以为成功了
PATH 和 bin-dir 不匹配，装了等于没装
全局插件装成功 ≠ 命令可用。composer global require 把包放进 $COMPOSER_HOME/vendor/，但可执行文件（如 php-cs-fixer）生成在 $COMPOSER_HOME/vendor/bin/。这个目录必须手动加进系统 PATH，否则敲命令就是 command not found。
关键动作：
- 先查真实路径：
composer global config bin-dir --absolute，别猜~/.composer/vendor/bin——Composer 2.4+ 默认用~/.config/composer/vendor/bin - Linux/macOS：把输出路径加进
~/.zshrc（不是临时export），然后source ~/.zshrc - Windows：图形界面里加进「用户环境变量」的
Path，不是系统变量；VS Code 必须完全退出重开 - 权限检查：Linux/macOS 下
ls -l $COMPOSER_HOME/vendor/bin/确认文件有x位，没有就chmod +x
最容易被忽略的是：改了 COMPOSER_HOME 后，旧的 PATH 项还在，新旧 bin 目录并存，命令可能调到旧版本甚至冲突二进制文件。
