如何解决Next.js项目创建时出现的ETIMEDOUT错误？

解决步骤 #

1. 切换国内npm镜像源

官方npm源在国内访问时常出现延迟或超时，切换到国内镜像可解决多数网络相关的安装问题：

npm config set registry https://registry.npmmirror.com/

设置完成后，重新运行项目创建命令：

npx create-next-app@latest .

2. 清理npm缓存

缓存文件损坏可能导致依赖拉取失败，执行以下命令强制清除缓存：

npm cache clean --force

清理后再次尝试创建项目。

3. 禁用IPv6连接

错误日志中显示的是IPv6地址（2606:4700::6810:822:443）连接超时，可临时禁用IPv6：

• 打开「网络和共享中心」，点击当前正在使用的网络连接
• 选择「属性」，找到「Internet协议版本6 (TCP/IPv6)」，取消勾选后点击「确定」，重启网络后重试

4. 跳过自动安装，手动安装依赖

如果上述方法无效，可先创建项目框架，再手动安装依赖：

1. 执行创建命令并跳过自动安装：

   npx create-next-app@latest . --no-install
   

2. 进入项目目录，手动执行安装：

   cd first-next-js-app
   npm install
   

内容的提问来源于stack exchange，提问作者Omar Afet