遇到 "Could not resolve host" 错误时,通常是网络或 DNS 问题导致 Composer 无法解析域名;2. 先检查网络连接,尝试 ping packagist.org 确认是否通,不通则换网络环境测试;3. 更换 DNS 为 8.8.8.8 或 1.1.1.1 解决解析问题;4. 推荐配置国内镜像源如阿里云或 Laravel China 镜像加速访问;5. 检查并调整代理设置,必要时取消系统代理或在 Composer 中禁用。

遇到 "Could not resolve host" 错误时,说明 Composer 无法通过域名解析访问包服务器(如 packagist.org),通常是网络或 DNS 问题导致。下面是一些实用的排查和解决方法。
检查网络连接
确保你的设备能正常上网:
- 尝试在终端运行 ping packagist.org,看是否能收到响应。
- 如果 ping 不通,可能是本地网络受限或被防火墙拦截。
- 换一个网络环境测试(比如切换到手机热点),确认是否为当前网络问题。
更换 DNS 服务器
域名解析失败常因 DNS 配置不当引起:
- 临时改用公共 DNS,如 Google 的 8.8.8.8 或 Cloudflare 的 1.1.1.1。
- Linux/macOS:编辑 /etc/resolv.conf,添加 nameserver 8.8.8.8。
- Windows:在网络设置中手动设置 DNS 地址。
配置 Composer 使用国内镜像
国内用户常因网络延迟或屏蔽导致连接失败,建议使用镜像源:
- 设置阿里云镜像:
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ - 或使用 Laravel China 镜像:
composer config -g repos.packagist composer https://packagist.laravel-china.org - 完成后执行 composer install 重试。
检查代理设置
如果你在公司网络或使用代理:
- 确认是否需设置 HTTP/HTTPS 代理。
- 可临时取消代理:
unset http_proxy; unset https_proxy - 或在 Composer 中关闭系统代理:
composer config -g --unset http-proxy










