Composer配镜像必须配对、配全、配准：键名repo.packagist、type值composer、URL为HTTPS且末尾带/，三者缺一即静默失效；验证需执行composer config -g repo.packagist，输出必须为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
Composer 默认连 packagist.org，国内直连基本不可用——不是网速问题，是 DNS 解析慢、TLS 握手卡、首字节延迟常超 300ms，且元数据请求失败率高。配镜像不是“锦上添花”，而是必须做的第一步，且必须配对、配全、配准。
composer config -g repo.packagist 命令不生效？检查这三个硬性条件
这条命令静默失败很常见，根本原因不是网络或权限，而是三个字段缺一不可：
-
repo.packagist是固定键名，写成repos.packagist或mirror都无效 - 中间的
composer是 type 值，不是可选参数，也不能省略或替换成composer.org - 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 或报错，说明没写进去。
全局配置 vs 项目级配置：什么时候该用哪一种
全局配置省事，但只在你本地终端生效；项目级配置写进 composer.json，才能保证协作者和 CI 环境行为一致。
- 全局配置适合个人开发机：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级配置推荐用命令自动写入（不破坏原有结构）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会安全追加到repositories字段里 - 注意：项目级配置优先级高于全局，哪怕你刚配好全局，只要
composer.json里有repositories字段，就会被覆盖且不报错
多用户环境（如宝塔、Docker）下，-g 配的是当前 shell 用户的配置，而 Web 服务可能以 www 用户运行，此时必须切换用户执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后还是卡在 “Loading composer repositories”？清缓存和旧文件是关键
Composer 会优先读取本地缓存和 composer.lock 中记录的元数据地址，哪怕你已经改了镜像，它也可能还在用旧 URL。
- 先运行
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn - 如果仍看到
packagist.org，说明配置未生效，或被项目级repositories覆盖但内容写错了
别靠“感觉变快了”判断是否成功，-vvv 日志才是唯一真实依据。
阿里云、清华、腾讯、华为四家镜像的实际差异点
它们都支持 Composer 2.9.6 和 HTTPS，但同步策略、地域适配和稳定性表现不同：
- 阿里云
https://mirrors.aliyun.com/composer/：同步延迟约 5–10 分钟，华东/华北节点稳定，Laravel/Symfony 包更新及时；小众 GitHub 私仓偶尔滞后 1–2 小时 - 清华
https://mirrors.tuna.tsinghua.edu.cn/composer/：教育网和北方地区极快，南方偶发 DNS 解析慢；对 PHP 8.4 新函数签名验证更严格，新版本上线可能比阿里云晚几小时 - 腾讯云
https://mirrors.cloud.tencent.com/composer/：CDN 覆盖广，华南用户稳定；不保留已下架包，遇到Package not found可能是原包被删，非镜像问题 - 华为云
https://mirrors.huaweicloud.com/repository/php/：全量镜像含历史版本，同步延迟最低，但 metadata 请求略慢（因分片存储）；适合企业级 SLA 场景
不推荐再用 https://packagist.phpcomposer.com 或 https://packagist.laravel-china.org——前者自 2025 年底起频繁 502，后者已停止维护，composer update 会直接报 Repository not found。
