Composer全局配置不生效是因为读取路径与修改路径不一致，常见原因包括sudo执行导致使用root配置、COMPOSER_HOME环境变量干扰或PATH未包含vendor/bin目录。
Composer global config 为什么改了不生效
直接运行 composer global config 只会修改当前用户的全局配置文件（~/.composer/config.json 或 ~/Library/Application Support/Composer/config.json），但如果你用的是 Homebrew 安装的 Composer、或通过 sudo composer 执行过命令，实际读取的可能是 root 用户的配置；更常见的是：你改的是用户级配置，但项目中启用了 COMPOSER_HOME 环境变量指向了别的路径，导致 Composer 根本没读你改的那个文件。
验证当前生效的配置位置：composer global config --list --verbose —— 注意输出里第一行的 Loaded config file: 路径。
- 如果路径是
/root/.composer/config.json，说明你最近用过sudo composer，后续所有global操作默认都走 root 配置 - 如果路径是空或指向一个不存在的目录，大概率是
COMPOSER_HOME被设成了无效值 - Windows 用户注意：
%COMPOSER_HOME%优先级高于默认路径，且大小写敏感（尤其在 Git Bash 下）
让 global config 真正永久生效的三步操作
不是改完就完事，必须确保「写入位置」和「运行时读取位置」一致：
- 先清掉干扰项：执行
unset COMPOSER_HOME（Linux/macOS）或set COMPOSER_HOME=（Windows cmd），然后新开终端再试 - 确认当前用户身份：
whoami（macOS/Linux）或echo %USERNAME%（Windows），确保没切到 root 或其他账户 - 用绝对路径明确写入：
composer global config repo.packagist composer https://packagist.phpcomposer.com（示例：换国内镜像）—— 这条命令会自动写入当前用户有效的config.json
改完立刻验证：composer global config repo.packagist，输出应为 https://packagist.phpcomposer.com（不是 https://packagist.org）。
global require 的包为什么找不到命令
composer global require laravel/installer 成功后，laravel 命令仍提示 command not found，根本原因不是配置问题，而是 PATH 没包含 Composer 的 bin 目录。
- 默认 bin 路径是：
~/.composer/vendor/bin（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows） - 必须手动加进 shell 配置：
export PATH="$HOME/.composer/vendor/bin:$PATH"（追加到~/.zshrc或~/.bashrc），然后source ~/.zshrc - Windows 用户需在「系统属性 → 环境变量」里把该路径加进用户级 PATH，重启终端才生效
- 注意：不要用
composer global config bin-dir改 bin 目录 —— 这只会改变 future install 的路径，已安装包不会自动迁移
多个 PHP 版本共存时 global config 的坑
如果你用 phpbrew、asdf 或 MAMP 切换 PHP，composer 命令本身可能绑定到某个特定 PHP 实例，而该实例的 phar 内部会缓存 vendor 路径。结果就是：which composer 显示路径正常，但 composer global list 却列出空结果。
- 检查实际执行的 PHP：
composer --version --verbose，看PHP binary:行是否是你期望的版本 - 最稳妥做法：统一用
php /path/to/composer.phar global ...显式指定 PHP 解释器 - 避免混用：不要一边用
brew install composer，一边又用php -r "readfile('https://getcomposer.org/installer');" | php安装不同版本的 phar
global 配置本身不依赖 PHP 版本，但它的生效前提是 Composer 进程能稳定定位到同一个用户配置和 vendor 目录 —— 这个前提在多 PHP 环境下最容易被忽略。
