composer全局镜像配置不生效是因repo.packagist键名、composer类型、https末尾斜杠三条件未满足；需清缓存、删vendor与lock、设并发及prefer-dist，并确保目标用户配置正确。
配完镜像还卡在 Downloading https://codeload.github.com/，说明导出的配置没真正生效——composer config -g repo.packagist 命令漏掉任意一个硬条件，就会静默回退到官方源，且不报错。
为什么 composer config -g repo.packagist 总是不生效
这条命令不是“写进去就完事”，它有三个不可协商的硬性条件：
-
repo.packagist必须是单数键名，写成repos.packagist或packagist.org会被完全忽略 - 第二个参数必须显式写
composer（这是仓库类型声明，不是可选值） - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/composerpackages.json，直接 404）
验证是否写成功，只看这一行输出：composer config -g repo.packagist。返回空、null、或仍是 https://packagist.org，说明根本没写进去。
导出配置后仍从 GitHub 下 zip 的真实原因
镜像只代理元数据（packages.json），不托管 ZIP 包。即使 composer.lock 里 dist.url 显示的是镜像域名，实际下载时 Composer 仍可能 fallback 到原始 GitHub 地址——尤其当 lock 文件里存的是旧 dist.url 或缓存未清。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.lock一旦生成，就固化了每个包的dist.url和dist.reference，换镜像后不删它，Composer 就照着旧地址下 -
composer clear-cache必须执行，否则它仍从本地缓存读取旧元数据，镜像等于白配 - 执行
composer install -vvv | grep "Downloading"，若看到https://api.github.com/或https://codeload.github.com/，说明 ZIP 下载路径没变
项目级配置比全局更可靠，但要注意格式陷阱
进项目根目录运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会往 composer.json 的 repositories 字段里追加，但前提是格式正确：
- 如果
"repositories": {}是对象，命令会自动转为数组并插入新项 - 如果
"repositories": []是空数组，命令能正常追加；但若已存在私有 Git 源且格式混乱（比如引号不全、逗号错位），命令会直接报错 - 千万别手动加
"packagist.org": false——这会彻底屏蔽基础包校验，导致php、ext-json等依赖无法解析
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install，否则旧 lock 文件里的 hash 可能和镜像元数据不匹配。
并发下载不调等于白配镜像
Composer 2.2+ 默认只并发 3 个连接，对国内带宽严重浪费。不调这个参数，换再快的镜像也卡在 Downloading。
- 设并发数：
composer config -g parallel-downloads 10 - 强制走 dist（非 source）：
composer config -g prefer-dist true - 验证是否生效：
composer config -g parallel-downloads应输出10，composer config -g prefer-dist应输出true
最容易被忽略的一点：宝塔、CI、Docker 容器里实际执行用户往往不是你当前终端用户。比如你在 root 下配了全局镜像，但宝塔后台是以 www 用户运行的，它读的是 /home/www/.composer/config.json，根本看不到你的配置。得用 sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 才真正生效。
