必须配对镜像源、--prefer-dist --no-dev --optimize-autoloader三参数及清缓存，否则composer install仍卡在“loading composer repositories”；因默认直连packagist.org导致dns慢、tls失败、cdn绕行。
配对镜像源 + 三参数 + 清缓存，composer install 才能从卡顿半小时压到秒级完成；光换源不清理旧状态，大概率还是慢。
为什么 composer install 还在卡 “Loading composer repositories”
这不是你网络差，是 Composer 默认仍往 packagist.org 拉元数据——DNS 解析慢、TLS 握手失败、CDN 节点远，三者叠加导致首屏卡住。国内镜像必须同时覆盖元数据接口和 ZIP 包分发节点，缺一不可。
- 验证是否真走镜像：
composer config -g repo.packagist输出必须是完整 JSON 对象，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或报错 = 没生效 - 常见静默失效原因：
repos.packagist（多一个s）、漏写composer类型值、URL 少末尾/、用了http而非https - 项目根目录若已有
"repositories": {}，全局配置自动被屏蔽；此时得用项目级命令：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
composer install 生产部署必须加的三个参数
开发环境容忍慢，CI/CD 和上线部署不能靠运气。这三个参数不是“可选优化”，是避免重复下载、跳过冗余操作、提升运行时性能的硬性组合：
-
--prefer-dist：强制走 ZIP 包下载，跳过所有git clone、submodule同步，实测比 source 快 2–5 倍 -
--no-dev：生产环境根本不需要phpunit、laravel/pint等开发依赖，少下 20+ 个包 -
--optimize-autoloader：把 PSR-4 映射转成静态数组，autoload 阶段提速 30%+，且生成vendor/autoload.php更紧凑
完整命令示例：composer install --no-interaction --prefer-dist --no-dev --optimize-autoloader
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后第一次执行 composer install 报 hash 不匹配怎么办
不是镜像有问题，是旧 composer.lock 记录的是 packagist.org 的包哈希，和镜像返回的元数据不兼容——Composer 拒绝加载，属于预期行为。
- 直接删掉
vendor/和composer.lock - 再跑
composer install，让 Composer 重新从镜像拉取元数据、生成新 lock 文件 - 别试图保留旧 lock 文件或只删 vendor；二者必须一起清，否则仍会 fallback 到旧源校验
Docker/CI 中缓存挂载容易漏掉的关键点
只缓存 ~/.composer/cache 是不够的。Composer 安装结果还强依赖 composer.lock 内容、PHP 版本、platform 配置三者一致性。
- GitHub Actions 等 CI 场景中，必须同时缓存：
~/.composer/cache+vendor/（或至少vendor/autoload.php） - 基础镜像 PHP 版本微调（如 8.2.12 → 8.2.13），或
composer.json里"platform": {"php": "8.2"}改动，都会导致缓存失效 - 建议在 CI 脚本开头加
composer diagnose，确认Repo packagist.org:行显示的是你设的镜像地址，而不是https://packagist.org
最易被忽略的是：镜像源配置和缓存路径必须配对生效。只换源不配缓存，或只开缓存不换源，速度提升都有限——它们是同一枚硬币的两面，不是单点开关。
