Composer全局config.json默认路径：Linux/macOS为~/.composer/config.json，但2.2+版本优先读取~/.config/composer/config.json；Windows为%APPDATA%\Composer\config.json，须用composer config --global home命令确认真实路径。
Linux/macOS 的全局 config.json 在哪
默认情况下，全局配置文件躺在 ~/.composer/config.json 这个路径里。具体来说，Linux上是 /home/用户名/.composer/config.json，macOS则是 /Users/用户名/.composer/config.json。不过，这里有个关键细节：如果你用的是 Composer 2.2 或更新版本，它会优先尝试读取 ~/.config/composer/config.json。只要这个路径存在且可读，它就会成为新宠；否则，Composer 才会回退到那个经典的 ~/.composer/config.json。
所以，别费劲去猜了，最稳妥的办法是直接运行一条命令：composer config --global --list
输出结果的第一行，那个 home 值指向的目录，就是当前真正生效的配置根目录，config.json 文件就在它下面。
- 如果
home指向的是~/.config/composer，那你的配置文件自然就在那里。 - 即使旧的
~/.composer目录早已存在并且有配置，Composer 通常也会继续沿用，不会自动帮你迁移。 - 这里有个常见的误解：手动创建一个
~/.config/composer/config.json并不会自动覆盖旧配置。这两个路径是相互独立的，只有home指向的那个，才是真正说了算的。
Windows 的全局 config.json 路径怎么确认
在 Windows 系统上，标准路径是 %APPDATA%\Composer\config.json。展开后，通常是 C:\Users\用户名\AppData\Roaming\Composer\config.json。但问题来了：在 PowerShell 里，%APPDATA% 这个环境变量不会自动展开。如果你直接拼接路径，很可能会静默失败，找不到文件。
因此，在 Windows 上同样别手动拼接路径。记住这个万能命令：composer config --global home
这条命令的输出，就是那个真实、可用的绝对路径，直接复制粘贴使用即可。
- AppData 是个隐藏文件夹，记得在文件资源管理器中开启“显示隐藏的项目”才能看到它。
- 在某些受管控的企业环境中，组策略可能会禁用 AppData 目录。这时，Composer 可能会回退到
%USERPROFILE%\Composer这样的路径。不用慌，config --global home命令依然能准确揭示它的藏身之处。 - 尽量避免使用
echo %APPDATA%或$env:APPDATA再去手动拼接，不同 Shell 的环境变量展开行为可能不一致，容易引入错误。
为什么 composer config --global 设的值没生效
这大概是 Composer 配置中最让人困惑的问题之一了。核心原因在于，很多人混淆了「配置写入的位置」和「配置读取的时机」。全局配置主要影响 composer global 这类命令本身，以及一些跨项目的环境行为（比如包镜像源、认证信息）。但是，当你运行 composer install 或 composer update 时，它们默认只会读取项目根目录下的 composer.json 及其内部的 config 段落，对于全局 config.json 中的同名配置项，它们会完全忽略。
- 像
discard-changes、platform-check这类项目级别的开关，必须明确写入项目composer.json的"config"字段里才会起作用。 - 而像
repo.packagist.org镜像地址这类设置，放在全局配置里就很合适，因为它属于“环境基础设施”，项目本身无需关心。 - 有个简单的诊断方法：进入项目目录，分别运行
composer config --list（不带--global）和全局的列表命令，对比一下输出，立刻就能看出哪些配置被项目级设置覆盖了。
如何安全地修改全局配置路径
直接去移动或重命名那个 .composer 文件夹？这可不是个好主意。Composer 提供了一种受官方支持且更安全的方式：设置环境变量 COMPOSER_HOME。这是所有 Composer 版本都一致认可的方法。
在 Linux 或 macOS 上，你可以将下面这行添加到你的 ~/.zshrc 或 ~/.bashrc 文件中：export COMPOSER_HOME="$HOME/.my-composer"
在 Windows 上，操作路径是：系统属性 → 高级 → 环境变量 → 在“用户变量”部分新建：
变量名：COMPOSER_HOME，变量值：C:\my-composer（或你想要的任何路径）。
- 设置完成后，务必新开一个终端窗口，然后再次运行
composer config --global home命令，它应该会返回你设置的新路径。 - 需要警惕的是，旧
~/.composer目录下的内容不会自动搬家。如果你需要保留之前的配置和全局安装的包，得手动把config.json和vendor/目录（如果有的话）复制到新路径下。 - 最后，千万别试图去编辑
config.json文件里的某个home字段来“欺骗”Composer——它根本不认这个。Composer 只认环境变量COMPOSER_HOME或者那几个默认的搜索路径。
