镜像只加速下载环节，因Composer流程分三步：解析依赖（本地SAT求解，不联网）、获取元数据、下载包；镜像仅替换后两步的远程地址，不参与第一步约束求解。
影响，但只加速下载环节；如果卡在 Resolving dependencies 或 Loading composer repositories，换镜像完全无效。
为什么镜像只对下载阶段起作用
Composer 的安装流程分三步：解析依赖 → 获取元数据 → 下载包。镜像源只替换后两个环节的远程地址（packages.json 和 .zip 文件），不参与本地约束求解。
-
Resolving dependencies卡住：说明composer.json里写了太宽的版本约束（如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"），或启用了"minimum-stability": "dev"，求解器暴力穷举组合——这和网络无关，换镜像没用 -
Loading composer repositories卡住：大概率是 DNS 或 TLS 握手失败，此时镜像才起作用——必须确保配置的是完整 URL（含末尾/）且已清缓存 - 真正提速的标志是日志里出现大量
Downloading xxx.zip from https://mirrors.aliyun.com/composer/，而不是https://repo.packagist.org
配置镜像后仍慢的三大静默失效点
90% 的“换源没效果”不是网络问题，而是配置写错但 Composer 不报错。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 config -g repo.packagist为空或null - URL 缺少末尾
/：例如https://mirrors.aliyun.com/composer❌，会拼出/p2//类路径，返回 404，Composer 自动 fallback 到官方源 - 漏掉
-g参数：只改当前项目目录下的composer.json，换个项目就失效；验证时得用composer config -g repo.packagist，不是composer config repo.packagist
必须搭配的清理与验证动作
镜像配置写对只是第一步，缓存不清理、lock 文件不重生成，请求照样发往旧源。
- 执行
composer clear-cache（不是composer cache-clear，后者已废弃） - 删掉
vendor/和composer.lock，再跑composer install—— 旧lock文件记录的是官方源的哈希值，和镜像元数据不兼容 - 用
composer install -vvv滚动到日志末尾，确认出现https---mirrors-aliyun-com-composer字样，而非https---packagist-org
parallel-downloads 和 --prefer-dist 这些参数真有用吗
有用，但前提是镜像已生效且 Composer 版本 ≥ 2.2。
-
parallel-downloads默认是 3，基本等于串行；设为10才明显提速：composer config -g parallel-downloads 10 -
--prefer-dist强制走 ZIP 包，但会被项目级"prefer-source": true覆盖；检查方法：grep -n "prefer-source" composer.json - 私有包若没发布 dist 包，
--prefer-dist会直接报错Could not find a matching version，此时只能关掉该参数
最常被忽略的其实是 composer.lock 文件是否提交、是否与当前镜像元数据匹配——它不像配置命令那样“执行完就生效”，而是需要一次干净的重装才能真正落地。
