换国内镜像源+执行composer clear-cache可解决90%的composer install慢问题；需运行composer config -g repo.packagist验证输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，且composer install -vvv日志中出现对应路径才真正生效。
composer install 变慢，不是网络差，是默认还在连 packagist.org —— 欧洲服务器，DNS 解析慢、TLS 握手卡、元数据拉取动辄 10 秒起。换国内镜像源+清缓存，90% 场景下从 2 分钟降到 3 秒内。
怎么确认当前用的到底是哪个镜像源
别信“我刚执行了命令”，得亲眼看到配置写进去了、且 Composer 正在用它：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（注意末尾斜杠 ✅）；空、null、或显示https://packagist.org，说明根本没生效 - 执行
composer install -vvv，最后几行出现类似Reading packages.json from cache at /home/xxx/.composer/cache/repo/https---mirrors-aliyun-com-composer/...才算真正走镜像 - 常见静默失败原因：
repos.packagist（多一个 s）、漏掉-g、URL 少斜杠、或 PHP 禁用了putenv()导致配置写不进文件
全局配置 vs 项目级配置，哪个更靠谱
全局配置（composer config -g）在单机开发够用，但 CI/CD、宝塔、多用户环境里极易失效——因为配置写进了 root 的 ~/.composer/config.json，而实际跑命令的是 www 或 runner 用户。
- 推荐进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会安全追加到composer.json的repositories字段，Git 提交后所有人行为一致 - 如果项目已有
"repositories": {}，命令能自动 merge；如果是"repositories": []，会报错，需先手动改成对象格式 - 别手写
"packagist.org": false—— 这会彻底关掉官方源，镜像临时不可用时，composer install直接失败
换源后为什么还是卡在 downloading 或 Resolving dependencies
镜像只加速下载和元数据拉取，不解决依赖解析卡顿。这两类问题常被混为一谈：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Downloading卡住 → 镜像没生效或没清缓存：必须执行composer clear-cache，否则 Composer 仍读本地缓存的海外元数据，根本不发请求 -
Resolving dependencies卡住 → 和镜像无关：典型原因是"php": "^7.4 || ^8.0 || ^8.1"这类宽泛约束，或"minimum-stability": "dev"导致候选版本爆炸；检查composer.json是否含已下线私有源，Composer 会逐个超时才 fallback - 某些包硬编码 GitHub URL（如
"dist": {"url": "https://github.com/xxx/yyy/archive/..."}），这类不会走镜像，撞上GithubRateLimit就报错
哪些参数组合能让 install 真正起飞
光换镜像是基础，生产部署必须叠加这组参数，否则浪费一半速度：
-
--prefer-dist：跳过git clone，直接下 ZIP 包；但前提是镜像已生效——国内镜像几乎不缓存source，只缓存dist，镜像没切成功时它会 fallback 到慢速 source -
--no-dev：跳过require-dev（PHPUnit、PHPStan 等），省掉 30–60% 时间 -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--classmap-authoritative（或-a）：仅限部署用，告诉 autoloader “没在映射里=真没有”，彻底跳过文件扫描；本地开发禁用，否则新增类直接Class not found - CI/CD 推荐完整命令：
composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress
最常被忽略的其实是缓存清理和 composer.lock 重生成——换源后旧 lock 文件里的哈希值和镜像元数据不匹配，删掉 vendor/ 和 composer.lock 再重装，才是最快路径。
