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

如何解决执行npm install后出现ETIMEDOUT报错的问题

npm install 报ETIMEDOUT跨项目报错解决方案

该报错本质为npm访问包源服务器超时,全项目都出现同类报错说明问题出在npm全局配置或本地网络环境,和单个项目无关,可按以下步骤排查修复:

  • 查看当前npm源配置,执行命令:
    npm config get registry
    默认官方源地址为https://registry.npmjs.org/,境外源在国内网络环境下很容易出现连接超时。
  • 更换为国内稳定镜像源,执行命令:
    npm config set registry https://registry.npmmirror.com/
  • 验证源配置是否生效,再次执行npm config get registry,确认输出为刚才设置的国内源地址即可。
  • 清除npm本地缓存避免异常残留,执行命令:
    npm cache clean --force
  • 回到项目目录重新执行npm install测试是否恢复正常。

若更换源后仍然报错,可继续排查以下情况:

  1. 检查npm是否配置了无效代理,执行npm config get proxy和npm config get https-proxy,如果有返回值说明存在代理配置,不需要代理的话执行npm config delete proxy、npm config delete https-proxy清除配置后重试。
  2. 检查本地防火墙、安全软件是否拦截了npm的网络请求,可临时关闭后测试。
  3. 若处于公司内网环境,确认是否需要使用公司专属的npm私有源,联系运维人员获取正确源地址后配置即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.15 15:15:01