COMPOSER_HOME环境变量需正确设置并生效才能控制Composer全局路径；常见失效原因包括未source配置文件、IDE终端不加载shell配置、Windows与Git Bash环境变量隔离及旧数据未迁移；必须复制config.json，vendor/bin/cache可重装或清空。
COMPOSER_HOME 环境变量是控制 Composer 全局配置、缓存、全局包安装路径的核心开关。改它，不是为了“教程感”，而是当你遇到权限问题、磁盘空间不足、或想统一管理多项目环境时，必须动的地方。
为什么改 COMPOSER_HOME 会失效？常见原因
直接改环境变量但没生效，大概率是以下几点之一：
- Shell 配置文件（如
~/.bashrc、~/.zshrc）里写了export COMPOSER_HOME=...，但没执行source ~/.zshrc或新开终端 - 在 Windows 上用了系统级环境变量，却用 Git Bash 启动 —— 它不读 Windows 系统变量，得在 Bash 里单独设
- 某些 IDE（如 PHPStorm）启动终端时不加载 shell 配置，需在 IDE 设置里勾选“启动 shell”或手动注入变量
- 已存在
~/.composer/目录且 Composer 已初始化过，改完变量后不会自动迁移旧数据，composer global list仍可能报错或显示空
Linux/macOS 下正确设置 COMPOSER_HOME
推荐写入 shell 配置，确保所有终端和子进程继承：
echo 'export COMPOSER_HOME="$HOME/.my-composer"' >> ~/.zshrc source ~/.zshrc
验证是否生效：
echo $COMPOSER_HOME composer config --global home
注意：composer config --global home 显示的是 Composer 内部读取的值，它依赖环境变量，不是独立配置项。如果这里没变，说明环境变量根本没被读到。
Windows（PowerShell + Git Bash 双场景）
PowerShell（管理员或用户级都行）：
[Environment]::SetEnvironmentVariable('COMPOSER_HOME', "$env:USERPROFILE\composer", "User")
Git Bash 必须单独处理（它不继承 Windows 环境变量）：
echo 'export COMPOSER_HOME="$HOME/composer"' >> ~/.bash_profile source ~/.bash_profile
关键点：Windows 路径中不能含空格或中文，否则 composer global require 会卡在“Installing dependencies”不动；$HOME 在 Git Bash 中默认指向 /c/Users/xxx，别硬写 C:\Users\xxx。
改完之后要手动迁移旧数据吗？
要，但只迁必要项：
-
config.json（全局配置）必须复制过去，否则composer global require可能忽略镜像源或认证信息 -
vendor/和bin/是全局包安装结果，可删掉重装：composer global update -
cache/可删，Composer 会重建；若磁盘紧张，直接清空更省事
迁移命令示例（假设旧路径是 ~/.composer，新路径是 ~/.my-composer）：
mkdir -p ~/.my-composer cp ~/.composer/config.json ~/.my-composer/ rm -rf ~/.my-composer/vendor ~/.my-composer/bin ~/.my-composer/cache composer global update
最易忽略的是 config.json 没复制 —— 表现为全局包能装上，但 composer 命令找不到你刚 require 的二进制，因为 bin-dir 配置还锁在旧路径里。
