Composer下载慢90%因镜像未生效、缓存未清或ZIP仍直下GitHub；必须严格满足repo.packagist键名、composer类型参数、URL结尾斜杠三者全对，否则静默回退packagist.org，执行clear-cache并验证config和-vvv日志确认走镜像。
Composer下载慢，90%不是网络差，而是镜像没生效、缓存没清、或 ZIP 包仍从 GitHub 直下——配错一个字符（比如少个/）、键名写成repos.packagist（多一个s）、漏掉composer类型参数，都会静默 fallback 到packagist.org，卡在Loading composer repositories或Downloading https://codeload.github.com/...。
确认镜像是否真正生效
别只看命令有没有报错，得验证输出和日志：
-
composer config -g repo.packagist必须输出完整 JSON 对象，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果输出是空、null、或仍是https://packagist.org，说明根本没写进去 - 执行
composer install -vvv 2>&1 | grep "Downloading"，日志里出现的域名必须是mirrors.aliyun.com或你配置的镜像域名；如果看到codeload.github.com或packagist.org，说明元数据走了镜像，但 ZIP 下载路径没变 - 旧版 Composer（1.x）不认
repo.packagist，得用composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}'
换源后必须清缓存并删残留文件
镜像配置只是“告诉 Composer 去哪拉元数据”，但本地缓存里还存着旧源的packages.json和已下载的 ZIP，Composer 会优先读缓存，导致看似配了却仍连海外站。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 立刻执行
composer clear-cache——这是硬性步骤，跳过就白配 - 如果项目已有
vendor/和composer.lock，建议一并删除再跑composer install，避免残留引用触发降级查找 - 注意：
cache-dir下只有files/子目录里的 ZIP 包能被--prefer-dist直接复用；repo/和vcs/目录断网即失效
并发下载与安装参数组合使用
Composer 2.2+ 原生支持并发，但参数名和适用场景有明确限制：
-
parallel-downloads已弃用，正确配置是composer config -g http-max-concurrent-downloads 10（推荐 8–10，太高反而触发file_put_contents(/tmp/): failed to open stream） -
--prefer-dist强制走 ZIP 包，跳过git clone开销；对含大量私有 Git 源的项目，可局部加"preferred-install": {"your-vendor/*": "source"} - 生产部署必加
--no-dev --optimize-autoloader：前者跳过require-dev包（省 30–60% 时间），后者生成类映射，加载快 2–3 倍 - 禁用 Xdebug：
php -d xdebug.mode=off $(which composer) install，否则依赖解析慢 5–10 倍
虚拟机/Docker 环境额外踩坑点
这类环境慢，常因网络栈和文件系统双重拖累，单靠换源不够：
- DNS 解析慢是主因：改
/etc/resolv.conf为nameserver 114.114.114.114和223.5.5.5，再往/etc/hosts预写关键域名 IP（如223.6.6.6 mirrors.aliyun.com） - 禁用
systemd-resolved：sudo systemctl disable --now systemd-resolved，它会偷偷覆盖resolv.conf - 别挂载宿主机目录跑
composer install：VirtualBox/VMware 在 macOS/Windows 上桥接 I/O 极慢；应把代码复制进虚拟机本地磁盘，或用命名卷缓存vendor（如docker run -v myapp-vendor:/app/vendor） - 容器内确保装了
zip、unzip、git、openssl扩展，缺一个都可能失败或退化为低效路径
最常被忽略的是：镜像 URL 必须以/结尾，https://mirrors.aliyun.com/composer会拼出/composerpackages.json导致 404；而repo.packagist写成repos.packagist，Composer 直接无视——这两个细节错一个，优化全归零。
