Vite+TypeScript绝对导入报错TS2307问题求助

以下是针对「项目可运行、IDE能定位但TS报找不到模块」问题的排查和解决步骤：

• 核对tsconfig.json的paths与baseUrl配置
  确保paths的映射规则和baseUrl完全匹配，示例配置如下：

  {
    "compilerOptions": {
      "baseUrl": "./src",
      "paths": {
        "@/*": ["*"]
      },
      "include": ["src/**/*"] // 必须包含所有需要编译的文件
    }
  }
  

  若baseUrl设为项目根目录（比如"./"），paths要对应正确的相对路径，比如"@/src/*": ["src/*"]。同时检查是否有extends字段引入其他ts配置，导致当前配置被覆盖。

• 清除TypeScript缓存并重启TS服务

  • 删除项目根目录下的node_modules/.cache文件夹（Vite项目专属缓存目录）
  • 在VSCode中按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），选择「TypeScript: Restart TS Server」，强制刷新TS的类型检测缓存。

• 确保Vite alias与tsconfig配置完全一致
  检查vite.config.ts中的alias是否和tsconfig的paths对应，示例代码：

  import { defineConfig } from 'vite'
  import path from 'path'
  
  export default defineConfig({
    resolve: {
      alias: {
        '@': path.resolve(__dirname, './src') // 和tsconfig的baseUrl+paths匹配
      }
    }
  })
  

  若已使用vite-tsconfig-paths插件，可直接移除手动配置的alias，让插件自动读取tsconfig的paths，避免配置不一致。

• 安装@types/node依赖
  执行命令安装node类型声明包：

  npm install @types/node --save-dev
  

  部分场景下，TS无法识别路径相关API的类型，会间接导致绝对导入的类型检测异常。

• 排查多tsconfig.json冲突
  检查项目子目录是否存在其他tsconfig.json或tsconfig.*.json文件，这类文件可能会覆盖根目录的配置，导致TS读取的配置不符合预期。

• 验证tsconfig的include/exclude规则
  确保include字段包含所有需要进行类型检测的文件（业务代码、配置文件等）；exclude字段不要误排除需要导入的文件或目录。

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