详解Composer环境变量如何影响插件的全局安装-composer-PHP中文网

composer_home环境变量唯一决定全局插件安装路径，设则使用、不设则回退默认路径（linux/macos为~/.composer，windows为%appdata%\roaming\composer）；它非可选配置，而是composer启动时优先读取的权威路径，直接影响auth.json、config.json、缓存及vendor/bin下的全局命令。

详解composer环境变量如何影响插件的全局安装

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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 目录并存，命令可能调到旧版本甚至冲突二进制文件。