vite-tsconfig-paths解析路径正常但Vite找不到已存在文件的问题

• 核对tsconfig.json的配置细节
  确保compilerOptions里的baseUrl和paths配置完全匹配实际文件结构：

  {
    "compilerOptions": {
      "baseUrl": "./",
      "paths": {
        "@common/*": ["src/common/*"] // 此处路径要和你真实的文件目录一一对应
      }
    }
  }
  

  比如你导入@common/AssetLoader，对应的真实文件必须在src/common/AssetLoader.ts（或.vue等对应扩展名）位置。

• 调整插件加载顺序
  把tsconfigPaths插件移到vue插件前面，避免后续插件覆盖路径解析结果：

  export default defineConfig({ 
     plugins: [
        tsconfigPaths(),
        vue()
     ]
  })
  

• 清除Vite缓存
  删除项目根目录下的node_modules/.vite文件夹，然后重启开发服务，缓存残留可能导致解析异常。

• 检查文件扩展名与模块解析配置
  确认导入语句的扩展名是否正确，或者在tsconfig.json的compilerOptions里设置moduleResolution: "NodeNext"（或Node16），确保TypeScript和Vite的模块解析逻辑一致。

• 指定tsconfig文件路径（如果不在根目录）
  如果你的tsconfig.json不是放在项目根目录，需要显式指定路径：

  tsconfigPaths({ tsconfigPath: './config/tsconfig.json' })
  

• 验证TypeScript语法检查
  执行tsc --noEmit命令，检查是否有类型或路径相关的错误，TypeScript本身的配置问题也可能导致Vite无法正确识别路径。

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