根本原因是默认源packagist.org境外不可达，需严格按三条件配置镜像：键名repo.packagist（单数）、type值为composer、URL以/结尾；验证须输出完整JSON；并必须清缓存、删vendor与composer.lock后重装。
国内开发者执行composer install常卡在“Loading composer repositories”或下载缓慢，根本原因是默认源packagist.org位于境外，直连超时失败率极高——这不是网速问题，而是源地址本身不可达。
全局配置阿里云镜像（个人开发首选）
这一步操作起来很简单，直接在终端运行命令即可生效，适用于你本地所有项目。
第一步：执行全局写入命令
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：命令中【repo.packagist】必须是单数、全小写、无s；中间的【composer】是强制type值，漏掉就静默回退官方源；URL末尾的【/】不能省略，否则请求路径拼成/composerpackages.json导致404。
第二步：验证是否真正写入
运行composer config -g repo.packagist，输出必须是完整JSON对象，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。若为空、null或仍显示https://packagist.org，说明配置根本未生效。
项目级配置清华镜像（CI/团队协作必选）
宝塔、GitHub Actions、Docker容器等环境读不到你的全局配置文件，项目级配置写进composer.json，拉代码即生效，避免部署不一致。
方法一：命令自动注入（推荐）
进入项目根目录→执行composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
该命令会自动在composer.json顶层生成repositories字段，并显式添加"packagist.org": false，确保Composer彻底禁用官方源，只走镜像。
方法二：手动编辑composer.json（仅当命令失败时）
打开项目根目录下的composer.json→在顶层添加如下结构：
{"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.tuna.tsinghua.edu.cn/composer/"}, "packagist.org": false}}
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
⚠️ 重要提醒：如果原composer.json中"repositories"是数组[]格式，直接运行composer config命令会报错，必须先手动改为{}对象结构再执行。
临时切换中科大镜像（单次调试专用）
无需修改任何配置文件，适合快速验证某个镜像是否可用，或绕过当前配置冲突。
执行带--repository参数的命令：
composer update --repository=https://packagist.mirrors.ustc.edu.cn
这条命令只影响本次update行为，结束后配置完全不变，不会覆盖全局或项目级设置。
切换后必须执行的清理动作
镜像配置写对了≠立刻生效，缓存和旧锁文件会强制 Composer 继续请求海外地址。
① 清空本地元数据缓存：
composer clear-cache
② 删除项目残留文件：
rm -rf vendor/ composer.lock
③ 重新安装依赖：
composer install
这三步缺一不可。跳过第②步会导致composer.lock中仍记录着海外包地址，安装时依然走官方源，白配镜像。
