直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可全局启用阿里云镜像，但漏 -g、少末尾斜杠、误用 repos.packagist 等任一错误均导致静默失效；composer 2.9.6 仅认 repo.packagist（单数），需配合 clear-cache 并用 -vvv 日志验证真实请求地址。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局启用阿里云镜像，下载速度通常从几 KB/s 提升至 1–5 MB/s；但命令写错一个字符（比如漏 -g、少末尾斜杠、用错键名 repos.packagist）就会静默失效，不报错也不生效。
确认 Composer 版本和配置键名是否匹配
Composer 2.0+ 必须用 repo.packagist（单数 repo），旧版 1.x 才认 repos.packagist（复数）。现在主流是 2.9.6，repos.packagist 已废弃，设了也无效。
- 查版本：
composer --version，输出含2.开头即为新版 - 验证当前全局配置：
composer config -g repo.packagist，应返回完整 URL 或 JSON 对象；若为空、null或仍是https://packagist.org，说明没生效 - 别手写
~/.composer/config.json—— 容易格式错误；统一用config命令操作
为什么换了镜像还是卡在 Downloading？常见覆盖场景
项目级 repositories 配置会直接覆盖全局镜像，这是最常被忽略的失效原因。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查是否被劫持：
composer config -l | grep repositories.packagist，如果输出带项目路径，说明composer.json里写了"repositories"字段 - 查看
composer.json顶层是否有"repositories"，尤其注意是否包含"packagist.org": false这类显式禁用项 - 临时绕过所有自定义源验证：
composer install --no-plugins --repository=https://packagist.org，如果这时反而快了，就坐实是项目配置覆盖问题
必须加 -vvv 看真实请求地址
-vvv 不是调试可选项，它是唯一能确认“到底走哪个源”的证据 —— 日志里出现 mirrors.aliyun.com 才算真生效。
- 运行：
composer install -vvv 2>&1 | grep "Downloading"，观察 URL 域名 - 临时测试镜像可用性：
composer create-project laravel/laravel test --repository=https://mirrors.aliyun.com/composer/ -vvv - 注意：不加
-vvv时，即使失败也可能只显示 “Downloading xxx” 而不暴露域名，无法定位问题
换镜像后仍慢？别怪源，先看这三件事
镜像只加速下载，不解决依赖解析卡顿。如果卡在 Resolving dependencies，和镜像无关，得查本地环境。
- PHP 内存不足：
COMPOSER_MEMORY_LIMIT=-1 composer update临时放开限制 - Xdebug 启用：
php -d xdebug.mode=off $(which composer) install关掉再试 -
composer.lock陈旧或含已下线包：删掉vendor/和composer.lock，再composer install --no-cache - 别忘了清缓存：
composer clear-cache，旧缓存可能还指向海外元数据
最容易被忽略的是：镜像 URL 必须带末尾斜杠，https://mirrors.aliyun.com/composer/ 少一个 / 就会拼出 /composerpackages.json 导致 404；还有人把 composer 当注释省略，结果 Composer fallback 到官方源而不提示 —— 这些细节不验证，配了也白配。
