最常见原因是键名、type值、URL格式三者中至少错了一个，而Composer不报错只静默忽略：必须严格为repo.packagist（非repos）、第二个参数必须是composer（type值）、URL末尾必须带/。
composer config -g repo.packagist 命令为什么没生效
最常见原因是键名、type值、URL格式三者中至少错了一个，而 Composer 不报错，只静默忽略配置。
必须严格满足：repo.packagist（不能是 repos.packagist 或 repository.packagist）、第二个参数必须是 composer（这是 type 字段值，不是命令名）、URL 末尾必须带 /。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌ 缺 type，配置写进去了但无效 -
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/❌ 键名多 s，完全不读取 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer❌ 少斜杠，部分版本返回 404
验证是否真生效，别只看 composer config -g repo.packagist 输出，要跑一次真实请求：composer clear-cache && composer require monolog/monolog -vvv 2>&1 | grep "GET\|Downloading"，确认日志里出现的是 mirrors.aliyun.com 而非 packagist.org。
composer install 卡在 “Loading repositories” 怎么办
这不是你网速慢，是 Composer 还在直连 packagist.org —— DNS 污染 + TLS 阻塞下，这个请求基本不可能成功。
立即学习“PHP免费学习笔记（深入）”；
解决路径很明确：先清缓存，再删旧产物，最后重装。
- 运行
composer clear-cache清掉本地元数据缓存 - 删掉项目根目录下的
vendor/和composer.lock（不删 lock 文件，它会按旧 hash 去官方源找包） - 再执行
composer install（不是update），让 Composer 重新解析依赖并从镜像拉取
如果仍卡住，检查 PHP 是否启用了 openssl 和 zlib 扩展：php -m | grep -E 'openssl|zlib'。缺任一扩展，file_get_contents() 会直接失败，错误常表现为 “SSL operation failed”。
全局镜像 vs 项目级镜像，到底该用哪个
全局镜像省事，但团队协作或 CI 环境里它不可靠——因为项目级 repositories 字段会无条件覆盖全局配置。
比如你配了全局阿里云镜像，但同事拉下来的 ThinkPHP 模板里 composer.json 已含 "repositories": [{"type": "composer", "url": "https://packagist.org"}]，那你的全局设置就彻底失效。
- 个人学习/单机开发：用
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队项目/Git 提交：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会自动写进composer.json的repositories字段，且不破坏已有私有源 - CI/CD 流水线：推荐用环境变量
COMPOSER_REPO_PACKAGIST=https://mirrors.tencent.com/composer/，比依赖用户级配置更可控
注意：改完项目级配置后，必须删 vendor/ 和 composer.lock，否则 Composer 仍按旧 lock 文件里的哈希去拉包，哪怕镜像地址对了也没用。
composer diagnose 报 “Repo packagist.org is default” 是什么信号
这说明镜像根本没接管，不是网络问题，是配置没走通。
composer diagnose 比 --version 更值得信任，因为它会模拟一次完整请求流程，包括访问仓库、解析元数据、检查 SSL 证书等环节。
- 如果输出含
Repo packagist.org is default，优先查composer config -g repo.packagist是否为空，再查项目里有没有repositories覆盖 - 某些 IDE（如 PHPStorm）会缓存 Composer 配置，改完全局设置后需重启 IDE 才能识别
- Windows 用户若用宝塔或 WSL，注意
composer config -g写入的是当前用户的~/.composer/config.json，而 Web 服务可能以www用户运行，得切到对应用户再配一次
真正容易被忽略的点是：镜像只解决元数据和 zip 包下载路径，不解决 PHP 扩展缺失、disable_functions 限制（如 proc_open 被禁）、或 OpenSSL 证书过期等问题。这些底层障碍，diagnose 会一并暴露出来。
