封装是为系统构建秩序,常见封装误区与案例拆解

资讯 2025年04月17日

首页资讯正文

文章详情

一、引子：封装的幻觉

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

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

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

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

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

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

1. 表单组件的封装错觉

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

xml

代码解读
复制代码

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

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

问题在哪里？

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

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

ini

代码解读
复制代码

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

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

2. 列表页状态的误封装

xml

代码解读
复制代码

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

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

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

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

改进方向：抽象 useSmartList()

css

代码解读
复制代码

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

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

三、组件封装的三个阶段

等级	开发目标	特征
初级	页面能用，功能不报错	逻辑散乱、字段写死、重复逻辑多
中级	页面结构清晰，组件职责明确	有组件复用，但配置灵活性不足
高级	字段驱动 + 页面生成 + 状态抽象	形成系统能力，字段中心驱动页面

举个例子：表格字段

初级：

less

代码解读
复制代码

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

中级：

less

代码解读
复制代码

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

高级：

css

代码解读
复制代码

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

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

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

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

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

真正的高级封装：

javascript

代码解读
复制代码

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