直接修改 COMPOSER_HOME 环境变量即可生效，无需重装或改源码，但需注意权限、缓存一致性、shell 配置持久性，并手动迁移 auth.json、cache 等数据及重装全局包。
直接改 COMPOSER_HOME 环境变量即可生效，无需重装或修改 Composer 源码。但要注意路径权限、缓存一致性与 shell 配置的持久性。
设置 COMPOSER_HOME 环境变量的正确方式
Composer 启动时会优先读取 COMPOSER_HOME，若未设置才 fallback 到默认位置（如 $HOME/.composer）。必须在 Composer 命令执行前完成设置。
- Linux/macOS：在
~/.bashrc、~/.zshrc或系统级/etc/environment中添加export COMPOSER_HOME="/path/to/your/composer-home" - Windows（CMD）：用
setx COMPOSER_HOME "D:\my-composer"（需重启终端） - Windows（PowerShell）：在
$PROFILE中添加$env:COMPOSER_HOME="D:\my-composer" - 临时测试可用
COMPOSER_HOME=/tmp/composer-test composer --version，但仅当前命令有效
改完后必须手动迁移原有数据
环境变量变更不会自动搬移旧文件。Composer 不会帮你把 ~/.composer/cache、~/.composer/auth.json、~/.composer/vendor（全局 bin）等复制过去——它只会从头开始建新目录。
- 缓存目录（
cache/）可直接rsync -av ~/.composer/cache/ $COMPOSER_HOME/cache/（Linux/macOS） -
auth.json必须手动拷贝，否则私有仓库认证失败 - 全局安装的包（如
laravel/installer）要重新运行composer global require ...，因为vendor/bin路径变了 - 检查
$COMPOSER_HOME/vendor/bin是否已加入$PATH，否则laravel等全局命令会报 “command not found”
验证是否生效及常见失效原因
运行 composer config --global home 应输出你设定的路径；更底层的验证是看 composer diagnose 输出中的 “Composer home” 行。
- 终端没重载配置？改完
.zshrc后忘了source ~/.zshrc - IDE 内置终端未继承系统环境变量（如 PHPStorm 的 Terminal 默认不读
.zshrc），需在 IDE 设置中启用 shell integration - 某些 CI 环境（如 GitHub Actions）需显式用
env:块声明COMPOSER_HOME，不能依赖用户 profile - Windows 上路径含空格或反斜杠易出错，建议用正斜杠或双引号包裹：
COMPOSER_HOME="D:/my-composer"
composer config --global home # 输出示例：/opt/composer-home
真正麻烦的不是设变量，而是 auth.json 权限、全局 bin 的 PATH 注册、以及 CI/CD 流水线里多个地方要同步改——漏一处就卡在“找不到包”或“认证失败”。
