直接换镜像源是最快见效的手段，不是“辅助选项”，而是解决国内Composer下载中断的首要动作；必须执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不可少），再运行composer clear-cache并用curl -I验证连通性，否则配置无效。
直接换镜像源是最快见效的手段，不是“辅助选项”，而是解决国内 Composer 下载中断的首要动作。所有其他调参、重试、清缓存操作，都应在镜像配置正确之后再考虑。
确认当前镜像是否生效且可用
很多人配了镜像却仍卡在 downloading，根本原因是配置未落地或镜像本身不可达。
- 运行
composer config -g repo.packagist，输出必须是完整 URL，例如https://mirrors.aliyun.com/composer/（注意末尾斜杠不能少） - 手动验证镜像连通性：
curl -I https://mirrors.aliyun.com/composer/，返回HTTP/2 200才算真正通；若超时、502 或 503，立刻换腾讯云镜像https://mirrors.cloud.tencent.com/composer/ - 私有包或 GitHub 仓库不受
repo.packagist控制，它们走的是repositories配置，需单独检查项目级composer.json中的repositories字段是否也指向了可用源
为什么阿里云/腾讯云镜像能绕过网络抖动
抖动不是网速慢，而是 DNS 解析卡顿、TLS 握手失败、运营商 NAT 超时这三类中间链路问题。官方源 packagist.org 在这些环节极易被截断，而国内镜像已针对这些做了优化：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- DNS 已预解析并绑定 CDN 节点，不依赖本地递归解析
- TLS 证书由国内 CA 签发，PHP cURL 不会因
curl.cainfo缺失或过期报错 - 镜像站默认关闭长连接复用，每个包下载都是独立短连接，中断后不拖累后续请求
- 元数据（
packages.json）与 ZIP 包同源托管，避免 Composer 查到 dist URL 后又回退到海外源下载 ZIP 的“二次跳转”
镜像配置后仍卡住的常见原因
不是镜像没用，而是某些场景它根本没被调用：
- 项目中存在
"type": "vcs"或"source"类型的依赖，Composer 会直连 GitHub/GitLab，完全绕过镜像 —— 此时需在repositories中为该仓库单独配dist地址或启用 archive 功能 -
composer.lock里记录的是旧版 commit hash，而镜像尚未同步该版本的 ZIP 包，Composer 自动 fallback 到source模式触发 git clone —— 可加--prefer-dist强制跳过 fallback - CI 环境中用了 Docker 构建，但镜像配置写在宿主机全局，容器内未继承 —— 应改用环境变量注入：
COMPOSER_REPO_PACKAGIST=composer=https://mirrors.aliyun.com/composer/ - PHP 运行时禁用了
allow_url_fopen或 cURL 不支持 HTTPS —— 运行php -r "print_r(curl_version());"看features是否含CURL_VERSION_SSL
搭配镜像使用的最小必要参数组合
单靠镜像还不够稳，尤其在 CI 或低带宽环境。以下三个参数配合使用，可覆盖 90% 的抖动失败场景：
-
--prefer-dist：强制走 ZIP 包，跳过 git clone 多环节连接，失败代价小、重试快 -
--no-plugins --no-scripts：插件（如旧版 prestissimo）和脚本可能引入额外网络调用或并发竞争，关掉后流程更线性 -
--timeout=600：临时延长单次命令总耗时，避免被 CI runner 的硬性 timeout 杀死（注意这不是http.timeout，后者控制单个 HTTP 请求）
复杂点在于：镜像只是把“不可控的海外链路”换成“可控的国内链路”，但它无法修复 vendor 目录残留破损、installed.json 截断或磁盘满导致的解压中断——这些必须靠 rm -rf vendor && composer clear-cache 手动清理，没有自动兜底。
