“could not resolve host”是系统dns解析失败，需先用nslookup或ping验证repo.packagist.org是否可解析，再排查dns配置、hosts绑定、镜像源拼写及代理干扰，换源前必须确保域名能被本机解析。
“Could not resolve host”不是 Composer 连不上，而是你的系统压根不认识 repo.packagist.org 这个名字——所有换源、清缓存、重装操作，在这一步之前全是白忙。
先确认是不是 DNS 彻底失灵
别急着改 composer.json 或配镜像。Composer 底层用系统 DNS 解析域名，如果连 nslookup repo.packagist.org 都返回 Unknown host，说明请求根本没发出去。
- 在终端运行
nslookup repo.packagist.org 8.8.8.8：能返回 IPv4 地址（比如104.21.46.17），说明本地 DNS 服务异常；返回空或超时，则可能是防火墙拦截或网络策略限制 -
ping 8.8.8.8能通但ping repo.packagist.org不通 → 基本锁定为 DNS 解析失败，不是网络不通 - Windows 用户注意 WSL 和宿主机 DNS 独立，得分别测试；macOS 可用
scutil --dns查当前生效的 DNS 列表
Hosts 文件硬绑定是最稳的应急手段
当 DNS 不稳定又无法改网络策略时，手动绑 IP 是见效最快的绕过方式，但格式和权限极易出错：
GitHub Hosts CN
下载
GitHub Hosts 更新工具（仅限中国用户），安全更新系统hosts文件，保留原有非GitHub条目，仅替换GitHub相关地址。支持备份恢复和风险提示。用于解决GitHub访问问题。
- 先用
nslookup repo.packagist.org 1.1.1.1查实时 IPv4 地址（Cloudflare DNS 更稳），记下结果，比如104.21.46.17 - Windows 编辑
C:\Windows\System32\drivers\etc\hosts，Linux/macOS 编辑/etc/hosts，追加一行：104.21.46.17 repo.packagist.org（IP 和域名之间只能是空格或 Tab，不能用中文符号） - 保存后必须刷新 DNS 缓存：
ipconfig /flushdns（Win）、sudo dscacheutil -flushcache（macOS）、sudo systemd-resolve --flush-caches（Linux systemd） - 某些杀毒软件（如火绒、360）会锁死
hosts文件，保存失败时右键编辑器选“以管理员身份运行”
换镜像源前必须确保域名可解析
很多人一看到报错就立刻执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但镜像地址也是域名，mirrors.aliyun.com 同样要被解析。DNS 不通，换源毫无意义。
- 阿里云地址：
https://mirrors.aliyun.com/composer/（末尾必须带/） - 腾讯云地址：
https://mirrors.cloud.tencent.com/composer/ - 华为云地址：
https://mirrors.huaweicloud.com/repository/php/composer/（路径含/repository/php/，不是/composer/） - 换完必须运行
composer clear-cache，否则仍可能拉旧元数据
代理和安全软件常被忽略
即使你没主动配代理，公司网络、终端历史命令、IDE 内置终端都可能残留 HTTP_PROXY 环境变量，导致 Composer 请求被转发到不存在的地址。
- 检查是否启用：
echo $HTTP_PROXY和echo $HTTPS_PROXY，有输出就说明在起作用 - 临时禁用：
unset HTTP_PROXY HTTPS_PROXY（Linux/macOS）或set HTTP_PROXY= && set HTTPS_PROXY=（Windows cmd） - 某些杀毒软件（如 360、火绒）会劫持 HTTPS 流量并自签证书，导致 OpenSSL 校验失败，表现也像连接被拒；可临时退出这类软件测试
真正卡住的地方往往不是 Composer 配置本身，而是 curl 底层调用时拿不到有效 TCP 连接——盯着 nslookup 和 curl -v 的输出比反复改 config 有用得多。Hosts 绑定 + 镜像源 + 清缓存三者缺一不可，但顺序不能乱：先让域名能解析，再换源，最后清缓存。
