必须启用Volar的Taken Over Mode、tsconfig.json显式继承并声明types、launch.json配置pwa-node调试，三者缺一不可，否则definePageMeta标红、~/components跳转失败、服务端断点不触发。
VSCode 写 Nuxt3 项目不是装几个插件就能开干的——缺了关键配置，definePageMeta 标红、~/components 跳转失败、服务端断点完全不触发，全是表象，根子在三处配置没对齐。
必须切 Volar 的 Taken Over Mode，Strict Mode 下类型直接崩
Volar 默认启动是 Strict Mode，它只认标准 Vue 语法，对 useAsyncData、definePageMeta、useRuntimeConfig 这类 Nuxt 特有 API 完全无感。这不是插件没装，是模式错了。
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入并执行Volar: Switch to Taken Over Mode - 切换后必须关闭整个文件夹，再重新打开——仅重启窗口不会重载 TS 类型服务
- 彻底禁用
Vetur：它和 Volar 冲突，一开就导致所有.vue文件的类型提示整体失效
tsconfig.json 必须显式继承 + 声明 types，否则别名和 API 都没提示
VSCode 不自动读取 .nuxt/tsconfig.json，也不默认识别 "nuxt" 类型包。没这层声明，useServerSeoMeta 就是普通函数，~/ 别名跳转直接报“无法找到模块”。
- 确保项目根目录有
tsconfig.json，内容至少含：{"extends":"./.nuxt/tsconfig.json","compilerOptions": {"types": ["nuxt"]}} - 如果是 JS 项目，则用
jsconfig.json，且必须含"baseUrl": "."和"paths"映射（如"~/*": ["src/*"]） - 改完立刻执行
Ctrl+Shift+P→TypeScript: Restart TS server，否则缓存残留，提示照旧失效
launch.json 调试必须用 pwa-node + npx nuxi dev，node 类型无效
"type": "node" 是错的。Nuxt 3 启动的是 nuxi dev 进程，不是裸 Node.js；VSCode 默认 Node 调试器抓不到它，且调试模式下不读全局 PATH。
- 正确配置：
{"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 请求时触发，纯客户端导航（<NuxtLink>）不会重新执行 SSR 逻辑
Nuxt DevTools 插件不能省，它才是语义激活开关
它不只是右下角多一个图标。不装它，~/ 别名解析、useServerSeoMeta 的语义理解、服务端组件生命周期钩子，VSCode 全当普通 Vue 处理。
- 必须安装官方
Nuxt DevTools插件，并确保nuxi dev --devtools启动（或在nuxt.config.ts中设devtools: true） - 它负责把
pages/、server/、composables/这些目录的特殊语义注入 VSCode 的语言服务 - 没有它，
definePageMeta在pages/index.vue里标红，不是你写错了，是 VSCode 根本不认识这个 API
最常被忽略的一点：所有配置都依赖 nuxi prepare 生成的 .nuxt/tsconfig.json。首次打开项目或修改 nuxt.config.ts 后，务必先运行一次该命令，否则 extends 路径会 404，整个类型链就断了。
