composer换国内镜像源必须满足三条件：键名为repositories.packagist.org（非repo.packagist）、type显式为composer、url以https开头且末尾带/；项目级repositories字段会覆盖全局配置，需删除或改用正确键名；镜像仅加速元数据下载，zip包仍可能直连github，应配合--prefer-dist及清理缓存使用。
换国内镜像源能解决 80% 的 Composer 下载中断，但前提是配对、生效、且镜像本身可用——配错字段名、少个斜杠、或项目级配置覆盖全局，都会让镜像形同虚设。
镜像地址怎么配才真正生效
Composer 2.2+ 必须用 repositories.packagist.org 这个键名，不能写成 repos.packagist 或 mirror；类型必须显式声明为 composer，URL 末尾必须带 /。
- 正确命令：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 错误示例：
composer config -g repo.packagist https://mirrors.aliyun.com/composer（缺/、缺type、键名过时） - 验证是否真走镜像：
composer diagnose输出中找Repo packagist.org:这一行，后面域名必须是mirrors.aliyun.com等镜像域名 - 若
composer.json里有"repositories"字段，它会完全屏蔽全局镜像，得删掉或改用repositories.packagist.org替代
为什么换了镜像还是卡在 downloading
镜像只代理元数据（packages.json），ZIP 包下载仍可能直连 GitHub —— 尤其当包没发布 dist、或依赖类型是 vcs 时，Composer 会调用 git clone，绕过所有镜像逻辑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认包是否提供 dist：查
composer.lock里目标包的dist.url字段，如果是https://api.github.com/.../zipball/...，说明走的是 GitHub API，不受镜像控制 - 强制走 dist：加
--prefer-dist参数，跳过 git clone，只下 ZIP；但前提是包作者发布了 dist 版本 - 私有包或 Git 仓库依赖：必须单独配置
repositories，否则默认回退到官方源，卡在 TLS 握手或 DNS 超时 - 镜像站本身不可用：
curl -I https://mirrors.aliyun.com/composer/应返回HTTP/2 200；若超时或503，换腾讯云镜像https://mirrors.cloud.tencent.com/composer/
超时参数不调全等于白配镜像
http.timeout 控制 HTTP 请求总耗时（DNS + 连接 + 下载），process-timeout 控制 unzip、git clone 等子进程执行时间——两者独立，改错一个就失败。
- 国内环境推荐值：
composer config -g http.timeout 600、composer config -g process-timeout 1800 - 检查是否生效：
composer config -g http.timeout和composer config -g process-timeout必须都输出数字，不能为空 - 若输出为空，说明被项目级
composer.json中的"config": {"process-timeout": ...}覆盖，优先删掉该项目配置 - 启用重试（Composer 2.2+）：
composer config -g http.max-retries 3，避免单次抖动直接失败
中断后重试前先看 --dry-run 输出
别急着删 vendor——composer install --dry-run 能告诉你当前状态是否可信：大量 Skipped 表示已安装包完整，可直接重试；全是 Installing 或报错，则必须清理。
- 瞬时问题（DNS 超时、TLS 握手失败）：直接重跑
composer install即可 - ZIP 损坏报
Failed to extract：删vendor/+composer clear-cache -
installed.json截断报Invalid argument supplied for foreach()：删vendor/后自动重建 - 磁盘满或权限不足导致解压中断：残留破损目录，
rm -rf vendor是唯一可靠操作
真正容易被忽略的是缓存污染——~/.composer/cache/files/ 里存着半截 ZIP，不清掉，重试只会立刻复用并报校验失败。镜像再快，也救不了这个坑。
