React / 系统课时
组件职责与拆分策略
组件职责与拆分策略
组件拆分的目标不是把文件切得越小越好,而是让每个组件只承担清晰、稳定且可验证的职责。本课将用一个用户列表页面,演示如何按展示、交互和数据职责划分边界,并判断何时应继续拆分、何时应停止抽象。
学习目标
- 能按展示、交互和数据三类职责识别组件边界
- 能把巨型组件拆成可复用、可测试的协作单元
- 能判断拆分是否改善维护性,而不是制造额外复杂度
从职责变化识别拆分点
一个组件是否需要拆分,关键看它是否同时响应多种变化。页面布局变化属于展示职责,输入与点击属于交互职责,请求、缓存和状态同步属于数据职责。当三类逻辑集中在同一文件中,任何改动都可能影响整页。

拆分时优先寻找“变化原因”而不是“代码行数”。一个 80 行但职责单一的表格组件可能无需继续拆,而一个 30 行却同时发请求、处理表单并渲染弹窗的组件已经存在明显耦合。
按展示、交互和数据拆分
下面的示例把页面分为四个协作单元:页面组件负责组合,搜索表单负责输入交互,列表负责展示,自定义 Hook 负责数据筛选。示例可直接放入 Vite 创建的 React TypeScript 项目中运行。
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>
);
}预期结果
页面初始显示 Alice、Bob、Carol。
输入 bo 并点击“搜索”后,只显示 Bob。
输入不存在的名称后,显示“没有匹配用户”。页面组件没有保存输入框草稿,也不关心筛选算法;列表组件只接收 users 并渲染。这样修改搜索交互、数据来源或列表样式时,通常只影响一个职责单元。
避免两种相反的极端
巨型组件的问题是职责互相牵连,常见信号包括状态过多、事件函数过多、同一文件同时包含请求与复杂视图,以及局部修改需要通读整页。遇到这些信号,应先按业务职责切开,而不是简单按代码块切文件。
过度抽象则会让阅读者在多个薄组件之间来回跳转。只有一处使用、没有独立业务含义、只包一层标签的组件,通常不必提取。抽象应带来至少一种收益:复用、隔离变化、独立测试或降低认知负担。
| 判断问题 | 倾向拆分 | 倾向保留 |
|---|---|---|
| 是否有独立业务含义 | 是 | 否 |
| 是否会独立变化 | 经常 | 几乎同步变化 |
| 是否需要单独测试 | 需要 | 无独立行为 |
| 是否只减少几行 JSX | 否 | 是 |
用验收结果验证拆分
完成拆分后,不要只看文件数量。应检查页面行为是否保持一致,父子组件的 Props 是否容易理解,状态是否放在最接近使用者的位置,以及某个需求变化能否局限在少数组件内。
还要确认数据流保持单向:父组件传值,子组件通过回调表达事件。若为了拆分而引入大量层层转发、上下文或全局状态,说明边界可能切得过细,或者状态位置需要重新调整。