perf(后台首屏): Element Plus 改按需注册,入口 JS 1,129,783→737,303 B

同一棵树只翻 main.ts/App.vue 做 A/B(其余文件两轮一致,差值可整份归给这条):
入口 JS −34.7%、CSS −45.6%、dist 整树 −567,203 B;A 组跑两次字节与哈希完全相同。

新增 src/plugins/element.ts 显式注册表。没走用户端那套 ElementPlusResolver:
自动引入会把"到底注册了哪些组件"藏进产物,而按需注册的失败模式恰恰是
"漏一个组件不报错、页面渲染成裸标签",只有显式清单才能让护栏从源码推标签
做双向比对。语言包随之换到 App.vue 的 el-config-provider。

顺带摘掉两处重复请求:去重页 reAnalyze 白拉又丢返回值的那次整集 console、
看板 30s 心跳里无条件重拉的店铺候选(后端 SELECT DISTINCT 无缓存的字典数据)。

护栏 10 例(标签清单由 .vue 源码推导,不是手写名单)+ 变异自证 9/9 全杀;
前端全量 node --test 1698 例 0 红。只欠逐页浏览器视觉验证 —— 按需引入最坏的
那类回归不会让构建变红。
This commit is contained in:
2026-10-04 18:38:14 +08:00
parent 06c1a3accd
commit 85cbd56cd8
8 changed files with 386 additions and 14 deletions
+131
View File
@@ -0,0 +1,131 @@
/**
* Element Plus 按需注册(替代旧的 `app.use(ElementPlus)` + `dist/index.css`)。
*
* 为什么要这一份:旧写法把整库打进每个后台页面的首屏 —— 实测入口
* index-*.js 1,129,621 B(gzip 374,350 B)、index-*.css 383,458 B(gzip 52,413 B),
* 而 src 里模板只用到 29 个 `el-*` 标签。
*
* 两条不成文但会咬人的规矩,改这个文件前先读:
* 1. 新增/换用任何 `el-*` 标签,这里必须同时加「组件导入」和「按组件样式导入」。
* 少一条不会让构建变红,只会让那个页面渲染成裸标签 —— 护栏在
* tests/perf-element-on-demand.test.ts,它从源码推标签清单来比对这份文件。
* 2. 样式一律走 `element-plus/es/components/<短名>/style/css`,它会带上 base
* 与依赖组件的样式(例如 message-box 自带 input/button/overlay);
* 不要图省事改回 `theme-chalk/index.css` 或 `dist/index.css`。
*
* 语言包见 src/App.vue 的 `<el-config-provider :locale="zhCn">` —— 摘掉整包插件后
* 全局配置只能从 config-provider 走,别再指望 use(ElementPlus, { locale })。
*/
import type { App } from 'vue'
import {
ElAlert,
ElBreadcrumb,
ElBreadcrumbItem,
ElButton,
ElCheckbox,
ElConfigProvider,
ElDatePicker,
ElDescriptions,
ElDescriptionsItem,
ElDialog,
ElDrawer,
ElEmpty,
ElForm,
ElFormItem,
ElInput,
ElInputNumber,
ElLoadingDirective,
ElMenu,
ElMenuItem,
ElOption,
ElProgress,
ElRadioButton,
ElRadioGroup,
ElResult,
ElScrollbar,
ElSelect,
ElSubMenu,
ElTable,
ElTableColumn,
ElTree,
ElUpload,
} from 'element-plus'
// 模板在用的组件:样式按组件引(顺序与标签名字典序一致,方便和护栏清单对读)
import 'element-plus/es/components/alert/style/css'
import 'element-plus/es/components/breadcrumb/style/css'
import 'element-plus/es/components/breadcrumb-item/style/css'
import 'element-plus/es/components/button/style/css'
import 'element-plus/es/components/checkbox/style/css'
import 'element-plus/es/components/config-provider/style/css'
import 'element-plus/es/components/date-picker/style/css'
import 'element-plus/es/components/descriptions/style/css'
import 'element-plus/es/components/descriptions-item/style/css'
import 'element-plus/es/components/dialog/style/css'
import 'element-plus/es/components/drawer/style/css'
import 'element-plus/es/components/empty/style/css'
import 'element-plus/es/components/form/style/css'
import 'element-plus/es/components/form-item/style/css'
import 'element-plus/es/components/input/style/css'
import 'element-plus/es/components/input-number/style/css'
import 'element-plus/es/components/menu/style/css'
import 'element-plus/es/components/menu-item/style/css'
import 'element-plus/es/components/option/style/css'
import 'element-plus/es/components/progress/style/css'
import 'element-plus/es/components/radio-button/style/css'
import 'element-plus/es/components/radio-group/style/css'
import 'element-plus/es/components/result/style/css'
import 'element-plus/es/components/scrollbar/style/css'
import 'element-plus/es/components/select/style/css'
import 'element-plus/es/components/sub-menu/style/css'
import 'element-plus/es/components/table/style/css'
import 'element-plus/es/components/table-column/style/css'
import 'element-plus/es/components/tree/style/css'
import 'element-plus/es/components/upload/style/css'
// 命令式 API:不写在模板里,但同样要自带样式,否则弹层是裸 HTML
import { ElMessage, ElMessageBox } from 'element-plus'
import 'element-plus/es/components/message/style/css'
import 'element-plus/es/components/message-box/style/css'
// v-loading 指令与其服务样式
import 'element-plus/es/components/loading/style/css'
export { ElMessage, ElMessageBox }
const components = [
ElAlert,
ElBreadcrumb,
ElBreadcrumbItem,
ElButton,
ElCheckbox,
ElConfigProvider,
ElDatePicker,
ElDescriptions,
ElDescriptionsItem,
ElDialog,
ElDrawer,
ElEmpty,
ElForm,
ElFormItem,
ElInput,
ElInputNumber,
ElMenu,
ElMenuItem,
ElOption,
ElProgress,
ElRadioButton,
ElRadioGroup,
ElResult,
ElScrollbar,
ElSelect,
ElSubMenu,
ElTable,
ElTableColumn,
ElTree,
ElUpload,
]
export function installElement(app: App): void {
for (const component of components) app.use(component)
app.directive('loading', ElLoadingDirective)
}