Nuxt 3执行npm run dev报错：找不到@nuxt/devtools模块

具体解决步骤 #

1. 手动安装@nuxt/devtools依赖 #

Nuxt 3.3.3并未默认内置devtools，或者安装过程中依赖损坏，直接执行对应包管理器的安装命令：

# 使用npm安装开发依赖
npm install -D @nuxt/devtools@latest
# 如果你用pnpm（从错误日志看你可能在用pnpm）
pnpm add -D @nuxt/devtools@latest

2. 清除缓存并重装所有依赖 #

缓存或损坏的依赖文件可能导致模块寻址失败：

• 删除本地依赖文件夹和锁文件：

# npm环境
rm -rf node_modules package-lock.json
# pnpm环境
rm -rf node_modules pnpm-lock.yaml

• 重新安装依赖：

npm install
# 或pnpm install

3. 检查并修正nuxt.config.ts配置 #

确保配置文件中devtools的设置正确，避免错误的路径引用：

export default defineNuxtConfig({
  devtools: { enabled: true } // 开启devtools，确保依赖已安装；如果不需要可以设为false跳过加载
})

4. 排查全局Node模块干扰 #

错误日志显示系统试图从全局Node路径加载模块，这可能是全局安装的包导致的冲突：

• 卸载全局的@nuxt/devtools：

npm uninstall -g @nuxt/devtools

• 确保项目没有强制从全局路径加载模块的配置或环境变量

5. 切换到稳定版Node.js #

Node 19属于非稳定的奇数版本，存在兼容性风险，建议切换到Node 18 LTS版本：

# 用nvm版本管理器切换（需先安装nvm）
nvm install 18
nvm use 18

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