Composer下载慢严重影响效率？更换Composer中文镜像-composer-PHP中文网

换镜像可解决90%的composer install卡顿问题，但必须严格配置：composer 2.x仅认repo.packagist键名、url需https且结尾带/、type值必须显式设为composer、验证须用-vvv日志确认域名，且换源后必须清缓存。

composer下载慢严重影响效率？更换composer中文镜像

换镜像能解决 90% 的 composer install 卡在 “Loading composer repositories” 或反复重试下载的问题，但配错一个字符就等于没配——不是镜像不行，是你没配对、没配全、没配准。

repo.packagist 必须写对，少个 s 就静默失效

Composer 2.x（当前主流版本）只认 repo.packagist 这个键名，repos.packagist、mirror、packagist.org 全部无效，且不报错、不提示，直接 fallback 回官方源。

composer config -g repo.packagist 输出为空、null 或仍是 https://packagist.org，说明根本没写进去
别手写 ~/.composer/config.json —— JSON 格式错一个逗号就让整个配置失效
旧版 Composer 1.x 才用 repos.packagist，查版本用 composer --version，输出带 2. 开头就是新版

URL 必须 HTTPS + 末尾斜杠，少 / 就 404

镜像地址必须以 / 结尾，否则 Composer 会错误拼接成类似 https://mirrors.aliyun.com/composerpackages.json，返回 404，卡在元数据拉取阶段。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

✅ 正确：https://mirrors.aliyun.com/composer/
❌ 错误：https://mirrors.aliyun.com/composer（少斜杠）、http://mirrors.aliyun.com/composer/（非 HTTPS）
腾讯云、华为云等其他镜像同理，必须 HTTPS + 末尾 /
已停服的 https://packagist.phpcomposer.com 别再用，现在基本返回空或 404

type 值必须显式传入 composer

命令里漏掉 composer 这个 type 参数，Composer 2.x 会直接忽略配置，走默认源。这不是可选项，是硬性要求。

正确命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
错误写法：composer config -g repo.packagist https://mirrors.aliyun.com/composer/（缺 composer）
验证方式：composer config -g repo.packagist 应输出完整 JSON 对象或纯 URL 字符串，含 "type": "composer"
项目级配置（不加 -g）也会自动写入 "type": "composer"，但前提是 composer.json 中 repositories 是对象而非数组

-vvv 日志才是唯一真实证据

不加 -vvv，你看到的 “Downloading xxx” 完全是障眼法——它不显示域名，无法确认是否真走镜像。只有日志里出现 mirrors.aliyun.com 或对应镜像域名，才算生效。

运行：composer install -vvv 2>&1 | grep "Downloading"
若日志中 URL 域名仍是 api.packagist.org 或 packagist.org，说明配置未生效或被项目级 repositories 覆盖
临时绕过所有自定义源测试：composer install --no-plugins --repository=https://packagist.org，如果这时反而快了，就是项目配置劫持了全局设置
CI/CD 中务必加 -vvv 存档日志，避免“以为配了，其实没走”这种低级但高频的故障

最常被忽略的是缓存残留和并发参数误用：设了已弃用的 parallel-downloads 不报错也不生效，真正该用的是 http-max-concurrent-downloads；清缓存不是可选动作，而是换源后必须立刻执行的同步步骤——否则 Composer 仍从旧缓存读 packages.json，根本不会发请求去新镜像。