composer config -g repo.packagist 输出完整 JSON（如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}）仅表示配置写入文件成功，不等于实际生效；项目级 repositories 字段会完全屏蔽全局配置，验证必须通过 composer diagnose 查看“Repo packagist.org”行或 -vvv 日志确认真实请求域名。
composer config -g repo.packagist 输出不等于真生效
它只读你写进配置文件的值，不是看 Composer 实际连哪个源。输出 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 很漂亮，但 composer install 仍可能发请求到 https://packagist.org——因为项目级 composer.json 里的 repositories 字段会完全覆盖全局设置。
验证是否真走镜像，必须触发一次真实网络请求：
- 先清缓存：
composer clear-cache - 再执行带详细日志的安装：
composer require monolog/monolog -vvv - 在输出里搜索
Downloading，确认 URL 是https://mirrors.aliyun.com/composer/packages.json，而不是https://packagist.org/packages.json
更省事的辅助方式是跑 composer diagnose，看 Repo packagist.org: 这一行显示的 URL —— 它反映的是当前 Composer 实际解析依赖时使用的地址，比 config -g 可靠得多。
检查全局配置真实加载路径
运行 composer config --global --list --verbose 是验证 Composer 全局配置真实加载路径的唯一可信方法，首行显示的实际文件路径即为 Composer 唯一读取的全局配置位置，其他路径即使存在也会被静默忽略。
常见断点：
- 首行显示
Global configuration file: /home/user/.config/composer/config.json，那它就只认这个——哪怕~/.composer/config.json存在且有内容，也会被忽略 - Windows 上若用 Git Bash 执行该命令，
%APPDATA%不会展开，可能显示空路径或错误路径；换 PowerShell 或 CMD 重试 - 输出里没看到
Loaded config file行？说明全局配置文件根本没被识别，大概率是COMPOSER_HOME指向了空目录、权限不足，或路径含未展开的变量（如%APPDATA%\Composer）
项目级 repositories 会彻底屏蔽全局镜像
只要项目根目录的 composer.json 中定义了 "repositories" 数组（哪怕内容是空数组 []），全局配置就会被完全跳过。
实操建议：
- 检查方法：
composer config -l | grep repositories，看是否输出项目级repositories条目 - 临时绕过项目配置：
composer update --repository-url=https://mirrors.aliyun.com/composer/ - 团队协作推荐项目级配置：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会自动把镜像加到composer.json的repositories数组首位，不破坏已有私有源
URL 末尾缺 / 会导致静默 fallback 到官方源
这是最隐蔽也最常踩的坑：https://mirrors.aliyun.com/composer/ ✅ 有效；https://mirrors.aliyun.com/composer ❌ 会静默失败。Composer 2.2+ 遇到不带末尾 / 的 URL，不会报错，而是自动回退到默认源，且 composer diagnose 仍显示 Repo packagist.org is default，你完全察觉不到。
同时注意三点：
-
type字段值必须是"composer"，不能省略 -
url必须以/结尾，且协议为https - 键名必须是
repo.packagist（单数），写成repos.packagist或repository.packagist都不会报错，但也不会生效
真正生效的配置，composer config -g repo.packagist 必须输出完整 JSON 对象，且结构合法——漏一个双引号、少一个逗号，都算无效，而 Composer 从不提示。
