直接设置COMPOSER_HOME环境变量即可自定义Composer主目录。适用于多用户隔离、节省系统盘空间、容器/CI固定路径及避免权限问题等场景，需手动迁移旧数据并验证生效。
直接设置 COMPOSER_HOME 环境变量即可让 Composer 使用自定义主目录，比如把全局配置、缓存和全局安装的包都存到指定位置。
为什么需要改 COMPOSER_HOME
默认情况下，Composer 把配置文件（auth.json、config.json）、插件、全局二进制文件和缓存都放在用户主目录下的 .composer/（Linux/macOS）或 AppData/Roaming/Composer（Windows）里。改这个变量适合以下情况：
- 多用户共用一台机器，想隔离各自的 Composer 配置
- 系统盘空间紧张，想把缓存挪到大容量磁盘
- 开发环境容器化或 CI 中需固定路径，方便挂载或复现
- 避免权限问题（比如在 root 下运行时写入用户目录失败）
设置方法（按系统）
设置后记得重启终端或重新加载 shell 配置，让新变量生效。
-
Linux / macOS（bash/zsh）：在
~/.bashrc或~/.zshrc末尾加一行export COMPOSER_HOME="/path/to/my-composer-home" -
Windows（命令提示符）：
setx COMPOSER_HOME "D:\my-composer"（重启 CMD 生效） -
Windows（PowerShell）：
[System.Environment]::SetEnvironmentVariable('COMPOSER_HOME', 'D:\my-composer', 'User')（当前用户级，重启 PowerShell 生效） -
临时测试（所有系统）：
COMPOSER_HOME=/tmp/composer-test composer --version（仅本次命令生效）
验证是否生效
执行下面命令，看输出路径是否变成你设的目录：
-
composer config --list | grep home（会显示home配置项，值应为你的路径） -
echo $COMPOSER_HOME（Linux/macOS）或echo %COMPOSER_HOME%（Windows） - 运行
composer global list，新装的全局包会出现在你指定的vendor/bin/下
注意事项
改完别忘了手动迁移旧数据（可选但推荐），否则会丢失认证信息、插件和已安装的全局包：
- 原
auth.json和config.json复制到新COMPOSER_HOME目录下 - 原
vendor/下的全局包不会自动迁移，需重新运行composer global require xxx - 如果只改缓存目录（不改整个 home），可用
composer config --global cache-dir /path/to/cache单独设置 - 某些共享主机或老旧脚本可能硬编码了
.composer路径，改了之后可能报错，注意兼容性
基本上就这些。改完变量，Composer 后续所有操作都会基于新路径，不需要额外配置其他东西。
