必须启用volar的taken over mode、tsconfig.json显式继承并声明types、launch.json配置pwa-node调试，三者缺一不可，否则nuxt特有api类型推导失败、别名跳转失效、服务端断点不触发。
装对插件、配对 tsconfig.json、用对调试类型，三者缺一不可——否则 definePageMeta 标红、~/components 跳转失败、服务端断点不触发，全是配置链断裂的表象。
必须启用 Volar 的 Taken Over Mode
Volar 默认的 Strict Mode 下，Nuxt 特有 API（如 useAsyncData、definePageMeta）无法被正确推导类型，<script setup></script> 里直接报错。这不是插件没装，而是模式没切。
- 按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），输入并执行Volar: Switch to Taken Over Mode - 切换后需关闭并重新打开整个文件夹（不是仅重启窗口），否则 TS 类型服务不会重载
- 彻底禁用
Vetur：它与 Volar 冲突，会导致所有.vue文件的类型提示整体失效
tsconfig.json 必须显式继承并声明 types
VSCode 不自动读取 Nuxt 运行时生成的 .nuxt/tsconfig.json，也不默认识别 "nuxt" 类型包。没有这层声明，useRuntimeConfig、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
"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 请求时触发，纯客户端导航（<nuxtlink></nuxtlink>）不会重新执行 SSR 逻辑
Nuxt DevTools 插件不能省
它不只是“右下角多一个图标”，而是负责激活 ~/ 别名解析、useServerSeoMeta 语义理解、服务端组件高亮、运行时日志等核心能力。不装它，VSCode 就当普通 Vue 项目处理。
- 安装官方插件：
Nuxt DevTools（作者：Nuxt Labs） - 启动开发服务器时需加
--devtools参数：npx nuxi dev --devtools，否则插件功能不激活 - 首次运行后，检查右下角是否出现 Nuxt 图标；点击可查看服务端日志、组件层级、运行时配置
最容易被忽略的是：所有配置修改后都依赖 VSCode 的 TypeScript Server 重载，而它不会自动感知 tsconfig.json 或插件模式变更——手动重启 TS Server 和重新打开文件夹，不是“可选步骤”，是生效前提。
