unplugin-auto-import 和 unplugin-vue-components 的正确使用方式
在整合element-plus的时候,自动导入模块与引用到这两个插件的简单介绍,详情见官网:unplugin-vue-components和unplugin-auto-import
- 安装
npm install -D unplugin-vue-components unplugin-auto-import
结合官方文档,在详细说一下具体的使用心得(以vite为例)
vite
// vite.config.ts
import { defineConfig } from 'vite'
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite'
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'export default defineConfig({// ...
plugins: [vue(),AutoImport({// 自动导入 Vue 相关函数,如:ref, reactive, toRef 等imports: ['vue', 'vue-router', 'vue-i18n'],include: [/\\.[tj]sx?$/,/\\.vue$/,/\\.vue\\?vue/,],resolvers: [// 自动导入 Element Plus 相关函数,如:ElMessage, ElMessageBox... (带样式)ElementPlusResolver(),// 自动导入图标组件IconsResolver({})],vueTemplate: true, // 是否在 vue 模板中自动导入dts: path.resolve(pathSrc, 'types', 'auto-imports.d.ts') // (false) 配置文件生成位置,默认是根目录 /auto-imports.d.ts}),Components({include: [/\\.[tj]sx?$/,/\\.vue$/,/\\.vue\\?vue/,],// 只要项目中,在components目录下的文件,会自动导入到components.d.ts中,这样,页面或者组件中就不用再次引入了,也无需在`main.js`通过app.component全局注册了dirs: ['src/components', 'src/**/components',],extensions: ['vue', 'jsx', 'tsx', 'ts', 'js'],resolvers: [// 自动注册图标组件IconsResolver({enabledCollections: ['ep'] //@iconify-json/ep 是 Element Plus 的图标库}),// 自动导入 Element Plus 组件ElementPlusResolver()],dts: path.resolve(pathSrc, 'types', 'components.d.ts') // (false) 配置文件生成位置,默认是根目录 /components.d.ts}),
})
然后项目启动之后,就会在types目录下生成两个文件
效果
<script lang="ts" setup>
// 当前行也可以省略不写
import { getCurrentInstance, ref } from 'vue'
// 无需再次引入,可以省略当前行代码
const {proxy} = getCurrentInstance()import PasswordForm from './components/passwordForm.vue'
....
效果如图
但是这里面会有eslint的提示,官方这么解释的
💡 When using TypeScript, we recommend to disable no-undef rule directly as TypeScript already check for them and you don’t need to worry about this.
解决方案一(官方解决方案)
AutoImport({eslintrc: {enabled: true, // 会在项目根目录自动生成.eslintrc-auto-import.json},
})
在.eslintrc.js
的extends里面添加一行代码
extends: ['.eslintrc-auto-import.json',],
解决方案二
所以在.eslintrc.js
的rules里面添加一行代码,全局有效。。
'no-undef': 'off', // 组件使用autoImport,eslint 就不用检测了
eslint提示就消失了