composer镜像配置必须同时满足三要素：键名repo.packagist（单数）、type值显式为composer、url以https://开头且末尾带/，缺一则静默回退官方源；验证需执行composer config -g repo.packagist并确认输出为完整json对象。
镜像配置写错就等于没配，composer config -g repo.packagist 命令必须同时满足键名、type、URL 三要素，否则 Composer 2.0+ 会静默 fallback 到 https://packagist.org，你根本收不到任何提示。
为什么 composer config -g repo.packagist 总不生效
不是网络慢，是命令本身写错了三个硬性点：
-
repo.packagist必须是单数形式，repos.packagist或repositories.packagist全部无效 - 第二个参数必须显式写
composer—— 它是type值，不是注释，不能省略，也不能替换成 URL - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求拼成/composer/packages.json直接 404）
验证是否真写进去了？只看这一行输出：composer config -g repo.packagist。正确结果必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是官方地址，说明根本没落地。
换源后依然卡在 “Loading composer repositories”
这不是镜像地址问题，而是 Composer 还在用旧缓存或旧 composer.lock 中的元数据地址：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先执行
composer clear-cache - 再删掉本地缓存目录：
rm -rf ~/.composer/cache/repo/https---packagist.org/（Linux/macOS），或%APPDATA%\Composer\Cache\repo\https---packagist.org\（Windows） - 如果项目已有
composer.lock和vendor/，必须全部删掉，再跑composer install（不是update） - 临时验证是否走镜像：运行
composer install -vvv | grep -i "mirrors.aliyun"，没输出就说明流量还在直连海外
CI/CD、宝塔、Docker 环境里镜像不生效
全局配置只对当前用户生效，而这些环境往往以 www、www-data、runner 等非登录用户身份运行，压根读不到你 root 或个人用户的 ~/.composer/config.json：
- 先确认实际执行用户：在宝塔终端跑
whoami，或查 CI 日志里的 UID - 给对应用户单独配：比如是
www用户，就执行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 更稳的做法是放弃全局配置，在项目根目录下运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带-g），它会写进composer.json的repositories字段，Git 可追踪，所有环境一致读取 - 注意：
repositories字段一旦存在，就会完全屏蔽全局配置；若已存在数组形式"repositories": []，该命令会静默失败，需先手动改为对象"repositories": {}
镜像加速不了的超时场景
有些超时跟镜像源无关——依赖包内部硬编码了 github.com、raw.githubusercontent.com 或 git@ 地址，Composer 会绕过镜像直连：
- 典型表现：
composer install -vvv最后一行停在Downloading https://raw.githubusercontent.com/...或Cloning git@github.com:... - 先用
grep -r "github.com\|raw.githubusercontent.com" . --include="*.json" --include="*.php"扫描项目代码，定位硬编码位置 - 临时屏蔽：往
/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）加127.0.0.1 raw.githubusercontent.com，让请求直接失败而非无限等待 - 跳过 problematic 脚本：
composer install --no-scripts --no-plugins可绕过 post-install-cmd 或插件中自发起的外网请求
真正难处理的是闭源包或 Composer 插件里的硬编码调用——它们不走 Composer 下载逻辑，也没法被镜像代理，只能靠 hosts 截断或强制失败来止损。
