必须安装Volar（切Taken Over Mode）和Nuxt DevTools（需nuxi dev --devtools启用），并配置tsconfig.json/jsconfig.json的baseUrl与paths，否则Nuxt特有API类型提示失效、别名解析失败；调试须用pwa-node+ npx nuxi dev。
必须装 Volar 和 Nuxt DevTools 插件，其他都是锦上添花——没它们，definePageMeta、useAsyncData、~/components 全部标红，类型提示和跳转直接失效。
Volar 必须切到 Taken Over Mode
默认的 Strict Mode 下，Volar 会把 .vue 文件当纯 Vue 项目处理，Nuxt 特有 API 的类型推导全崩。比如 script setup 里写 definePageMeta，直接报“无法找到名称”，不是代码错，是模式没切对。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Volar: Switch to Taken Over Mode并执行 - 切换后 VSCode 会提示重启语言服务，务必确认 —— 不重启，旧缓存还在，标红照旧
- 别装
Vetur：它和 Volar 冲突，一装整个.vue文件的语法高亮和类型提示全挂
Nuxt DevTools 插件不是可选项，是语义解析开关
这个插件不只在右下角显示个图标，它负责激活 ~/ 别名解析、useRuntimeConfig 类型、服务端组件高亮、server/api/ 路由语义识别等核心能力。没它，VSCode 就当普通 Vue 项目跑，pages/index.vue 里写 definePageMeta 必然标红。
- 安装插件后，必须通过命令行显式启用：
nuxi dev --devtools，Nuxt 3.12+ 默认关闭 DevTools - 别指望在 VSCode「运行和调试」面板点绿色三角形启动就能触发 DevTools —— 它只响应 CLI 启动
- 确认
nuxt.config.ts没写devtools: false，哪怕不写，默认也是false
tsconfig.json 或 jsconfig.json 必须手动补 baseUrl 和 paths
VSCode 不自动继承 Nuxt 的别名规则。即使 ~/components/Hello.vue 运行时能加载，类型系统找不到映射，照样标红。路径别名提示失效，90% 是因为这个配置漏了或没生效。
- 在项目根目录的
tsconfig.json（TS 项目）或jsconfig.json（JS 项目）中，确保包含：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"~/*": ["src/*"],
"@/*": ["src/*"]
}
}
}
- 改完立刻按
Ctrl+Shift+P→TypeScript: Restart TS server，否则缓存未清，配置等于白写 - 如果项目根目录连
tsconfig.json或jsconfig.json都没有，VSCode 默认按纯 JS 处理，definePageMeta直接不识别
调试必须用 pwa-node + npx nuxi dev，不能用 node 类型
launch.json 里写 "type": "node" 是错的。Nuxt 3 启动的是 nuxi dev 进程，不是裸 Node.js，VSCode 默认 Node 调试器抓不到进程。
- 正确配置如下（放在
.vscode/launch.json中）：
{
"type": "pwa-node",
"request": "launch",
"name": "Nuxt Dev",
"runtimeExecutable": "npx",
"runtimeArgs": ["nuxi", "dev"],
"console": "integratedTerminal",
"internalConsoleOptions": "neverOpen"
}
-
runtimeExecutable必须是"npx"，不是"nuxi"—— VSCode 调试模式下不读全局 PATH，写"nuxi"直接报command not found - 服务端断点（如
server/api/hello.ts）只在浏览器发起真实 HTTP 请求时触发；客户端断点（如pages/index.vue）要在 hydration 完成后才生效，首次加载可能跳过
最易被忽略的是：所有配置生效的前提，是先运行过至少一次 nuxi dev。只有这时，.nuxt/tsconfig.json 和 .nuxt/components.d.ts 才会被生成，TS 语言服务才能真正接入 Nuxt 的类型体系。没这一步，插件再全、配置再准，也白搭。
