镜像源配置失败是因为repo.packagist键名错误、漏掉composer type值或URL末尾缺/，三者任一缺失即静默失效；验证必须输出完整JSON如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空、null或Key not found均表示未写入成功。
Composer仓库配置中镜像源切换失败，不是网络卡顿或服务器响应慢，而是命令格式错一个字符就静默失效——执行后composer config -g repo.packagist输出为空、null或报Key not found，说明配置压根没写进全局配置文件，后续所有install/update仍直连packagist.org。
确认镜像是否真正写入全局配置
运行composer config -g repo.packagist，必须输出完整JSON对象，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
输出为空、false、null或Key not found，说明配置未落盘——这不是“生效慢”，是命令根本没被识别。
【repo.packagist必须是单数、全小写、无s；漏掉中间的composer参数；URL少末尾/或用HTTP协议】，三者缺一即静默失败。
验证时别只看终端没报错，要盯住输出内容本身。空输出=没配成功，立刻重试。
绕过全局配置，直接改项目级repositories
方法一：安全写入composer.json（推荐）
进入项目根目录（确保有composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在composer.json的repositories字段中写入"packagist"条目。如果原"repositories": {}，它会转为标准对象结构；如果已有私有源，它会追加不覆盖。
方法二：手动编辑composer.json
打开项目根目录下的composer.json，找到"repositories"字段。若不存在，添加；若为数组[]，先改为对象{}再写入："repositories": { "packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } }
注意：若原"repositories": []（空数组），composer config命令会静默失败，必须先手动改成{}。
清除残留状态，强制走新镜像
第一步：清本地元数据缓存composer clear-cache
第二步：删掉旧锁文件和依赖目录rm -rf vendor/ composer.lock（Windows用户用rmdir /s vendor & del composer.lock）
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
第三步：重装并验证真实请求地址composer install -vvv 2>&1 | head -n 10 | grep Downloading
日志第一行出现的Downloading地址，才是Composer实际发起HTTP请求的目标域名。
如果仍是packagist.org或api.github.com，说明镜像未生效——不是网络问题，是上一步删得不干净，或composer.json里硬编码了其他repositories覆盖了新配置。
临时调试：不改任何配置，单次指定镜像源
方法一：用-r参数（短选项）composer install -r https://mirrors.huaweicloud.com/repository/php/
方法二：用--repository参数（长选项，更明确）composer update -vvv --repository=https://mirrors.cloud.tencent.com/composer/
该方式完全绕过config.json和composer.json里的所有repositories设置，仅当次命令生效。日志首行Downloading地址即为该镜像源地址，可秒级验证可用性。
⚠️-r不会fallback到官方源。如果该镜像里没有你要的包版本，命令直接报错，不会自动兜底。
检查镜像源本身是否可用
执行：curl -I https://mirrors.aliyun.com/composer/packages.json
必须返回HTTP/2 200或HTTP/1.1 200 OK。若返回302跳转到人机验证页、403、502或超时，说明该镜像当前不适合自动化场景，应立即换源。
已停服源请彻底剔除：https://packagist.phpcomposer.com（2023年底终止）、https://laravel-china.org等。
2026年9月实测稳定源：
阿里云：https://mirrors.aliyun.com/composer/
华为云：https://mirrors.huaweicloud.com/repository/php/
腾讯云：https://mirrors.cloud.tencent.com/composer/
