【Vite + Vue3 + TS】unplugin-auto-import自动引入配置及Eslint报错解决

最新推荐文章于 2025-03-27 15:51:58 发布

原创最新推荐文章于 2025-03-27 15:51:58 发布 · 1.3w 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#vue.js #javascript #typescript #eslint #auto-import

本文介绍了在Vue3和TypeScript项目中使用unplugin-auto-import插件自动导入Vue、VueRouter等函数的方法，包括安装插件、配置Vite、解决Eslint报错和更新tsconfig.json以避免“找不到名称”的错误。

前言：在Vue3和TypeScript项目中，Vue、VueRouter中的函数需要在每个页面导入，为提高开发效率，我们需要对此进行自动导入。

配置完成效果图如下所示：

在这里插入图片描述
可以看到页面并没有引入 onMounted reactive 等函数，亦可正常使用

接下来，我们将逐一配置

1.下载并引入插件`unplugin-auto-import`

$ npm install unplugin-auto-import -D

vite.config.ts

import AutoImport from "unplugin-auto-import/vite"; // 引入插件

export default defineConfig({
  plugins: [
    vue(),
    Components({
      resolvers: [VantResolver()],
    }),
    VueSetupExtend(),
    AutoImport({
      dts: "types/auto-imports.d.ts", // 这里是生成的global函数文件
      imports: ["vue", "vue-router"], // 需要自动导入的插件
      include: [
        /\.[tj]sx?$/, // .ts, .tsx, .js, .jsx
        /\.vue$/, /\.vue\?vue/, // .vue
        /\.md$/, // .md
      ],
      // 解决eslint报错问题
      eslintrc: {
      	// 这里先设置成true然后npm run dev 运行之后会生成 .eslintrc-auto-import.json 文件之后，在改为false
        enabled: false,
        filepath: './.eslintrc-auto-import.json', // 生成的文件路径
        globalsPropValue: true,
      }
    }),
  ]   
});

以下是AutoImport常用配置项

AutoImport({
  // 目标文件
  include: [
    /\.[tj]sx?$/, // .ts, .tsx, .js, .jsx
    /\.vue$/, /\.vue\?vue/, // .vue
    /\.md$/, // .md
  ],

  // 全局引入插件
  imports: [
    // presets
    'vue',
    'vue-router',
    // custom
    {
      '@vueuse/core': [
        // named imports
        'useMouse', // import { useMouse } from '@vueuse/core',
        // alias
        ['useFetch', 'useMyFetch'], // import { useFetch as useMyFetch } from '@vueuse/core',
      ],
      'axios': [
        // default imports
        ['default', 'axios'], // import { default as axios } from 'axios',
      ],
      '[package-name]': [
        '[import-names]',
        // alias
        ['[from]', '[alias]'],
      ],
    },
  ],

  // eslint报错解决
  eslintrc: {
    enabled: false, // Default `false`
    filepath: './.eslintrc-auto-import.json', // Default `./.eslintrc-auto-import.json`
    globalsPropValue: true, // Default `true`, (true | false | 'readonly' | 'readable' | 'writable' | 'writeable')
  },

  // 解析器，例如element-plus的ElementPlusResolver
  // see https://github.com/antfu/unplugin-auto-import/pull/23/
  resolvers: [
    /* ... */
  ],
  // 声明文件生成位置和文件名称
  dts: './auto-import.d.ts'
})

配置完成后删除导入函数，项目仍然可以正常运行，但多了下面的报错

在这里插入图片描述

可以看到，如果删除了import导入并且不配置Eslint函数就会报错“找不到名称”

2.解决 Eslint 报错

.eslintrc.js

extends: [
    'plugin:vue/vue3-essential',
    'eslint:recommended',
    '@vue/typescript/recommended',
    '@vue/prettier',
    '@vue/prettier/@typescript-eslint',
    './.eslintrc-auto-import.json', 在这里配置生成的JSON文件 需要和vite.config.ts文件保持一致
  ],

tsconfig.json

"include": [
    "src/**/*.js",
    "src/**/*.ts",
    "src/**/*.tsx",
    "src/**/*.jsx",
    "src/**/*.vue",
    "./types/auto-imports.d.ts" // 和 AutoImport dts保持一致 引入即可
  ],