镜像源仅加速“Downloading”阶段，对“Resolving dependencies”无效，后者是本地CPU穷举版本组合的纯计算过程；卡在此阶段换镜像无用，需收紧约束、禁用xdebug、优化缓存路径。
配对中文镜像源能显著压缩 composer install 的下载阶段耗时，但对 Resolving dependencies 阶段完全无效——后者是纯本地 CPU 计算，和网络无关。
镜像生效只加速“下载”，不加速“求解”
Composer 运行分两个关键阶段：依赖解析（Resolving dependencies）和包下载（Downloading）。前者在本地穷举满足约束的版本组合，后者才走网络请求。镜像源只影响后者。
- 如果你的日志卡在
Resolving dependencies超过 10 秒，换阿里云、腾讯云镜像毫无作用 - 如果卡在
Downloading https://mirrors.aliyun.com/...且耗时 >2s，说明镜像链路本身不稳定，需用curl -I https://mirrors.aliyun.com/composer/packages.json实测延迟 -
composer update比install更依赖镜像，因为要拉取全量元数据；install只需按composer.lock下载指定 ZIP 包
配置错误导致镜像“看似生效实则失效”
90% 的“换源后仍慢”问题，根源是配置未真正写入或被覆盖，而非镜像本身不可用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repo.packagist写成repos.packagist（多一个 s）：Composer 静默忽略，不报错也不提示 - 漏掉
composer类型参数：composer config -g repo.packagist https://...❌，必须是composer config -g repo.packagist composer https://...✅ - URL 缺末尾斜杠：
https://mirrors.aliyun.com/composer❌ 会返回 404 或触发 fallback，正确是https://mirrors.aliyun.com/composer/✅ - 项目根目录
composer.json中存在repositories字段：优先级高于全局配置，直接屏蔽config -g设置
parallel-downloads 参数的真实影响范围
这个参数只在 composer install 下载 ZIP 包时起作用，且前提是镜像已生效、支持 HTTP/2、Composer 版本 ≥2.2。
- 默认值
3基本等于串行下载；设为10是安全上限，composer config -g parallel-downloads 10 - 设为
20在低配 CI 或 WSL2 环境下容易触发file_put_contents(): failed to open stream错误 - 若镜像未生效（比如仍从
packagist.org下载），该参数完全不触发并发逻辑 -
composer update不受此参数影响，它始终单线程拉元数据
缓存路径位置比镜像源更能拖慢整体速度
当 cache-dir 落在机械硬盘、WSL2 挂载的 Windows 目录、加密卷或 NFS 上时，解压 ZIP 包的 I/O 成为瓶颈，安装时间可能比网络延迟更严重。
- 检查当前路径：
composer config --global cache-dir - 迁移到 SSD 路径：
composer config -g cache-dir /mnt/ssd/composer-cache - CI/CD 中务必确认执行用户（如
www或git）是否拥有该路径写权限，root下配的全局配置对其他用户无效 - 临时验证新路径是否生效：
COMPOSER_CACHE_DIR=/tmp/composer-test composer install --dry-run，再看/tmp/composer-test是否生成文件
最容易被忽略的是：镜像配置只是提速链条中的一环，而 Resolving dependencies 卡顿、缓存路径 I/O 拖累、xdebug 开启、PHP 版本过低这些本地因素，往往比网络慢更致命。验证时别只盯着日志里有没有 mirrors.aliyun.com，先确认卡在哪一行、哪一毫秒。
