创建Nuxt3项目失败：无法从注册表下载模板

在Windows 11环境下，使用npx nuxi init nuxt-app创建Nuxt3项目时，出现以下问题：

(node:1752) ExperimentalWarning: The Fetch API is an experimental feature. This feature could change at any time
Failed to download template from registry: fetch failed

环境配置：Node.js 18.12.0，npm 8.12.1，且安装其他npm包无网络异常。

解决方案 #

1. 强制nuxi使用npm内置请求方式 #

由于报错源于nuxi的fetch实现和当前环境的适配问题，可通过环境变量强制切换为npm的请求逻辑：

• CMD环境：

  set NUXT_NPM_FETCH=true
  npx nuxi init nuxt-app
  

• PowerShell环境：

  $env:NUXT_NPM_FETCH=true
  npx nuxi init nuxt-app
  

2. 升级nuxi到最新版本 #

旧版nuxi对Node.js 18的Fetch API兼容不佳，先清除npx缓存再使用最新版：

npx clear-npx-cache
npx nuxi@latest init nuxt-app

3. 手动初始化项目（备选方案） #

如果上述方法无效，可手动搭建基础Nuxt3项目：

1. 创建并进入项目文件夹：

   mkdir nuxt-app && cd nuxt-app
   

2. 初始化npm项目：

   npm init -y
   

3. 安装Nuxt3核心依赖：

   npm install nuxt@latest
   

4. 创建基础入口文件app.vue：

   <template>
     <div>
       <h1>Hello Nuxt 3</h1>
     </div>
   </template>
   

5. 在package.json中添加运行脚本：

   "scripts": {
     "dev": "nuxt dev",
     "build": "nuxt build",
     "generate": "nuxt generate",
     "preview": "nuxt preview"
   }
   

完成后执行npm run dev即可启动项目。

原因说明 #

Node.js 18的Fetch API已趋于稳定，但旧版nuxi仍将其标记为实验特性，同时nuxi自带的fetch实现可能在Windows环境下存在网络适配问题（比如代理配置与npm不一致），而其他npm包正常安装说明网络本身无异常，切换请求方式或升级nuxi即可解决。

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