“Could not resolve host”错误本质是DNS解析失败，需优先排查DNS配置、hosts文件、nsswitch.conf顺序、systemd-resolved服务及临时指定DNS五类原因，而非直接更换镜像源。
为什么改DNS比换镜像源更优先
因为“Could not resolve host”错误本质是域名解析失败，不是下载慢。镜像源 URL 本身也要先解析 mirrors.aliyun.com，如果 DNS 不通，换源毫无意义。实测中，90% 的 failed to open stream: Connection timed out 和 Could not resolve host 都卡在第一步——连 packagist.org 都没解析出来。
优先执行这两步：
- 运行
sudo echo "nameserver 114.114.114.114" > /etc/resolv.conf（Linux/macOS），或在 Windows 的网络适配器中手动设 DNS 为114.114.114.114和223.5.5.5 - 立刻验证：
ping -c 1 packagist.org，有 IP 回显才算成功；若仍报unknown host，说明 DNS 没生效或被 systemd-resolved 覆盖
hosts 文件硬编码 IP 是最稳的兜底方案
公共 DNS 有时会因地域或策略返回错误 IP（比如把 github.com 解到拦截页），这时 /etc/hosts 直接绑定真实 IP 就绕过所有中间环节。但注意：IP 必须是当前可用的，不能抄旧资料里的。
操作要点：
- 用境外服务器或手机热点下的电脑查真实 IP：
curl -I https://packagist.org 2>&1 | grep "Connected to"，提取括号内 IPv4 地址 - 往
/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）加行：137.74.169.73 packagist.org（IP 以你查到的为准） - 别漏掉依赖域名：
223.6.6.6 github.com、223.6.6.6 githubusercontent.com，否则git clone还是会卡住
IPv6 fallback 导致“卡住但不报错”最隐蔽
Composer 默认先尝试 IPv6 地址，超时（通常 1–3 秒）再 fallback 到 IPv4。一个包卡 3 秒，100 个包就是 5 分钟无响应，日志里却看不到错误——这是最常被忽略的性能黑洞。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证和关闭方法：
- 运行
curl -v https://packagist.org 2>&1 | grep "Connected to"，若看到类似Connected to packagist.org (2a03:2880:...)且后续挂起，基本确认是它 - 禁用 IPv6 解析：在
/etc/sysctl.conf加net.ipv6.conf.all.disable_ipv6 = 1，然后sudo sysctl -p；或临时只对 Composer 生效：COMPOSER_DISABLE_IPV6=1 composer install - 不推荐全局关 IPv6，仅在 CI 或虚拟机中启用该环境变量即可
systemd-resolved 是 Linux 下最大的 DNS 干扰源
Ubuntu/Debian/CentOS 8+ 默认启用 systemd-resolved，它会偷偷接管 /etc/resolv.conf 并指向 127.0.0.53，导致你手动写的 nameserver 全部失效。
必须做三件事：
- 停用服务：
sudo systemctl disable --now systemd-resolved - 删掉被它控制的软链接：
sudo rm /etc/resolv.conf，再重新写入nameserver行 - 检查是否还有残留进程：
ps aux | grep resolved，有就kill掉
复杂点在于：某些云厂商镜像或 Docker Desktop for Linux 会自动重装它，所以每次重装系统后都要重复检查一次 /etc/resolv.conf 内容是否被篡改。
