Reader

一、引子：封装的幻觉

“哎，这几个页面结构差不多，我封装一下好了。”

很多开发者都会在项目中产生这样的冲动，尤其是做中后台系统时，一旦遇到几个结构类似的表单或列表页，就想提取公共组件。看起来像是 DRY（Don’t Repeat Yourself）的最佳实践，实际上却很容易误入歧途：

你以为你在封装组件，其实你只是在用配置项、插槽、条件渲染造了个更复杂的黑盒。

真正的问题不是封装，而是封装的边界模糊、结构职责不清、状态逻辑耦合 UI。

本文将结合真实案例，拆解初级、中级、高级组件封装的本质差异，帮助你理解——封装从不是目的，系统能力才是高级工程感的核心。

二、常见封装误区与案例拆解

1. 表单组件的封装错觉

我们先来看一个典型的错误封装案例：

<!-- 错误的Form封装 -->
<my-form :formData="form" :fields="fields" @submit="onSubmit">
  <template v-slot:extra>
    <button @click="onExport">导出</button>
  </template>
</my-form>

这段代码表面上很优雅，传了 fields 就能渲染表单，还有扩展插槽，甚至可能支持表单校验和重置逻辑。

问题在哪里？

• 字段职责不清：字段只是表单结构吗？字段还可能影响接口参数格式、权限控制、默认值、展示方式。
• 表单行为耦合 UI：你把逻辑写在组件内部的 @submit 回调里，这意味着每个使用这个组件的页面都得重复写一样的逻辑。
• 扩展性差：当你需要根据字段值联动另一个字段，或某些字段有特殊的业务逻辑，组件就无法扩展。

正确做法：字段中心 + 表单驱动

const fieldSchema = [
  {
    key: 'status',
    label: '状态',
    component: 'select',
    options: getDict('STATUS'),
    rules: [{ required: true, message: '请选择状态' }],
    apiField: 'status_code',
  },
  // ...
];

然后由通用的 <SmartForm /> 组件自动识别字段类型、权限、字典等信息进行渲染与校验，同时支持联动配置。

2. 列表页状态的误封装

<!-- 错误封装：DataList.vue -->
<template>
  <el-table :data="list" />
</template>
<script>
export default {
  props: ['list'],
  mounted() {
    // fetch logic...
  }
}
</script>

你以为你抽象了一个 DataList 组件，便于多个页面复用。

实际你只是把 el-table 包了一层，不支持分页、不支持空状态、不支持 loading。

更重要的是：你没有管理状态本身。

改进方向：抽象 useSmartList()

const { searchForm, tableProps, onSearch, onReset } = useSmartList({
  api: fetchData,
  defaultQuery: {},
  transform: (data) => data.map(item => ({ ...item, statusLabel: mapStatus(item.status) })),
});

然后配合页面中的 schema、columns 自动渲染，逻辑统一、行为一致。

三、组件封装的三个阶段

举个例子：表格字段

初级：

columns: [{ title: '状态', dataIndex: 'status', customRender: val => val === 1 ? '启用' : '禁用' }]

中级：

columns: [{ title: '状态', dataIndex: 'status', customRender: val => getDictLabel('STATUS', val) }]

高级：

fieldSchema: [{ key: 'status', label: '状态', dict: 'STATUS' }]
// 由表格组件根据 schema 自动渲染列标题、字典映射、权限控制

四、高级封装的本质：规则驱动 vs 配置堆砌

很多人误以为封装的程度越高，越通用越好。

但高级工程能力的核心在于：规则驱动而不是堆砌配置。

• 👎 低级组件：props 越来越多，写法越来越复杂，一堆 v-if 和 slot 判断
• 👍 高级组件：抽象成规则，例如字段权限、字段格式、接口规范、字段联动都由统一 schema 表达

真正的高级封装：

// 一个字段定义
{
  key: 'status',
  label: '状态',
  dict: 'STATUS',
  permissions: ['view'],
  component: 'a-select',
  format: (val) => val === 1 ? '启用' : '禁用',
  visible: (form) => form.type === 'basic'
}

你不是在写“组件”，而是在写“字段规则”。字段就是视图，规则决定行为。

五、真正的系统构建力

想成为高级前端，不能只满足于组件层面的复用，而要走向“体系构建力”：

• 字段结构中心：一份配置多端复用
• 页面模式抽象：编辑、新增、详情、弹窗统一逻辑
• 行为驱动设计：跳转、保存、校验不再散落各处
• 状态统一方案：支持缓存、回填、持久化

最终实现：前端是领域规则的建模者，而不仅是功能的搬运工。

六、结语：别被“封装”二字骗了

封装本身并不高级。高级的是你能否看清哪些逻辑可以通用，哪些行为需要抽象，哪些状态需要统一，哪些配置应该中心管理。

很多人写了十几二十个组件，结果维护困难，逻辑混乱。

你以为你在封装组件，其实你在引入混乱。

真正的封装，是为系统构建秩序。