必须在tsconfig.json或jsconfig.json中显式配置baseUrl和paths映射（如{"~/*": ["src/*"]}），并重启TS Server；否则VSCode不识别~/别名，导致Ctrl+Click跳转失效。
为什么Ctrl+Click跳不到~/components？
不是路径写错了，是 VSCode 根本没把 ~/ 当成有效别名。它不读 Nuxt 运行时生成的路径映射，只认你手动写的 tsconfig.json 或 jsconfig.json。
必须在项目根目录配置文件中显式声明：
-
baseUrl设为"." -
paths包含{"~/*": ["src/*"], "@/*": ["src/*"]} - 改完后立刻执行
Ctrl+Shift+P→TypeScript: Restart TS server，否则缓存还在，跳转照旧失效
JS 项目用 jsconfig.json，TS 项目用 tsconfig.json；如果连这个文件都没有，VSCode 就当纯 JS 处理，definePageMeta 直接不识别。
F5 启动调试却断点不触发？
type: "node" 是错的。Nuxt 3 启动的是 nuxi dev 进程，不是裸 Node.js，VSCode 默认调试器抓不到它。
正确做法是用 pwa-node 类型，并通过 npx 调用：
-
runtimeExecutable必须是"npx"，不是"nuxi"（调试模式下不读全局 PATH） -
runtimeArgs写成["nuxi", "dev"] - 服务端断点（如
server/api/hello.ts）要等浏览器真实发起 HTTP 请求才触发 - 客户端断点（如
pages/index.vue）在 hydration 完成后才生效，首次加载可能跳过
Ctrl+Space 补全不出 useAsyncData？
不是插件没装，是 Volar 没切对模式。默认 Strict Mode 只认标准 Vue 语法，对 Nuxt 特有 API 做不出类型推导。
必须手动切换：
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），执行Volar: Switch to Taken Over Mode - 切换后必须关闭整个 VSCode 窗口，再重新打开项目文件夹——仅重载窗口不够，TS Server 不会重载
- 同时确保
tsconfig.json的compilerOptions.types包含"nuxt"，否则useRuntimeConfig这类函数也没提示
顺带一提：Vetur 必须彻底禁用，它和 Volar 冲突，会导致所有 .vue 文件类型提示整体失效。
Ctrl+S 不自动格式化 Tailwind 类名？
Tailwind IntelliSense 插件默认只读取根目录下的 tailwind.config.js 或 tailwind.config.cjs。如果配置文件在子目录、或用了 tailwind.config.ts，它就找不到。
补全失效常见原因：
- 确认
tailwind.config.js在项目根目录（不是src/或config/下） - VSCode 设置里启用
editor.formatOnSave，但还要配对语言映射："[vue]": {"editor.defaultFormatter":"esbenp.prettier-vscode"} - 若用了
eslint.config.mjs，确保它启用了plugin:prettier/recommended，否则保存时 ESLint 不触发修复
别名跳转、类型补全、断点调试、格式化这四件事看着独立，其实共享同一套底层配置链：插件模式 + tsconfig/jsconfig + launch.json。任一环节断开，表象就是某个功能“突然不好使”。
