Composer下载慢的根本原因是直连packagist.org导致DNS解析慢、TLS握手卡、首字节延迟高，必须换国内镜像源；全局配置阿里云镜像执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，需严格满足键名、type值、URL结尾三要素，否则静默失效。
composer 命令行工具打包分发慢，根本不是你网络差，而是默认直连 packagist.org——DNS 解析慢、TLS 握手卡、首字节延迟高，换国内镜像源是刚性前提，不是“试试看”。
全局配置阿里云镜像（最稳、最省事）
执行一条命令即可覆盖所有项目，无需改每个 composer.json：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意三个硬性条件：键名必须是 repo.packagist（不能多 s），type 必须显式写 composer，URL 必须以 / 结尾。漏任一都会静默失效。
- 验证是否生效：
composer config -g repo.packagist输出应为完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或仍是packagist.org都说明没写进去 - Windows 用户配置文件在
C:\Users\用户名\AppData\Roaming\Composer\config.json，Linux/macOS 在~/.composer/config.json，别手动编辑，容易格式错或覆盖auth配置 - 旧版
composer1.x 不识别repo.packagist，得用composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}'
为什么换了镜像还卡在 Resolving dependencies？
这个阶段不走网络，但严重受 PHP 环境影响：composer install 卡在 Resolving dependencies，90% 和镜像无关，常见真实原因：
-
COMPOSER_MEMORY_LIMIT过低（如默认 128M），依赖图复杂时直接 OOM —— 临时加COMPOSER_MEMORY_LIMIT=-1再试 - 启用了
xdebug（php -v可确认），会让解析慢 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
并发下载怎么开才真有效？
composer 2.1+ 默认启用并发，但多数人设错参数或版本太低，白配：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认版本：
composer --version必须 ≥ 2.1；低于此版本压根不支持原生并发 - 只认
http-max-concurrent-downloads，parallel-downloads已弃用 —— 设了也白设 - 合理值是
8–10：composer config -g http-max-concurrent-downloads 10；设成 20 容易触发临时文件竞争，报file_put_contents(/tmp/): failed to open stream - 并发只对
install生效；update因需实时解析依赖图，底层仍有串行环节，别指望快 3 倍 - 镜像没换，并发再高也没用 —— 每个请求都卡在 DNS 或 TLS，开 10 个线程等于 10 个排队窗口
项目级配置和临时切换怎么用才不踩坑？
团队协作或 CI 场景下，项目级配置更可靠；临时调试则用 --repository 参数：
- 项目级：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会安全追加到composer.json的repositories字段里，Git 提交后队友自动同步 - 千万别手动加
"packagist": false，否则基础包（如monolog/monolog）都拉不到 - 临时切换只对单次命令生效：
composer install --repository=https://mirrors.aliyun.com/composer/；注意参数名是--repository，不是--repository-url或--mirror，后者会被静默忽略 - 项目级配置优先级高于全局，如果
composer.json里已有repositories，全局镜像会被覆盖 —— 查composer config -l | grep repositories.packagist就能定位
xdebug、内存限制、composer.lock 残留这些本地环境细节拖住。验证一定要用 -vvv 看实际请求域名，而不是只信配置输出。 
