Composer global config全局设置 永久生效配置方法【基础】

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%AppDataRoamingComposervendorbin（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 环境下最容易被忽略。