清华源可显著缓解composer install卡在“Loading composer repositories”的问题，但必须严格按-g、repo.packagist、composer三要素配置，且URL末尾需带斜杠，否则静默失效；推荐优先使用项目级配置而非全局配置。
直接用清华源能显著缓解 composer install 卡在 “Loading composer repositories” 的问题，但必须严格按三要素配置，否则静默失效——不报错、不提示、也不走镜像。
清华源地址和当前可用性
截至 2026 年 7 月，清华源地址为：https://mirrors.tuna.tsinghua.edu.cn/composer/（注意末尾斜杠不能少）。该源同步频率高（通常 ≤5 分钟），支持完整元数据和 ZIP 包分发，是目前最推荐的国内镜像之一。已停用的旧地址如 https://packagist.phpcomposer.com 不再有效，切勿复用。
composer config -g repo.packagist 必须带全三个参数
这条命令不是“设个 URL 就完事”，缺一不可：
-
-g：表示全局配置，影响所有项目 -
repo.packagist：键名必须是单数repo，写成repos.packagist（多一个 s）会静默写入无效字段 -
composer：这是 type 值，不是可选说明，也不是默认值——省略它，Composer 2.0+ 会直接 fallback 到官方源 -
https://mirrors.tuna.tsinghua.edu.cn/composer/：URL 必须以/结尾，否则请求路径拼成/composerpackages.json导致 404
正确命令示例：composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
验证镜像是否真生效，别信 composer config -g 输出
composer config -g repo.packagist 返回空或 null，大概率就是上面三要素漏了；但即使它返回了正确 JSON，也不代表请求真发到了清华源。唯一可信方式是看实际网络请求：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer clear-cache && composer install -vvv 2>&1 | grep "GET\|Downloading" - 检查输出中 URL 是否含
mirrors.tuna.tsinghua.edu.cn，而非packagist.org或repo.packagist.org - 如果看到后者，说明项目级配置（如
composer.json中的"repositories": {"packagist.org": false}）覆盖了全局设置
临时绕过所有配置强制测试清华源：composer install --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/ -vvv
项目级配置比全局更可靠，尤其在 CI 和协作场景
全局配置看似一劳永逸，但在真实工程中容易翻车：
- CI 流水线不同节点用户不同（
www-datavsroot），-g配置可能根本没被读到 - 某些项目
composer.json显式禁用了 packagist："repositories": {"packagist.org": false}，会彻底屏蔽全局镜像 - 团队新人拉代码后行为不一致，因为全局配置无法被 Git 跟踪
推荐做法：进项目根目录，运行不含 -g 的命令：composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/。它会安全地在 composer.json 的 repositories 对象里添加 "packagist" 条目，不覆盖已有私有源。
清华源本身稳定，但新包发布后可能有几分钟同步延迟——这不是配置问题，而是镜像机制决定的。如果急需某个刚发布的包，可临时用 --repository-url 指向官方源拉一次，再切回清华源继续后续操作。
