最简单有效的命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，必须同时满足键名单数repo.packagist、type值显式写composer、url为https且末尾带/，缺一即静默回退官方源，验证需输出完整json对象。
最简单有效的命令就是这一条： composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。其他写法看似省事，但极大概率静默失效——命令不报错，composer install 却依然卡在 Downloading https://packagist.org/packages.json。
为什么这条命令必须带三个“硬参数”
它不是普通配置项，而是 Composer 启动时识别镜像源的唯一入口。漏掉任意一个，配置就进不了生效路径：
-
repo.packagist是键名，拼成repos.packagist（多一个 s）或repositories，Composer 完全忽略 -
composer是type值，不是可选参数，也不是注释；漏掉会导致 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须以/结尾，否则请求路径会变成/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
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果输出为空、
null、或只有 URL 字符串，说明没写进去——常见原因是之前误用了repos.packagist，得先composer config -g --unset repos.packagist - 更进一步验证：运行
composer update -vvv 2>&1 | grep "Downloading"，日志里出现的域名必须是你配的镜像地址
项目级配置会彻底屏蔽全局设置
只要当前目录下 composer.json 里有 "repositories" 字段，全局的 repo.packagist 就完全不生效。这不是 bug，是 Composer 的明确设计逻辑：
- 想临时绕过项目配置？用
composer install --repository-url=https://mirrors.aliyun.com/composer/ - 想让项目也走镜像且保留私有仓库？别手写 JSON，改用命令合并：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - CI/CD 环境（如 GitHub Actions）默认不读全局配置，必须在流水线脚本中显式执行项目级配置命令
真正容易被忽略的点是缓存：改完配置不执行 composer clear-cache，旧的 packages.json 还在本地，Composer 会继续从缓存读取 packagist.org 的元数据——表面看配置对了，实际请求根本没发往镜像。
