必须启用Volar的Taken Over Mode、tsconfig.json显式继承并声明types、launch.json配置pwa-node调试，三者缺一不可，否则definePageMeta标红、~/components跳转失败、服务端断点不触发。
装对插件、配对配置、用对调试方式，三者缺一不可——否则 definePageMeta 标红、~/components 跳转失败、服务端断点不触发，全是配置链断裂的表象。
必须启用 Volar 的 Taken Over Mode
Volar 默认是 Strict Mode，它只认标准 Vue 语法，对 Nuxt 特有 API（如 useAsyncData、definePageMeta、useRuntimeConfig）不做类型推导。script setup 里写这些函数会直接报错，不是代码问题，是模式没切。
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入并执行Volar: Switch to Taken Over Mode - 切换后必须关闭整个 VSCode 窗口，再重新打开项目文件夹——仅重启窗口或重载窗口不够，TS Server 不会重载
- 彻底禁用
Vetur：它和 Volar 冲突，会导致所有.vue文件的类型提示整体失效
tsconfig.json 或 jsconfig.json 必须显式声明别名与类型
VSCode 不自动继承 Nuxt 运行时生成的 .nuxt/tsconfig.json，也不默认识别 "nuxt" 类型包。没有这层配置，useServerSeoMeta 没提示、~/components/Hello.vue 跳转标红、甚至 definePageMeta 都不被识别为合法函数。
- TS 项目：确保根目录有
tsconfig.json，内容至少包含：{"extends":"./.nuxt/tsconfig.json","compilerOptions":{"types":["nuxt"]}} - JS 项目：用
jsconfig.json，且必须含：{"compilerOptions":{"baseUrl":".","paths":{"~/*":["src/*"],"@/*":["src/*"]}}} - 改完后立刻执行
Ctrl+Shift+P→TypeScript: Restart TS server，否则旧缓存还在，提示照旧失效
launch.json 调试必须用 pwa-node + npx nuxi dev
"type": "node" 是错的。Nuxt 3 启动的是 nuxi dev 进程，不是裸 Node.js；VSCode 默认 Node 调试器抓不到它，而且调试模式下不读全局 PATH。
立即学习“前端免费学习笔记（深入）”；
- 在
.vscode/launch.json中配置：{"type":"pwa-node","request":"launch","name":"Nuxt Dev","runtimeExecutable":"npx","runtimeArgs":["nuxi","dev"],"console":"integratedTerminal","internalConsoleOptions":"neverOpen"} -
runtimeExecutable必须是"npx"，不是"nuxi"—— 写成后者会直接报command not found - 服务端断点（如
server/api/hello.ts）只在浏览器发起真实 HTTP 请求时触发；客户端断点（如pages/index.vue）要在 hydration 完成后才生效，首次加载可能跳过
Nuxt DevTools 插件不能省
它不只是“右下角多一个图标”。它是激活 ~/ 别名解析、useServerSeoMeta 语义理解、服务端组件高亮、运行时日志等能力的核心载体。不装它，VSCode 就当普通 Vue 项目处理，pages/index.vue 里写 definePageMeta 会标红，useAsyncData 无类型提示，~/ 路径无法跳转。
- 安装官方
Nuxt DevTools插件，并确保在项目中启用（nuxi dev --devtools或配置nuxt.config.ts中的devtools: true） - 启用后右下角会出现 Nuxt 图标，点开能看到服务端日志、组件层级、运行时状态
- 别依赖“全局装了 nuxi”或“随便装个 Vue 插件”——Nuxt 的语义支持全靠插件与项目配置精准配合
最常被忽略的是三件事：Volar 模式没切、TS Server 没重启、调试用的是 node 类型而非 pwa-node。这三个点只要漏一个，整个开发体验就卡在“看着能跑，但编辑器不认”的状态里。
