Composer镜像未生效是因为配置命令错误（键名、type值、URL末尾斜杠缺一不可）、项目级repositories字段覆盖全局配置、composer.lock硬编码GitHub地址，必须删vendor和lock文件并执行clear-cache，再用-vvv验证请求域名。
配了镜像但 PHPMailer 还是从 github.com 下载 zip，说明镜像根本没起作用——不是网络慢，是 Composer 仍在直连 GitHub，而国内对 api.github.com 和 codeload.github.com 的 TLS 握手、DNS 解析、连接重置才是真卡点。
composer config -g repo.packagist 为什么总不生效
这条命令写错任意一处，Composer 就静默 fallback 到 packagist.org，且不报错：
-
repo.packagist写成repos.packagist（多一个 s）或packagist（少 repo.），配置不写入 - 漏掉中间的
composer类型参数：composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌，必须带composer✅ - URL 少末尾斜杠：
https://mirrors.aliyun.com/composer❌ → 拼出/composerpackages.json导致 404；正确是https://mirrors.aliyun.com/composer/✅
验证是否真写进去了？运行 composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍显示 https://packagist.org，说明没生效。
为什么删了 lock 文件再 install 才有效
composer.lock 里硬编码了每个包的 dist.url，比如 "https://api.github.com/repos/PHPMailer/PHPMailer/zipball/v6.9.1"。只要 lock 文件存在，Composer 就照着这个地址下，完全无视你配的任何镜像源。
立即学习“PHP免费学习笔记（深入）”；
-
composer install不会改 lock 文件，只按它执行下载 -
composer update会重解析依赖并更新 lock，但前提是元数据走镜像——如果旧 lock + 旧缓存还在，仍可能从 github.com 拉 - 真正见效的做法：删掉
vendor/和composer.lock，再跑composer install -vvv
加 -vvv 是唯一确认方式：日志里出现 Loading composer repositories from https://mirrors.aliyun.com/composer/，且后续 Downloading 行的域名是 mirrors.aliyun.com，才算真正走镜像。
PHPMailer 这类 GitHub 托管包仍卡住？得绕过 GitHub 域名
阿里云等镜像只代理元数据（packages.json），不托管 zip 包。所以即使元数据从镜像拉得飞快，PHPMailer 的 zip 仍默认走 codeload.github.com ——这才是国内最卡的一环。
- 临时方案：用
ghproxy.com类反向代理，把github.com请求转到国内节点：composer config -g github-protocols https（强制 HTTPS，避免 git 协议触发 SSH 问题） - 项目级精准控制：在
composer.json里为phpmailer/phpmailer显式指定 dist："dist": {"url": "https://ghproxy.com/https://codeload.github.com/PHPMailer/PHPMailer/zip/v6.9.1"} - 企业级方案：部署
satis或toran proxy，把 GitHub zip 缓存到内网，彻底避开外网
注意：--repository-url=https://mirrors.aliyun.com/composer/ 只影响元数据获取，对已锁在 composer.lock 中的 dist.url 完全无效。想让它起作用，必须先清 lock。
真正卡住时，别猜网络或服务器，先看 -vvv 日志里下载请求发到了哪个域名——github.com 还是 mirrors.aliyun.com，这比任何“配了没”都准。镜像配置只是起点，清除残留元数据和 zip 地址才是关键动作。
