Nuxt3 + TypeScript 报错：找不到模块‘#imports’及其类型声明

在基础组件中执行以下代码时，出现类型相关报错：

Cannot find module '#imports' or its corresponding type declarations

import { setPageLayout } from '#imports';

代码可正常运行，但TypeScript无法识别带#的导入，已按官方文档完成所有配置，求解决思路。

相关配置文件 #

tsconfig.json

{
  "compilerOptions": {
    "target": "ES2018",
    "module": "ESNext",
    "moduleResolution": "Node",
    "lib": [
      "ESNext",
      "ESNext.AsyncIterable",
      "DOM"
    ],
    "esModuleInterop": true,
    "allowJs": true,
    "sourceMap": true,
    "strict": true,
    "noEmit": true,
    "baseUrl": ".",
    "paths": {
      "~/*": [
        "./*"
      ],
      "@/*": [
        "./*"
      ]
    },
    "types": [
      "@nuxt/types",
      "@nuxt/typescript-build",
      "@types/node"
    ],
    "resolveJsonModule": true,
    "noImplicitAny": false
  },
  "exclude": [
    "node_modules"
  ],
  "extends": "./.nuxt/tsconfig.json"
}

nuxt.config.ts

import type { NuxtConfig } from '@nuxt/types';

const config: NuxtConfig = {
  buildModules: ['@nuxt/typescript-build'],
  vue: {
    config: {
      productionTip: false,
      devtools: true
    }
  }
};

export default config;

vue-shim.d.ts

declare module "*.vue" {
  import Vue from 'vue'
  export default Vue
}

解决思路 #

• 检查自动生成的配置文件
  #imports的类型映射是Nuxt自动在.nuxt/tsconfig.json中生成的，先确认该文件存在且包含#imports的相关配置。如果文件异常，删除.nuxt和node_modules目录，重新执行npm install和nuxt dev，让Nuxt重新生成配置。

• 调整tsconfig的继承顺序
  当前配置中extends: "./.nuxt/tsconfig.json"，确保自定义配置不会覆盖Nuxt生成的类型映射。可以尝试将自定义的paths等配置合并到Nuxt生成的配置中，或者确认extends是最后生效的配置项。

• 手动添加#imports类型声明
  如果自动生成的类型未生效，可在vue-shim.d.ts或新建的nuxt-imports.d.ts中手动声明：

  declare module '#imports' {
    export function setPageLayout(layout: string): void;
    // 根据实际使用情况添加其他导出类型
  }
  

• 核对依赖版本兼容性
  确认@nuxt/types、@nuxt/typescript-build与你的Nuxt主版本匹配，版本不兼容可能导致类型生成失败。

• 重启编辑器TS服务
  编辑器的TypeScript服务可能存在缓存，按下Ctrl+Shift+P（Windows）或Cmd+Shift+P（Mac），选择「TypeScript: Restart TS Server」，重新加载类型信息。

内容的提问来源于stack exchange，提问作者nullwriter