VSCode推拉GitHub代码出现Could not resolve host: github.com错误如何解决？

算力阿峰

2026-9-24

Git报错"Could not resolve host: github.com"解决方案

报错原文：fatal: unable to access 'https://github.com/<your-github-account>/<git-repo-name>/': Could not resolve host: github.com

该报错核心为域名解析失败，本地设备无法识别github.com对应的服务器IP，可按以下步骤逐一排查解决：

第一步：验证基础网络连通性
打开系统终端（Windows用cmd/管理员PowerShell，macOS/Linux用自带终端），执行ping github.com，查看是否有正常的响应包返回。如果完全丢包，先确认当前网络是否可以正常访问其他外网站点，基础网络故障先修复网络连接再重试。
第二步：刷新本地DNS缓存
若外网访问正常但ping github.com失败，先手动刷新本地DNS缓存：
- Windows：管理员权限PowerShell执行ipconfig /flushdns
- macOS：终端执行sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
- Linux（systemd发行版）：终端执行sudo systemd-resolve --flush-caches
  刷新完成后重试git推拉操作。
第三步：手动修改hosts文件绑定解析记录
刷新缓存后仍报错的话，手动修改系统hosts文件添加GitHub的固定解析规则：
1. 找到hosts文件路径：Windows为C:\Windows\System32\drivers\etc\hosts，macOS/Linux为/etc/hosts
2. 用管理员/root权限打开该文件，在末尾添加以下内容：
```
140.82.112.4 github.com
185.199.108.153 assets-cdn.github.com
185.199.109.153 assets-cdn.github.com
185.199.110.153 assets-cdn.github.com
185.199.111.153 assets-cdn.github.com
```
1. 保存文件后再次刷新DNS缓存，重试git操作。
第四步：检查git代理配置
若之前配置过git全局代理，先执行git config --global --get http.proxy查看当前代理设置，若代理已失效，执行git config --global --unset http.proxy移除代理配置后重试。
第五步：验证VSCode Git配置
打开VSCode设置页，搜索git.path，确认配置的git可执行文件路径正确，没有指向无效的二进制文件。