国内 composer 安装超时或 404 主因是官方源无 cdn 且带宽受限，必须用镜像；推荐脚本自动优选镜像，但需优先检查项目级 repositories、清理 vendor 和 composer.lock、执行 clear-cache，避免因源不一致导致安装失败。
Composer install 时超时或 404，先确认是不是源的问题
国内直接用官方源 https://packagist.org 经常卡在 Downloading https://packagist.org/packages.json 或报 Connection refused、cURL error 28: Operation timed out。这不是你网络差，是官方源对国内出口带宽限制严格，且无 CDN 加速。镜像不是“锦上添花”，而是刚需。
用 composer config 切换全局源，但别硬编码镜像地址
手动执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 能临时解决，但问题在于：阿里云镜像偶尔同步延迟（尤其新包发布后 10–30 分钟不可见），腾讯云、华为云、清华源响应速度和稳定性也各不相同。硬写死一个地址，等于把所有依赖绑在单点上。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 推荐做法：用脚本封装多个主流镜像，按 ping 延迟 + HTTP 状态码自动选最优
- 关键逻辑不是“测速”，而是先
curl -I -s -o /dev/null -w "%{http_code}" -m 3检查是否返回200，再 fallback 到ping -c 1 -W 2测通断 - 避免用
curl --head直接访问packages.json—— 部分镜像（如华为云）对未带User-Agent的请求返回403
脚本里必须处理 composer.json 本地配置优先级
全局配置 -g 会被项目级 composer.json 中的 repositories 覆盖。如果你在项目里写了：
"repositories": [
{"type": "composer", "url": "https://packagist.phpcomposer.com"}
]那脚本切全局源完全无效。所以动态切换脚本第一件事是检查当前目录是否存在 composer.json，并读取其中 repositories 字段 —— 如果有自定义源，直接跳过切换，打印提示而非强行覆盖。
- 用
jq -r '.repositories[]?.url // empty' composer.json 2>/dev/null | head -n1安全提取第一个源地址 - 如果输出非空，脚本应 停止执行 并输出类似：
Warning: project-level repositories found in composer.json, skip auto-switch - 不要尝试解析 JSON 后合并源 —— Composer 不支持多源 fallback，写多个会报
Repository has no type defined
别忽略 composer.lock 和 vendor 缓存的副作用
切完源立刻 composer install，可能遇到 Package x was not found in the repository。这是因为 composer.lock 里记录的是旧源的包哈希和 dist URL，而新镜像的 dist 地址结构可能不同（比如阿里云用 https://mirrors.aliyun.com/composer/dists/...，清华用 https://mirrors.tuna.tsinghua.edu.cn/composer/dists/...）。强行装会失败。
- 安全做法：切换源后，先删
vendor和composer.lock，再composer install - 或者保留
composer.lock，改用composer update --lock强制重写 lock 文件（但会升级 minor 版本，慎用） - 注意：
composer clear-cache必须执行，否则本地缓存的旧 dist zip 可能被复用，导致校验失败
