直接换阿里云镜像并清缓存可解决90%的composer下载慢问题；命令必须严格为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，满足单数小写key、含type值composer、https且末尾带/，再执行composer clear-cache，否则静默失效。
composer 下载慢，90% 不是网络差，而是没切对镜像源、缓存没清、或配置被覆盖。直接换阿里云镜像 + 清缓存，基本立竿见影。
composer config -g repo.packagist 命令写对了吗
这条命令极易静默失败，不报错但根本没生效。必须同时满足三个硬条件：
-
repo.packagist不能写成repos.packagist（多一个s就被忽略） - 中间必须带
composer这个 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅；漏掉composer就 fallback 到默认源 ❌ - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（少斜杠会拼接出错，返回 404）
验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象，空、null 或仍是 https://packagist.org 都说明没写进去。
换源后还是慢？先清缓存再查覆盖
缓存里还存着旧的 packages.json 和元数据，composer 会优先读缓存，哪怕配置已改，它仍试图从旧地址拉校验信息——结果卡在 DNS 解析或 TLS 握手。
- 必须执行：
composer clear-cache - 项目级
composer.json中若定义了repositories字段，会直接覆盖全局配置；用composer config --list和composer config --list --global对比确认实际生效的是哪个 - CI 或 Docker 容器里以
www用户运行，但composer config -g写的是root配置（路径为/root/.composer/config.json），www根本读不到；应切到对应用户下执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
怎么验证镜像真从国内拉取
加 -vvv 是唯一靠谱的验证方式，它会打印真实 HTTP 请求日志：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 看日志里是否命中你配的镜像域名（如
mirrors.aliyun.com） - 有没有出现
Connection timed out或curl error 28（说明 DNS 或网络层有问题，不是composer配置问题） - 是否意外加载了
packagist.org的packages.json（说明"packagist.org": false没生效，或项目级配置没加这行）
临时绕过所有自定义源测试：composer install --no-plugins --repository=https://packagist.org —— 如果变快，说明本地 repositories 配置有问题。
Resolving dependencies 卡住跟镜像无关
这个阶段完全不走网络，是 composer 在本地穷举满足所有约束的版本组合。尤其当你写了 "*"、"^1.0 || ^2.0" 或 "minimum-stability": "dev" 时，求解器会指数级爆炸。
- PHP 内存不足（默认 128M 不够）：临时加
COMPOSER_MEMORY_LIMIT=-1再试 - Xdebug 启用中：会让解析慢 5–10 倍，用
php -d xdebug.mode=off $(which composer) install临时禁用 -
platform配置与实际 PHP 版本不匹配（如"php": "7.4"却在 PHP 8.2 上运行），触发降级查找逻辑 -
composer.lock残留已下线包的引用，导致回退搜索 —— 删掉vendor/和composer.lock，再用composer install --no-cache
镜像只加速下载，不解决依赖解析卡顿；真正卡在这一步时，调配置不如先关 Xdebug、加内存、收紧版本约束来得实在。
