definePageMeta 中 layout: 'default' 不触发组件自动导入提示，因为其字符串值不被 TypeScript 语言服务解析为组件依赖，需依赖 nuxt/devtools 生成类型文件并正确配置 imports 模块及 tsconfig.json。

为什么 definePageMeta 里写 layout: 'default' 不触发组件自动导入提示

因为 Nuxt 3 的自动导入（Auto Imports）默认只处理 app.vue、pages/、components/ 下的显式使用，而 definePageMeta 是运行时元信息，VSCode 的 TypeScript 语言服务无法从中推导组件依赖。它不解析字符串字面量去查 layouts/default.vue 是否存在，更不会自动把它加进类型提示范围。

必须手动启用 nuxt/devtools 并配置 imports 模块

Nuxt 3 的自动导入能力由 @nuxt/imports 提供，但 VSCode 要识别它，需要两件事同时到位：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• nuxt.config.ts 中启用 imports 模块（默认已开，但建议显式确认）：

  export default defineNuxtConfig({
    imports: {
      autoImport: true,
      dirs: ['./composables', './utils']
    }
  })

• 安装并启用 nuxt/devtools —— 它会自动生成 .nuxt/tsconfig.json 和类型声明文件，让 TS 语言服务知道哪些全局组件/函数可被导入
• 确保项目根目录有 tsconfig.json，且包含 "types": ["@nuxt/schema"]（Nuxt 3.9+ 推荐用 "types": ["#app"]）

VSCode 必须重启 TS Server，且禁用 typescript.preferences.includePackageJsonAutoImports

即使配置正确，VSCode 仍可能因缓存或冲突行为不显示组件提示。关键操作如下：

• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Restart TS server 并执行
• 在 VSCode 设置中搜索 includePackageJsonAutoImports，设为 off —— 否则它会干扰 Nuxt 的路径别名解析，导致 ~/components/... 类型丢失
• 检查状态栏右下角是否显示 Using tsconfig.json from .../.nuxt/tsconfig.json；若显示项目根目录的 tsconfig.json，说明没走 Nuxt 生成的类型配置，需确认 nuxt dev 是否已运行过至少一次

全局组件名提示不出现？先看 components.d.ts 是否生成

Nuxt 在启动时会扫描 components/ 目录，生成 .nuxt/components.d.ts。如果这个文件为空或缺失，所有组件都不会进类型系统：

• 运行 nuxt dev 后立即检查 .nuxt/components.d.ts 是否存在、内容是否包含类似 declare module '#components' { ... }
• 若为空，确认 components/ 下的 Vue 文件名是 PascalCase（如 UiButton.vue），且没有 name 选项覆盖（Nuxt 3 自动推导名，写死 name: 'MyBtn' 反而会让类型注册失败）
• 遇到 Cannot find module '#components' 报错？说明 .nuxt/tsconfig.json 未被识别，尝试关闭 VSCode 再重开，或删掉 .nuxt/ 重新 nuxt dev

Nuxt 3 的自动导入提示不是“开个开关就成”，它依赖 nuxt dev 运行时生成的类型文件、VSCode 对 .nuxt/tsconfig.json 的实时读取，以及你没在 tsconfig.json 里误删 "types" 字段 —— 少一个环节，组件名就进不了智能提示。