如何使用unplugin-auto-import全局导入本地自定义类型？

排查与修复步骤 #

1. 确保auto-imports.d.ts被TypeScript识别 #

检查你的tsconfig.json，确认include数组包含该声明文件：

{
  "include": [
    "src/**/*",
    "auto-imports.d.ts" // 必须添加这一行，路径根据文件实际位置调整
  ]
}

2. 同步TypeScript与Vite的别名配置 #

@/typings的别名需要在两处同时配置：

• Vite配置（vite.config.ts）：

import { defineConfig } from 'vite'
import path from 'path'

export default defineConfig({
  resolve: {
    alias: {
      '@': path.resolve(__dirname, './src')
    }
  }
})

• TypeScript配置（tsconfig.json）：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}

3. 调整TypeScript模块解析策略 #

在tsconfig.json中设置适配Vite的模块解析方式：

{
  "compilerOptions": {
    "moduleResolution": "bundler"
  }
}

4. 重启服务清除缓存 #

• 重启VS Code的TypeScript服务（快捷键Ctrl+Shift+P，输入TypeScript: Restart TS Server）
• 重启Vite开发服务器，让新的声明文件生效

5. 兜底：手动引入声明文件 #

如果以上方法无效，可在src/vite-env.d.ts中手动添加引用：

/// <reference types="../auto-imports.d.ts" />

注意根据auto-imports.d.ts的实际位置调整路径。

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