优先更换DNS和使用国内镜像可解决Composer的"Could not resolve host"错误，常见原因为域名解析失败或网络限制，依次排查网络连接、DNS设置、代理配置及hosts文件绑定即可恢复。
当你在使用 Composer 安装或更新 PHP 包时，遇到 "Could not resolve host" 错误，通常是因为系统无法将包管理器请求的域名（如 repo.packagist.org 或 github.com）解析为 IP 地址。这属于网络层面的域名解析失败问题。下面介绍几种实用方法来排查和解决这个问题。
检查网络连接和 DNS 设置
确保你的设备可以正常访问互联网，并能解析外部域名。
- 运行
ping repo.packagist.org或ping github.com查看是否能通。 - 如果提示“未知的名称或服务”或“找不到主机”，说明 DNS 解析出问题。
- 尝试更换 DNS 服务器，例如改为 Google 的公共 DNS：
8.8.8.8 和 8.8.4.4。 - Linux 用户可编辑
/etc/resolv.conf添加： nameserver 8.8.8.8 - Windows 用户可在网络适配器设置中手动配置 DNS。
配置 Composer 使用国内镜像源
由于网络环境限制，直接访问国外源可能不稳定。切换为国内镜像可显著提升成功率。
- 使用中国镜像（如阿里云、Laravel China）： composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
- 该命令会全局设置 Packagist 镜像，避免连接原始海外地址。
- 完成后执行
composer clear-cache清除旧缓存再试。
检查代理和防火墙设置
如果你处于公司网络、校园网或使用代理工具，可能拦截了 Composer 请求。
- 确认是否设置了 HTTP/HTTPS 代理。
可通过echo $HTTP_PROXY和echo $HTTPS_PROXY查看。 - 若不需要代理，清除环境变量： unset HTTP_PROXY HTTPS_PROXY
- Composer 本身也支持代理配置：
composer config -g http-basic.github.com username token
或设置代理： composer config -g process-timeout 300
export HTTP_PROXY=http://localhost:8123（示例端口） - 防火墙或杀毒软件也可能阻止 CLI 工具联网，请临时关闭测试。
修改 hosts 文件绕过解析问题
某些情况下，特定域名解析缓慢或失败，可通过手动绑定 IP 解决。
- 获取目标域名的可用 IP，例如： nslookup github.com
- 编辑系统 hosts 文件：
- Windows 路径：
C:\Windows\System32\drivers\etc\hosts - Linux/macOS 路径：
/etc/hosts - 添加类似记录：
140.82.113.4 github.com
140.82.114.4 api.github.com - 保存后刷新 DNS 缓存（如 Windows 运行
ipconfig /flushdns）。
基本上就这些常见解决方式。优先尝试换 DNS 和使用国内镜像，大多数情况都能快速恢复。Composer 的网络问题多数源于本地环境而非服务端，耐心排查即可解决。
