npm

npm install ETIMEDOUT 连接超时

报错原文

npm ERR! network request to https://registry.npmjs.org/xxx failed, reason: connect ETIMEDOUT

出现场景

不挂代理直接执行 npm install 时长时间无响应最终超时, 换网络(如热点)有时能通有时依然超时。

可能原因(按概率)

1. registry.npmjs.org 在国内访问延迟高、丢包严重, 非完全屏蔽但体验极差
2. 本地网络对该域名的部分 CDN 节点路由异常

修复步骤(从最简单的开始)

1. 切换国内镜像源: npm config set registry https://registry.npmmirror.com/
2. 确认已生效: npm config get registry
3. 单次安装不改全局配置: npm install --registry=https://registry.npmmirror.com/
4. bun 用户对应配置 bunfig.toml 里的 [install] registry = "https://registry.npmmirror.com/"
5. 某个包在镜像上还没同步完成导致的偶发失败, 稍等几分钟重试或先用官方源装这一个包