composer install卡在downloading或报connection timed out,主因是国内直连packagist官方源网络不稳定;应全局切换至清华镜像源:composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/,并验证配置生效、清除缓存、确认dns与网络连通性。

为什么 composer install 总是卡在 Downloading... 或报 Connection timed out
国内直连 Packagist 官方源(https://packagist.org)经常因网络波动或 DNS 污染导致连接超时、下载极慢,甚至返回 503 Service Unavailable。清华源(https://packagist.phpcomposer.com 已停用,现为 https://packagist.proxy.tencent.com 或更推荐的 https://mirrors.tuna.tsinghua.edu.cn/composer/)是稳定且同步及时的镜像,切换后通常能从分钟级降到秒级完成 composer install。
全局切换到清华源(推荐,一劳永逸)
执行这条命令即可覆盖当前用户下的默认源:
composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
验证是否生效:
composer config -g repo.packagist
输出应为 https://mirrors.tuna.tsinghua.edu.cn/composer/。注意:-g 表示全局配置,写入的是 ~/.composer/config.json,对所有项目生效;无需每次进项目重复设置。
临时只对当前项目切源(适合 CI 或多源调试)
进到项目根目录后运行(不加 -g):
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
该配置会写入项目下的 composer.json 的 repositories 字段,生成类似:
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.tuna.tsinghua.edu.cn/composer/"
}
}
常见错误:
- 误写成
https://packagist.phpcomposer.com(已下线,必报404或cURL error 60) - 漏掉末尾斜杠
/,部分旧版 Composer 会静默失败 - 用了
http://而非https://,现代 Composer 默认拒绝非 HTTPS 源
切源后仍超时?检查这三件事
镜像本身没问题,但本地环境可能干扰:
- 公司代理或防火墙拦截了
mirrors.tuna.tsinghua.edu.cn:443—— 可用curl -I https://mirrors.tuna.tsinghua.edu.cn/composer/packages.json测试连通性 - Composer 版本太老(如
1.x),不兼容新版镜像返回格式;升级命令:composer self-update - DNS 解析异常,尝试手动加 hosts:
101.6.6.172 mirrors.tuna.tsinghua.edu.cn(以清华镜像站最新 IP 为准,可查ping mirrors.tuna.tsinghua.edu.cn)
清华源没有认证或 token 机制,也不需要额外配置 CA 证书,只要网络层通,基本不会出幺蛾子。










