Composer 2.2+ 对 repo.packagist 配置有严格校验，键名、type 值、URL 格式三者任一错误均静默回退至官方源，且不报 warning；验证是否生效需执行 composer config -g repo.packagist 并确认返回完整 JSON 对象。
composer config -g repo.packagist 配置不生效的真正原因
不是网络不通，是命令根本没写进配置。Composer 2.2+ 对 repo.packagist 的键名、type 值、URL 格式三者做硬校验，错一个就静默 fallback 到 https://packagist.org，连 warning 都不抛。
常见错误现象：
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer（少斜杠）→ 请求路径变成/composerpackages.json导致 404 -
composer config -g repos.packagist composer https://...（多 s）→ 键名非法，配置被忽略 -
composer config -g repo.packagist https://...（漏掉中间composer）→ type 缺失，视为无效
验证是否真生效，只看这一行输出：composer config -g repo.packagist。必须返回完整 JSON，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null、Key not found 或纯字符串 URL，都说明失败。
镜像源不是实时同步，而是按需拉取
阿里云、腾讯云等镜像站不会全量预同步所有 provider 文件（如 provider-laravel~10.0.0.json），而是等到你首次请求时才反向抓取官方源并缓存。这意味着：你 composer install 卡在下载某个 provider-*.json，大概率不是网络问题，而是该文件尚未被镜像站拉取。
排查方法：
- 用
curl -I https://mirrors.aliyun.com/composer/p2/laravel/framework/10.0.0.json看是否返回200 - 对比官方源：
curl -I https://repo.packagist.org/p2/laravel/framework/10.0.0.json - 如果官方有、镜像返回
404或空响应，说明未同步，可临时切中科大源：composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/
别信 -vvv 日志里 “Resolving dependencies” 那行——那只是开始。真正卡点在后续几百次 provider 请求，每个都可能触发一次镜像同步延迟。
项目级配置比全局更可靠，尤其在 CI 和 Docker 中
全局配置写在 ~/.composer/config.json，但 GitHub Actions 用 runner 用户，宝塔用 www 用户，Docker 容器常以非登录用户运行——它们根本读不到你的个人配置。
正确做法是进项目根目录执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）
它会自动修改 composer.json 的 repositories 字段，写入 "packagist": {"type": "composer", "url": "..."} 。但前提是原 repositories 是对象（{}），不是数组（[]）；如果是数组，命令会报错，需先手动改成对象。
改完必须清三样：
composer clear-cacherm -rf vendor composer.lock-
composer install（不能用update，否则复用旧 lock）
换源后仍卡在 Loading composer repositories 怎么办
这不是镜像没生效，是 Composer 还在读本地缓存和旧 composer.lock。即使你刚配好镜像，它也可能继续往 packagist.org 发请求。
关键点在于：镜像只加速元数据下载，不参与依赖解析逻辑。所以卡在这里，99% 是缓存或 lock 文件残留导致的。
必须操作：
- 确认
composer.json里没有手写的"packagist.org": false—— 这会屏蔽基础包校验，导致require失败 - 检查是否误用了
disable-tls true（镜像必须走 HTTPS，该配置会导致请求失败） - 运行
composer install -vvv 2>&1 | grep "Downloading"，日志里出现的域名必须是镜像地址，如mirrors.aliyun.com，否则说明根本没走通
最易被忽略的是：镜像 URL 末尾的 / 是硬性要求，且 repo.packagist 必须是单数——这两个细节错一个，整个配置就形同虚设。
