composer配置镜像源必须满足三个硬性条件：repo.packagist为单数、type值为"composer"且不可省略、url须为https且末尾带/；否则静默回退至官方源。
composer config -g repo.packagist 命令总不生效？三个硬性条件缺一不可
不是网络卡，是命令写错了。Composer 2.x 遇到错误会静默 fallback 到 https://packagist.org，连报错都没有。
-
repo.packagist必须是单数形式，写成repos.packagist或packagist.org都无效 - 中间的
composer是必需的type值，不能省略，也不能当注释处理 - URL 必须是 HTTPS 且末尾带
/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否真写入：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报 Key not found，或只返回字符串（如 "https://packagist.org"），都说明没配成功。
三大运营商网络下推荐镜像源与实测表现
不同 ISP 路由策略差异大，同一镜像在电信/联通/移动下延迟和稳定性可能完全不同。截至 2026 年 8 月中旬实测：
- 阿里云
https://mirrors.aliyun.com/composer/：电信用户响应最快（平均 120ms），但部分联通节点偶发 502；华东移动用户需注意 CDN 节点切换 - 腾讯云
https://mirrors.cloud.tencent.com/composer/：南方移动用户最稳（广州、深圳节点直连），北方联通用户 TLS 握手略慢（约 +80ms） - 华为云
https://mirrors.huaweicloud.com/repository/php/：教育网和部分校园宽带（含联通校内出口）延迟最低，但路径结构特殊，务必带结尾/
别只看平均值——用 time composer update --dry-run -vvv 2>&1 | grep "Reading packages.json" 抓真实请求日志，确认是否命中目标域名。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置比全局更可靠，尤其在 CI 和多用户环境
全局配置写在 ~/.composer/config.json，但宝塔后台以 www 用户运行、GitHub Actions 用 runner 用户、Docker 容器常以非登录用户启动——它们根本读不到你的全局配置。
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 该命令会自动识别
composer.json中已有的repositories结构：如果是对象，就写入"packagist"键；如果是数组，就追加新项，不破坏私有源 - 千万别手动写
"packagist.org": false，这会导致php、ext-json等基础约束校验失败
改完立刻运行 composer update --lock，确保 composer.lock 记录的是镜像源地址，而非官方源。
换源后仍卡在 “Loading composer repositories”？缓存和 lock 文件才是真因
这不是镜像没生效，而是 Composer 还在读旧缓存和旧 composer.lock。
- 先清缓存：
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再跑
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或mirrors.cloud.tencent.com - 如果日志里还是
packagist.org，说明镜像根本没走通，回头检查前面两个副标题里的硬性条件
特别注意：某些企业防火墙或运营商 DNS 会劫持 HTTPS 请求，若日志始终不出现镜像域名，可临时试下华为云地址——它的证书链和路径结构与其他两家不同，有时能绕过拦截。
