正确命令是 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，需满足三条件：字段名必须为单数 repo.packagist、url 末尾带 /、末尾必须指定 composer 类型；同时调高 http.timeout 和 process-timeout，并执行 composer clear-cache。
composer config -g repo.packagist 命令写错就白配
很多人执行 composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/，结果 composer install 还卡在 Downloading https://packagist.org——根本没切过去。问题出在字段名多了一个 s：repos.packagist 是无效键，必须是单数 repo.packagist。
还要同时满足三个硬性条件：
-
repo.packagist字段名不能拼错，也不能写成repositories.packagist.org（那是 Composer 2.2+ 新语法，旧版不认） - URL 后必须带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（否则请求变成/composer/packages.json，404） - 命令末尾的
composer类型标识不能省，漏掉就 fallback 到官方源，且composer diagnose会报Repo is not configured properly
镜像源索引文件太大导致超时？调高 http.timeout 和 process-timeout
阿里云、腾讯云等镜像站的 packages.json 文件已超 10MB，首字节响应慢或下载中途断连很常见。默认 http.timeout=60 秒根本不够用——它控制整个 HTTP 请求生命周期（DNS + TLS + body 下载），不是只管“下载完成”。
必须同步设置两个参数：
-
composer config -g http.timeout 600（单位秒，覆盖 DNS 解析、TLS 握手、body 流式下载全过程） -
composer config -g process-timeout 1200（1200 秒 = 20 分钟，足够处理大 vendor 解压、autoload 生成等后续步骤）
别碰 http-basic.timeout——Composer v2+ 完全不读这个；也别信 --timeout=600，它只限制命令总耗时，对 HTTP 下载阶段无效。
验证是否真走镜像？别只看 URL 字符串
运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。如果只是字符串 "https://mirrors.aliyun.com/composer/"，或返回 null、空值、甚至仍是 https://packagist.org，说明配置没生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见干扰项：
- 手动编辑过
~/.composer/config.json，JSON 格式错误（比如多逗号、引号不匹配）会导致composer命令直接崩溃，报file_get_contents(): Failed to open stream - 项目级
composer.json中定义了repositories，会覆盖全局配置——检查是否有"repositories"字段，临时注释掉再试 - 用了
prefer-source: true，镜像完全失效（镜像只代理 dist 包，不代理 Git 克隆）
清缓存不是可选项，是必做动作
旧缓存可能仍指向海外元数据，即使镜像配置正确，composer install 仍会尝试从 packagist.org 拉取索引。必须立刻执行：
composer clear-cache
注意：CI/CD 环境每次容器启动都是干净环境，COMPOSER_HOME 未固化会导致配置丢失，构建脚本开头必须显式执行 composer config -g repo.packagist ... 和 composer clear-cache。
索引文件体积大带来的问题，本质是网络链路和本地配置的双重适配——镜像解决“慢”，timeout 解决“断”，缓存清理解决“假回退”。三者缺一不可，且顺序不能乱：先配对，再清缓，最后跑 install。
