全新安装Nuxt 3.9.3出现Vite依赖警告，DevTools无法使用

在macOS系统上全新安装Nuxt 3.9.3应用时，出现以下依赖警告，且DevTools无法正常使用，安装过程日志如下：

Projects % npx nuxi init nuxt-3

✔ Which package manager would you like to use?
yarn
◐ Installing dependencies...                                                                                                                             7:54:54 PM
yarn install v1.22.21
info No lockfile found.
[1/4] 🔍  Resolving packages...
[2/4] 🚚  Fetching packages...
warning vscode-languageclient@7.0.0: The engine "vscode" appears to be invalid.
[3/4] 🔗  Linking dependencies...
warning "nuxt > @nuxt/devtools@1.0.8" has unmet peer dependency "vite@*".
warning "nuxt > @nuxt/devtools > vite-plugin-vue-inspector@4.0.2" has unmet peer dependency "vite@^3.0.0-0 || ^4.0.0-0 || ^5.0.0-0".
warning "nuxt > @nuxt/devtools > vite-plugin-inspect@0.8.3" has unmet peer dependency "vite@^3.1.0 || ^4.0.0 || ^5.0.0-0".
warning "nuxt > @nuxt/devtools > @nuxt/devtools-kit@1.0.8" has unmet peer dependency "vite@*".
[4/4] 🔨  Building fresh packages...
success Saved lockfile.
$ nuxt prepare
✔ Types generated in .nuxt                                                                                                                              7:55:39 PM
✨  Done in 44.58s.
✔ Installation completed.                                                                                                                               7:55:39 PM

问题分析 #

• vscode-languageclient的引擎警告属于包自身声明问题，不影响项目核心功能，可直接忽略。
• 核心问题是**@nuxt/devtools相关组件缺失vite依赖**：Nuxt 3虽内置vite，但yarn 1.x无法识别内置的peer依赖，导致DevTools因依赖不完整无法正常启动。

解决步骤 #

1. 进入项目目录：

   cd nuxt-3
   

2. 手动安装vite开发依赖：

   yarn add vite --dev
   

3. 重新启动开发服务：

   yarn dev
   

4. 若问题仍存在，清理缓存后重新安装依赖：

   rm -rf node_modules yarn.lock
   yarn install
   yarn dev
   

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