You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React新手运行create-react-app出现npm ETIMEDOUT错误该如何解决

解决create-react-app创建项目ETIMEDOUT超时问题

该报错本质是npm请求官方镜像源时网络连接超时,国内用户多数是官方源访问不稳定导致,可按以下方案依次排查解决:

  • 方案1:临时使用国内镜像源执行创建命令
    执行以下命令直接创建项目,无需修改全局配置:
    npx create-react-app my-app --registry https://registry.npmmirror.com
    
  • 方案2:全局切换npm为国内镜像源
    后续所有npm相关操作都默认使用国内源,避免反复出现同类问题:
    1. 执行配置命令:
    npm config set registry https://registry.npmmirror.com
    
    1. 验证配置是否生效,执行后返回镜像地址即为配置成功:
    npm config get registry
    
    1. 配置完成后重新执行创建命令即可:
    npx create-react-app my-app
    
  • 方案3:代理环境配置排查
    如果你处于公司内网或使用代理工具,可先检查npm代理配置:
    1. 查看当前代理配置:
    npm config get proxy
    npm config get https-proxy
    
    1. 如果不需要使用代理,执行命令清除配置:
    npm config delete proxy
    npm config delete https-proxy
    
    1. 如果需要使用代理,替换为你本地的代理地址和端口后执行配置:
    npm config set proxy http://127.0.0.1:替换为你的代理端口
    npm config set https-proxy http://127.0.0.1:替换为你的代理端口
    
  • 其他排查操作
    • 清除npm缓存后重试:npm cache clean --force
    • 关闭本地防火墙、安全软件后重试,避免网络请求被拦截
    • 确认本地网络连接正常,可尝试切换手机热点后重试

内容的提问来源于stack exchange,提问作者user15415841

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.03 21:36:02