webstorm 识别不了 nuxt 命令需手动指定 node.js 路径并取消自动管理核心库；definenuxtconfig 报红要确保 tsconfig.json 含 "nuxt" 类型且首行加三斜线引用；调试须用 nuxt.mjs 启动而非单文件运行。

WebStorm 识别不了 nuxt 命令？手动指定 Node.js 路径是硬性前提

WebStorm 启动时不继承 shell（如 zsh、nvm）的环境变量，nuxt 命令在终端能跑，IDE 里却报 command not found: nuxt 是最常见现象。这不是项目问题，而是 IDE 没找到可执行的 nuxt 入口。

• 打开 Settings > Languages & Frameworks > Node.js and NPM
• 把 Node interpreter 改成你项目实际使用的路径，例如：/Users/xxx/.nvm/versions/node/v20.12.0/bin/node 或 C:\Program Files\nodejs\node.exe
• 务必取消勾选 Manage Node.js core libraries automatically——它会注入过时的 @nuxt/core 类型定义，和你装的 nuxt@3.12.4 冲突
• 改完重启 WebStorm，再右键 nuxt.config.ts → Reload project

defineNuxtConfig 和 definePageMeta 报红？类型入口没接上

WebStorm 不像 VS Code 那样自动推导 Nuxt 的全局类型，Cannot find name 'defineNuxtConfig' 本质是 TypeScript 服务没加载 Nuxt 类型包。

• 确认项目根目录有 tsconfig.json，且 compilerOptions.types 包含 "nuxt"（不是 "@nuxt/schema"，也不是空数组）
• 在 nuxt.config.ts 文件**最顶部第一行**加：/// <reference types="nuxt"></reference>（前面不能有任何空行或注释）
• definePageMeta 只能在 <script setup></script> 顶层使用，写在 setup() 函数内或 <script></script> 外部都会语法报错

调试 useAsyncData 或服务端钩子，断点不触发？运行模式不对

WebStorm 默认以普通 Node.js 脚本方式 Debug 单个文件，但 useAsyncData、serverMiddleware、runtimeConfig 初始化等只在完整 Nuxt 生命周期（nuxt dev 启动后）中才执行。

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• 不要右键 pages/index.vue → Debug
• 用 Run > Edit Configurations > + > Node.js 新建配置：
• Working directory 设为项目根目录
• Javascript file 填：node_modules/nuxt/bin/nuxt.mjs（注意是 .mjs，不是 .cjs）
• Application parameters 填：dev
• 确保 package.json 中已设 "type": "module"，否则 WebStorm 会用 CommonJS 模式加载

新建项目别用 create-nuxt-app，必须用 nuxi

create-nuxt-app 已被官方弃用，用它建的项目大概率出现路由不生成、app.vue 结构错位、热更新失效等问题，且无法通过简单升级修复。

• 终端执行：npx nuxi@latest init my-nuxt-app（不加 -y，交互式选择更安全）
• 在 WebStorm 中用 File → Open… 打开项目根目录，不要用 File → New Project → Empty Project 再手动导入
• 首次打开提示 “Enable TypeScript language service” 时，务必点 Enable——否则 useAsyncData 等组合式 API 类型推导全失效

SSR 调试真正生效的前提，是整个生命周期由 nuxt.mjs 启动，而不是模拟单文件执行；类型报错背后往往是 tsconfig.json 缺少 "nuxt" 或三斜线注释位置错了一行——这些细节不修正，后续所有提示和跳转都会失灵。