WebStorm 无法识别 nuxt 命令是因未继承 shell 环境变量，需手动配置 Node.js 路径并启用 PATH 自动配置；新项目必须用 npx nuxi@latest init；definePageMeta 报红需启用 Vue 插件、添加 "nuxt" 到 tsconfig.types 并重启 TS 服务。
WebStorm 识别不了 nuxt 命令？先确认 Node.js 和 npm 的路径
WebStorm 默认不自动继承系统终端的环境变量，尤其在 macOS 或 Linux 上用 zsh / fish / nvm 管理 Node 版本时，nuxt 命令很可能根本找不到。这不是项目问题，是 IDE 启动时没加载你的 shell 配置。
实操建议：
- 打开
WebStorm → Preferences → Languages & Frameworks → Node.js and NPM，手动指定Node interpreter路径（比如/Users/xxx/.nvm/versions/node/v18.18.2/bin/node） - 勾选
Automatically configure PATH for newly created terminal sessions（仅 WebStorm 2023.2+ 支持） - 如果仍报错
command not found: nuxt，别急着全局安装npx nuxt—— Nuxt 3 推荐本地运行，直接用npx nuxi dev更稳妥
新建 Nuxt 项目时，nuxi 和 create-nuxt-app 到底用哪个？
Nuxt 3 官方已弃用 create-nuxt-app，所有新项目必须用 nuxi（Nuxt CLI）。用错会导致依赖混乱、app.vue 结构不兼容、甚至热更新失效。
实操建议：
- 终端里执行：
npx nuxi@latest init my-nuxt-app（不要加-y，交互式选择更安全） - 初始化后，在 WebStorm 中用
File → Open…打开项目根目录，**不要**用File → New Project → Empty Project再手动导入 - 首次打开会提示 “Enable TypeScript language service” —— 如果项目含
tsconfig.json，务必点 Enable，否则useAsyncData等组合式 API 类型推导全失效
为什么 definePageMeta 报红、跳转不到页面、路由不生效？
这是 WebStorm 缺少 Nuxt 插件支持 + 项目未正确启用模块解析的典型表现，不是代码写错了。
实操建议：
- 检查
nuxt.config.ts是否有modules: ['@nuxtjs/tailwindcss']这类第三方模块 —— 若有，确保它们已安装且版本兼容 Nuxt 3.12+（旧版@nuxtjs/tailwindcss会破坏路由类型生成） - 在
tsconfig.json的compilerOptions.types中加入"nuxt"（不是"@nuxt/schema"） - 重启 WebStorm 的 TypeScript 服务：
Ctrl/Cmd + Shift + P → "Restart TypeScript Server" -
definePageMeta只能在.vue文件顶层使用，写在setup()里或script setup外部都会报错 —— 这是语法限制，不是 IDE 问题
调试 useAsyncData 时断点不触发？
WebStorm 默认调试的是浏览器端，但 useAsyncData 在服务端（SSR）或构建时（generate）可能提前执行，断点自然跳过。
实操建议：
- 启动开发服务器时加
--inspect参数：npx nuxi dev --inspect - 在 WebStorm 中配置 Node.js Remote Debug：端口填
9229（默认），Host 填localhost - 只对
server/目录下的 API 路由或plugins/中的 SSR 插件打远程断点；pages/里的useAsyncData在客户端执行时，用浏览器 DevTools 调试更直接 - 注意
ssr: false会禁用服务端数据获取，此时断点永远进不去服务端逻辑 —— 检查nuxt.config.ts的ssr配置项
最常被忽略的一点：WebStorm 的 Vue.js 插件必须启用（Preferences → Languages & Frameworks → JavaScript → Libraries → Vue.js），否则 definePageMeta、useHead 这些宏无法被正确识别为可调用函数，而不仅仅是“红色波浪线”。
