React / 系统课时

组件职责与拆分策略

组件职责与拆分策略

组件拆分的目标不是把文件切得越小越好,而是让每个组件只承担清晰、稳定且可验证的职责。本课将用一个用户列表页面,演示如何按展示、交互和数据职责划分边界,并判断何时应继续拆分、何时应停止抽象。

学习目标

  • 能按展示、交互和数据三类职责识别组件边界
  • 能把巨型组件拆成可复用、可测试的协作单元
  • 能判断拆分是否改善维护性,而不是制造额外复杂度

从职责变化识别拆分点

一个组件是否需要拆分,关键看它是否同时响应多种变化。页面布局变化属于展示职责,输入与点击属于交互职责,请求、缓存和状态同步属于数据职责。当三类逻辑集中在同一文件中,任何改动都可能影响整页。

用户列表页面的组件职责拆分结构图

拆分时优先寻找“变化原因”而不是“代码行数”。一个 80 行但职责单一的表格组件可能无需继续拆,而一个 30 行却同时发请求、处理表单并渲染弹窗的组件已经存在明显耦合。

按展示、交互和数据拆分

下面的示例把页面分为四个协作单元:页面组件负责组合,搜索表单负责输入交互,列表负责展示,自定义 Hook 负责数据筛选。示例可直接放入 Vite 创建的 React TypeScript 项目中运行。

tsx
import { useMemo, useState } from "react";
import type { FormEvent } from "react";

type User = {
  id: number;
  name: string;
};

const USERS: User[] = [
  { id: 1, name: "Alice" },
  { id: 2, name: "Bob" },
  { id: 3, name: "Carol" }
];

function useUsers(keyword: string) {
  return useMemo(() => {
    const normalized = keyword.trim().toLowerCase();
    return USERS.filter((user) =>
      user.name.toLowerCase().includes(normalized)
    );
  }, [keyword]);
}

function UserSearchForm(props: {
  value: string;
  onSearch: (keyword: string) => void;
}) {
  const [draft, setDraft] = useState(props.value);

  function handleSubmit(event: FormEvent<HTMLFormElement>) {
    event.preventDefault();
    props.onSearch(draft);
  }

  return (
    <form onSubmit={handleSubmit}>
      <input
        value={draft}
        onChange={(event) => setDraft(event.target.value)}
        placeholder="输入用户名"
      />
      <button type="submit">搜索</button>
    </form>
  );
}

function UserList({ users }: { users: User[] }) {
  if (users.length === 0) {
    return <p>没有匹配用户</p>;
  }

  return (
    <ul>
      {users.map((user) => (
        <li key={user.id}>{user.name}</li>
      ))}
    </ul>
  );
}

export default function UserListPage() {
  const [keyword, setKeyword] = useState("");
  const users = useUsers(keyword);

  return (
    <main>
      <h1>用户列表</h1>
      <UserSearchForm value={keyword} onSearch={setKeyword} />
      <UserList users={users} />
    </main>
  );
}

预期结果

text
页面初始显示 Alice、Bob、Carol。
输入 bo 并点击“搜索”后,只显示 Bob。
输入不存在的名称后,显示“没有匹配用户”。

页面组件没有保存输入框草稿,也不关心筛选算法;列表组件只接收 users 并渲染。这样修改搜索交互、数据来源或列表样式时,通常只影响一个职责单元。

避免两种相反的极端

巨型组件的问题是职责互相牵连,常见信号包括状态过多、事件函数过多、同一文件同时包含请求与复杂视图,以及局部修改需要通读整页。遇到这些信号,应先按业务职责切开,而不是简单按代码块切文件。

过度抽象则会让阅读者在多个薄组件之间来回跳转。只有一处使用、没有独立业务含义、只包一层标签的组件,通常不必提取。抽象应带来至少一种收益:复用、隔离变化、独立测试或降低认知负担。

判断问题 倾向拆分 倾向保留
是否有独立业务含义 是 否
是否会独立变化 经常 几乎同步变化
是否需要单独测试 需要 无独立行为
是否只减少几行 JSX 否 是

用验收结果验证拆分

完成拆分后,不要只看文件数量。应检查页面行为是否保持一致,父子组件的 Props 是否容易理解,状态是否放在最接近使用者的位置,以及某个需求变化能否局限在少数组件内。

还要确认数据流保持单向:父组件传值,子组件通过回调表达事件。若为了拆分而引入大量层层转发、上下文或全局状态,说明边界可能切得过细,或者状态位置需要重新调整。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

组件职责与拆分策略

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通