Composer全局镜像配置失效主因是键名错（须为repo.packagist单数）、缺type值“composer”、URL末尾无/，三者任一出错均静默回退官方源；项目级repositories字段会完全屏蔽该配置，验证需检查config输出、diagnose及-vvv日志。
直接换国内镜像源能解决 90% 的 composer install 卡住、Could not resolve host、Connection refused 问题，但配错一个字符就会静默回退到官方源，根本不会报错。
为什么 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 config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错或只返回字符串，都说明没写入。
项目级配置比全局更可靠
CI/CD 流水线、团队协作中，全局配置容易因用户权限（如宝塔用 www 用户执行）、不同成员本地设置不一致导致 composer.lock hash 不一致甚至解析失败。
推荐在项目根目录执行：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
这条命令会安全追加到 composer.json 的 repositories 字段，不覆盖已有私有源，也不破坏 JSON 格式。注意："packagist.org": false 这类禁用默认源的配置不要手动加，否则基础扩展（如 ext-json）校验会失败。
换源后还是卡在 “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 - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv
观察日志第一行：Downloading https://... 后面的域名要是你配的镜像地址（如 mirrors.cloud.tencent.com），才算真正生效。如果还看到 packagist.org，说明清理或配置没到位。
遇到 503 或同步延迟怎么办
阿里云镜像同步延迟通常 1–6 小时，新发布的包可能还没收录；腾讯云和 https://packagist.proxy.fly.dev 在流量高峰更稳定。
临时切换不用改配置：
composer update --repository=https://packagist.proxy.fly.dev
或者秒切腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
已停用的 https://packagist.phpcomposer.com 别再试，现在会跳转到不可靠页面。
最易被忽略的是：换源后不清理缓存和 composer.lock，就等于白配；还有人把 repo.packagist 错打成 repos.packagist，然后反复重试却从不检查 composer config -g repo.packagist 输出。
