composer home 输出的路径是 Composer 全局行为根目录，用于定位 config.json、auth.json、cache/ 和 vendor/；Linux/macOS 默认 ~/.composer 或 ~/.config/composer，Windows 默认 %APPDATA%\Composer，可通过 COMPOSER_HOME 环境变量覆盖。
composer home 命令本身只输出路径，不打开目录；要真正“使用”它，关键在理解它在哪、谁在读它、以及改了之后哪些东西不会自动跟着走。
composer home 输出的路径到底是谁在用？
这个路径是 Composer 全局行为的根目录，composer config --global、composer global require、composer clear-cache 全部基于它。它不是“可选配置”，而是 Composer 运行时查找 config.json、auth.json、cache/、vendor/ 的起点。
- Linux/macOS 默认是
~/.composer或~/.config/composer（取决于版本） - Windows 默认是
%APPDATA%\Composer - 只要设置了
COMPOSER_HOME环境变量，Composer 就优先用它，完全忽略默认路径 -
composer config --global home显示的值，就是当前实际生效的路径 —— 这是最可靠的验证方式
为什么改了 COMPOSER_HOME 后 global 命令突然不认了？
因为 composer global require 安装的二进制文件（如 laravel、phpunit）会放在 $COMPOSER_HOME/vendor/bin/，但系统 PATH 里通常只加了旧路径（比如 ~/.composer/vendor/bin）。PATH 没同步更新，shell 就找不到命令。
- 检查当前 PATH 是否包含新路径：
echo $PATH | grep vendor（Linux/macOS）或echo %PATH%（Windows） - 手动把新路径加进 shell 配置（如
~/.zshrc）：export PATH="$COMPOSER_HOME/vendor/bin:$PATH" - 重装一次全局包：
composer global require laravel/installer，确保二进制写入新位置 - 别依赖“旧包自动迁移”——
vendor/下的内容不会复制，必须重装
如何安全地迁移现有 composer home 到新位置？
直接改环境变量后，旧 config.json、auth.json、证书和缓存全失效。迁移不是“剪切粘贴”，而是有选择地搬运。
- 先备份旧目录：
cp -r ~/.composer ~/.composer.backup - 只复制关键配置文件：
cp ~/.composer/{config.json,auth.json,certificates/} $COMPOSER_HOME/ - 缓存可清可不清：
composer clear-cache会清理新路径下的cache/，旧缓存留着也无害 - 不要复制
vendor/：全局包重装比迁移更可靠，避免 autoload 冲突或路径硬编码问题 - 验证 auth 是否生效：
composer config --global github-oauth.github.com应返回你原来的 token
临时切换 home 目录的三种方式及适用场景
不是所有情况都需要永久改环境变量。临时指定更适合脚本、CI 或多项目隔离。
- 单次命令生效（推荐测试用）：
COMPOSER_HOME=/tmp/test-composer composer --version - 当前终端会话生效（调试用）：
export COMPOSER_HOME=/tmp/debug-composer，之后所有composer命令都走这里 - 命令行参数方式（部分旧版本支持）：
composer --home=/path/to/home global list，注意不是所有子命令都识别该参数 - Docker 中常用
ENV COMPOSER_HOME /tmp/composer，配合 volume 挂载实现缓存复用
最容易被忽略的一点：IDE 或编辑器插件（比如 PHPStorm 的 Composer 集成）可能缓存了旧 composer home 路径，改完环境变量后需要重启 IDE 或手动刷新配置。
