Vue 3 + Vite 项目中按需引入 Element Plus (JavaScript)

邪恶美羊羊2025-07-20 10:30

1. 安装必要依赖

bash 复制代码

npm install element-plus
npm install -D unplugin-vue-components unplugin-auto-import

2. 配置 vite.config.js

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'

export default defineConfig({
  plugins: [
    vue(),
    AutoImport({
      resolvers: [ElementPlusResolver()],
    }),
    Components({
      resolvers: [ElementPlusResolver()],
    }),
  ],
})

3. 可选样式配置

3.1 完整引入样式 (推荐)

在 main.js 中：

js 复制代码

import 'element-plus/dist/index.css'

3.2 按需引入样式 (需要额外安装插件)

bash 复制代码

npm install -D vite-plugin-style-import

然后在 vite.config.js 中添加：

js 复制代码

import { createStyleImportPlugin } from 'vite-plugin-style-import'

export default defineConfig({
  plugins: [
    // ...其他插件
    createStyleImportPlugin({
      libs: [
        {
          libraryName: 'element-plus',
          esModule: true,
          ensureStyleFile: true,
          resolveStyle: (name) => {
            return `element-plus/es/components/${name.substring(3)}/style/css`
          },
        },
      ],
    }),
  ],
})

4. 使用组件

现在你可以直接在模板中使用 Element Plus 组件，无需手动导入：

vue 复制代码

<template>
  <el-button type="primary">按钮</el-button>
  <el-input v-model="inputValue" placeholder="请输入内容"></el-input>
</template>

<script>
export default {
  data() {
    return {
      inputValue: ''
    }
  }
}
</script>

5. 自定义主题 (可选)

在 vite.config.js 中添加：

js 复制代码

export default defineConfig({
  css: {
    preprocessorOptions: {
      scss: {
        additionalData: `@use "element-plus/theme-chalk/src/index" as *;`,
      },
    },
  },
})

然后创建 variables.scss 文件定义变量：

css 复制代码

$--color-primary: #409EFF;

注意事项

确保你的 Vue 版本是 3.x
确保 Vite 版本是 2.x 或更高
按需引入只适用于模板中使用的组件
如果需要在 JS 中使用 ElMessage 等非组件 API，仍需手动导入：

js 复制代码

import { ElMessage } from 'element-plus'

ElMessage.success('操作成功')