从头创建Nuxt项目启动失败：Cannot read properties of undefined (reading 'some')

问题信息 #

环境配置 #

• Node.js v22.14.0
• npm 11.2.0
• 项目依赖配置（package.json）：

{
  "name": "nuxt-app",
  "private": true,
  "type": "module",
  "scripts": {
    "build": "nuxt build",
    "dev": "nuxt dev",
    "generate": "nuxt generate",
    "preview": "nuxt preview",
    "postinstall": "nuxt prepare"
  },
  "dependencies": {
    "nuxt": "^3.16.0",
    "vue": "^3.5.13",
    "vue-router": "^4.5.0"
  }
}

报错内容 #

ERROR Cannot start nuxt: Cannot read properties of undefined (reading 'some') nuxi 13:10:24

at /C:/Users/sergi/Documents/Nuxt3/Tutorials/udemy-tutorial/udemy-tutorial/node_modules/nuxt/dist/shared/nuxt.B7-cu52A.mjs:3776:21
at /C:/Users/sergi/Documents/Nuxt3/Tutorials/udemy-tutorial/udemy-tutorial/node_modules/hookable/dist/index.mjs:48:66
at /C:/Users/sergi/Documents/Nuxt3/Tutorials/udemy-tutorial/udemy-tutorial/node_modules/hookable/dist/index.mjs:48:56
at async generateApp (/C:/Users/sergi/node_modules/.pnpm/nuxt3@3.0.1-rc.0-27898092.1e8da22/node_modules/nuxt3/dist/index.mjs:2225:3)
at async _applyPromised (/C:/Users/sergi/node_modules/.pnpm/perfect-debounce@0.1.3/node_modules/perfect-debounce/dist/index.mjs:54:10)

解决方案 #

1. 清理依赖冲突与缓存 #

报错栈中出现了旧版本nuxt3@3.0.1-rc.0的路径，与package.json声明的nuxt@3.16.0存在冲突，执行以下操作：

• 删除项目根目录下的node_modules文件夹
• 删除package-lock.json文件
• 重新安装依赖：

  npm install
  

2. 调整Node.js版本 #

Nuxt 3.16.0推荐使用Node.js 18.x/20.x LTS版本，Node 22属于当前版本可能存在适配问题：

• 使用nvm/nvs等版本管理工具切换到Node 18或20版本
• 重新执行npm install和npm run dev

3. 移除不必要的手动依赖 #

Nuxt会自动管理vue和vue-router的版本，手动添加可能导致兼容性问题：

• 修改package.json，移除vue和vue-router依赖项，保留如下配置：

  {
    "name": "nuxt-app",
    "private": true,
    "type": "module",
    "scripts": {
      "build": "nuxt build",
      "dev": "nuxt dev",
      "generate": "nuxt generate",
      "preview": "nuxt preview",
      "postinstall": "nuxt prepare"
    },
    "dependencies": {
      "nuxt": "^3.16.0"
    }
  }
  

• 重新安装依赖后启动项目

4. 手动执行Nuxt准备命令 #

确保postinstall钩子正确执行，手动运行：

npm run postinstall

再启动开发服务器：

npm run dev

内容的提问来源于stack exchange，提问作者Sérgio Correia