【Vue3】element-plus按需自动导入的配置以及icon不显示的解决方案

最新推荐文章于 2026-04-15 13:22:57 发布

原创最新推荐文章于 2026-04-15 13:22:57 发布 · 4.5k 阅读 ·

本内容遵循CC 4.0 BY-SA版权协议

let it go123

关注

标签

#vue.js #前端 #javascript #elementui #前端框架

分类开发工具

前端专栏收录该内容

17 篇文章

订阅专栏

本文介绍了如何在Vite项目中安装并配置unplugin-vue-components、unplugin-auto-import和unplugin-icons插件，以实现Vue项目中ElementPlus组件和自定义图标的自动导入。同时提到官方文档未提及的关于图标导入的命名规范调整。

首先需要安装unplugin-vue-components，unplugin-auto-import，unplugin-icons三款插件。

npm install -D unplugin-vue-components unplugin-auto-import unplugin-icons

然后vite.config.js里加入下面的配置：

import { defineConfig } from "vite";
import Vue from "@vitejs/plugin-vue";
import AutoImport from "unplugin-auto-import/vite";
import Components from "unplugin-vue-components/vite";
import { ElementPlusResolver } from "unplugin-vue-components/resolvers";
import Icons from "unplugin-icons/vite";
import IconsResolver from "unplugin-icons/resolver";

export default defineConfig({
  // ...
  plugins: [
    Vue(),
    AutoImport({
      imports: ['vue'],
      resolvers: [
        ElementPlusResolver(),
        IconsResolver({
          prefix: "Icon",
        }),
      ],
    }),
    Components({
      resolvers: [
        IconsResolver({
          enabledCollections: ["ep"],
        }),
        ElementPlusResolver(),
      ],
      directoryAsNamespace: true,
    }),
    Icons({
      autoInstall: true,
      compiler: 'vue3'
    }),
  ],
  // ...
});

官方还有个ts版最佳实践：

https://github.com/sxzz/element-plus-best-practices/blob/db2dfc983ccda5570033a0ac608a1bd9d9a7f658/vite.config.ts

另外有个官方文档没提及的地方，用这种方式自动引入的图标写法要稍微改变，文档用法是：