Nuxt 3.10升级至3.15失败求助：版本显示异常

排查全局Nuxt CLI版本 #

• 先检查全局安装的nuxi或nuxt-cli版本，执行：

  npx nuxi --version
  npm list -g nuxt
  

  如果全局版本是3.10.1，会优先调用全局版本而非项目本地依赖。直接卸载全局版本：

  npm uninstall -g nuxt nuxi
  

  之后改用npx nuxt dev或npm run dev（确保package.json脚本调用本地依赖）执行命令。

检查package.json脚本配置 #

• 确认package.json里的dev、build脚本没有硬指定旧版本，正确配置应该是：

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

  这样会优先使用项目本地node_modules/.bin中的nuxt命令。

验证本地依赖的可执行路径 #

• 查看本地nuxt命令的版本：

  ./node_modules/.bin/nuxt --version
  

  如果显示3.15.2，说明本地依赖没问题，问题出在命令调用优先级。可以直接用本地路径执行命令，或者检查系统PATH环境变量，确保node_modules/.bin在全局路径之前。

清理残留缓存文件 #

• 除了npm缓存，还要删除Nuxt自身的缓存目录：

  rm -rf .nuxt .output node_modules/.cache
  npm install
  

确认nvm环境加载正确 #

• 检查当前终端使用的Node版本：

  node --version
  which node
  

  如果不是v20.12.2，执行nvm use 20.12.2切换，或者设置为默认版本nvm alias default 20.12.2。部分终端需要重启才能加载nvm环境变量。

清理其他包管理器锁文件 #

• 如果之前用过yarn或pnpm，删除残留的yarn.lock、pnpm-lock.yaml文件，再重新执行npm install。

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