移植elementui
移植 Element UI 的方法
Element UI 是一个基于 Vue.js 的组件库,移植通常涉及将其集成到现有项目或迁移到新框架(如 Vue 3)。以下是常见场景的移植方法:
在 Vue 2 项目中集成 Element UI
安装 Element UI 核心库:
npm install element-ui -S
在 main.js 中全局引入:
import Vue from 'vue';
import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';
Vue.use(ElementUI);
按需引入(推荐):
npm install babel-plugin-component -D
配置 babel.config.js:
module.exports = {
plugins: [
[
"component",
{
"libraryName": "element-ui",
"styleLibraryName": "theme-chalk"
}
]
]
}
迁移到 Vue 3 使用 Element Plus
Element UI 的 Vue 3 版本为 Element Plus,需重新安装:

npm install element-plus --save
全局引入:
import { createApp } from 'vue';
import ElementPlus from 'element-plus';
import 'element-plus/dist/index.css';
const app = createApp(App);
app.use(ElementPlus);
按需引入(使用 unplugin-vue-components):
npm install unplugin-vue-components -D
配置 vite.config.js:

import Components from 'unplugin-vue-components/vite';
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers';
export default {
plugins: [
Components({
resolvers: [ElementPlusResolver()],
}),
],
};
主题定制
通过 SCSS 变量覆盖默认主题:
-
创建
src/styles/element-variables.scss:$--color-primary: #FF0000; @import "~element-ui/packages/theme-chalk/src/index"; -
在项目中引入该文件替代默认 CSS:
import './styles/element-variables.scss';
对于 Element Plus,使用类似方式:
// element-plus/theme-chalk/src/common/var.scss
$--color-primary: #FF0000;
注意事项
- 版本兼容性:Element UI 仅支持 Vue 2,Vue 3 必须使用 Element Plus。
- 组件差异:部分组件 API 在 Element Plus 中有调整,需查阅迁移指南。
- 构建工具:若使用 Vite,需配置插件处理按需引入。
通过以上步骤可完成 Element UI 的移植或升级。实际执行时需根据项目环境调整构建配置。






