必须切换镜像源并配置备用方案：先执行composer config -g repo.packagist确认当前源，若无效则秒切华为云镜像，再用-vvv验证是否命中mirrors.huaweicloud.com；阿里云与华为云为周末首选，需配合clear-cache、禁用项目级覆盖及检查https末尾/等三要素确保生效。
周末高峰期拉取依赖卡顿，不是网络带宽问题，而是默认源 packagist.org 在高并发时段响应变慢、TLS 握手排队、DNS 解析延迟放大所致。必须切换镜像源，且不能只切一个——得有备用方案。
为什么单个镜像在周末也卡？
阿里云、腾讯云等主流镜像虽稳定，但周末流量高峰时部分节点可能出现 CDN 回源延迟或同步滞后（尤其新发布包），导致 packages.json 拉取超时或 fallback 到官方源。现象是：composer install -vvv 日志里出现多次 https://packagist.org/packages.json 请求，或卡在 Reading packages.json from cache 后无响应。
常见诱因包括：
-
composer clear-cache没执行，旧缓存仍含过期元数据，强制回源校验 - 项目级
repositories配置覆盖了全局镜像，且该自定义源本身不可用 - 公司防火墙/代理对某些镜像域名（如
mirrors.cloud.tencent.com）做了限速或拦截
怎么快速切到备用镜像源？
别重装、别改配置文件，用命令行秒切。关键是：先确认当前生效源，再按优先级顺序试备选。
执行以下三步定位并切换：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查当前全局源：
composer config -g repo.packagist—— 若输出为空、null或仍是https://packagist.org，说明没生效 - 临时切华为云（CDN 节点多，周末抗压强）：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/composer/ - 验证是否走新源：
composer install --no-plugins --dry-run -vvv 2>&1 | grep "mirrors.huaweicloud.com"—— 有匹配行即成功
哪些镜像适合做周末备用？
不是所有国内镜像都适合高峰期兜底。清华源同步快但 CDN 覆盖略弱；中科大源稳定性好但更新稍慢；华为云和阿里云是首选，但二者行为不同：
- 阿里云镜像（
https://mirrors.aliyun.com/composer/）：同步延迟最低（通常 - 华为云镜像（
https://mirrors.huaweicloud.com/composer/）：CDN 节点多、带宽足，对突发流量容忍度高，适合作为周末 fallback - 腾讯云镜像（
https://mirrors.cloud.tencent.com/composer/）：南方节点响应快，若你本地出口在广东/浙江，可优先试它
注意：repos.packagist（少个 o）是旧版写法，Composer 2.2+ 必须用 repo.packagist，拼错就静默失效。
切镜像后还卡在 Resolving dependencies 怎么办？
这个阶段完全不走网络，卡住说明是本地解析瓶颈。周末 CI/CD 机器常因资源争抢导致 PHP 内存不足或 xdebug 意外启用：
- 临时提内存上限：
COMPOSER_MEMORY_LIMIT=-1 composer install - 绕过 xdebug：
php -d xdebug.mode=off $(which composer) install - 删掉
vendor/和composer.lock，加--no-cache重装 —— 避免旧 lock 引用已下线包触发降级搜索 - 检查
platform声明是否宽松，比如"php": ">=7.4"会让 SAT 求解器遍历数百个版本，收紧为"php": "^8.1"可立竿见影
最易被忽略的是：composer install 在周末高峰期若搭配 --prefer-dist 却未真正走镜像，就会 fallback 到慢速 Git clone —— 所以每次切源后，务必用 -vvv 看实际下载域名。
