执行truffle unbox react命令失败，请求故障排查与解决

核心错误原因 #

报错信息里的getaddrinfo ENOTFOUND raw.githubusercontent.com是关键，说明你的本地设备无法解析raw.githubusercontent.com域名，导致Truffle无法从GitHub的这个托管地址下载React项目模板（box），最终触发下载失败。

常见触发场景 #

• 网络环境限制：部分地区网络无法直接访问GitHub相关域名
• DNS配置问题：本地DNS服务器无法正确解析该域名
• 防火墙/安全软件拦截：系统防火墙或第三方安全工具阻止了对该域名的访问

解决办法 #

1. 修改本地Hosts文件（Windows系统） #

• 找到C:\Windows\System32\drivers\etc\hosts文件，用管理员权限打开
• 添加以下内容（可通过查询raw.githubusercontent.com的真实IP更新，以下为常用示例）：

  185.199.108.133 raw.githubusercontent.com
  185.199.109.133 raw.githubusercontent.com
  185.199.110.133 raw.githubusercontent.com
  185.199.111.133 raw.githubusercontent.com
  

• 保存文件后，打开命令提示符执行ipconfig /flushdns刷新DNS缓存

2. 切换公共DNS服务器 #

在Windows网络设置中，将DNS服务器改为公共DNS，比如：

• 谷歌DNS：8.8.8.8 和 8.8.4.4
• 阿里云DNS：223.5.5.5 和 223.6.6.6

3. 检查防火墙与代理 #

• 暂时关闭系统防火墙或第三方安全软件，重试truffle unbox react命令
• 如果使用代理，确保代理配置正确，可正常访问GitHub域名

4. 手动下载模板替代 #

• 直接获取Truffle React Box的源码压缩包，解压到本地目标文件夹
• 执行npm install安装依赖，再通过truffle init初始化项目结构

内容的提问来源于stack exchange，提问作者Devansh Gupta