React / 系统课时
划分组件边界
划分组件边界
服务端与客户端组件的边界不是按页面平均切分,而是由数据位置、交互需求和依赖能力共同决定。本课用一棵组件树建立判断顺序,并演示如何把 'use client' 下沉到最小交互区域,避免把大块页面意外打进客户端包。
学习目标
- 能根据数据、交互和依赖判断组件应放在服务端还是客户端
- 理解
'use client'对模块依赖图的影响,并尽量缩小客户端边界 - 能识别跨边界传值和组件组合中的常见错误
从三个问题判断边界
先看数据。如果组件需要直接访问数据库、服务器文件、私有凭据或只应在服务器出现的业务逻辑,应优先保留为服务端组件。这样数据在服务器完成读取和整形,只把页面真正需要展示的结果传向浏览器。
再看交互。如果组件需要 useState、useEffect、事件处理器、window、localStorage 或依赖浏览器环境的第三方库,它就需要位于客户端边界内。不要因为页面里有一个下拉框,就把整个页面都标成客户端组件。
最后看依赖。'use client' 放在某个模块顶部后,该模块以及它静态导入的依赖会进入客户端模块图。因此边界越靠近组件树根部,潜在的客户端 JavaScript 范围通常越大;把边界下沉到交互叶子节点,更容易控制体积和职责。

把客户端边界下沉到交互叶子
下面的页面展示商品信息和数量选择器。商品数据与主体标记都不需要在浏览器执行,因此保留在服务端;只有数量选择器需要状态与点击事件,所以单独成为客户端组件。
// app/page.tsx
import QuantityPicker from './quantity-picker';
async function getProduct() {
// 示例用固定数据代替数据库,真实项目可在此执行服务器数据读取。
return { id: 'p-100', name: '机械键盘', price: 699 };
}
export default async function Page() {
const product = await getProduct();
return (
<main>
<h1>{product.name}</h1>
<p>价格:¥{product.price}</p>
<QuantityPicker productId={product.id} />
</main>
);
}
// app/quantity-picker.tsx
'use client';
import { useState } from 'react';
export default function QuantityPicker({ productId }: { productId: string }) {
const [quantity, setQuantity] = useState(1);
// 客户端只维护交互状态,不重新承担商品数据读取职责。
return (
<section aria-label={`商品 ${productId} 的数量选择`}>
<button onClick={() => setQuantity((value) => Math.max(1, value - 1))}>-</button>
<span>数量:{quantity}</span>
<button onClick={() => setQuantity((value) => value + 1)}>+</button>
</section>
);
}预期结果
页面显示:机械键盘
页面显示:价格:¥699
数量初始为 1;点击 + 变为 2;数量为 1 时点击 - 仍保持 1如果把 'use client' 直接写到 app/page.tsx,这个示例也能实现交互,但页面及其客户端依赖会被一起纳入客户端边界,失去“服务端主体 + 交互小岛”的清晰分工。
跨越边界时只传需要的东西
服务端组件可以渲染客户端组件,并通过 props 传递 React 能序列化的数据。传递商品 id、字符串、数字或用于展示的普通数据通常没有问题;不要把数据库连接、密钥、服务器对象或普通函数当作 props 直接送进客户端组件。
客户端组件也不应直接静态导入一个服务端组件模块。需要组合两类组件时,可以让更上层的服务端组件同时组织它们,再把已经构造好的服务端内容通过 children 或其他可接受的组件插槽交给客户端组件。这样“谁负责组合”仍在服务器一侧,客户端只负责自身交互。
用依赖方向做最后验收
完成拆分后,可以按一条简单规则复查:默认留在服务端,只有必须在浏览器执行的最小区域才进入客户端。如果一个客户端组件只为一个按钮服务,却导入了整套数据访问层、Markdown 解析器或大型 UI 依赖,说明边界或依赖方向仍值得调整。
反过来,也不要为了追求“零客户端 JavaScript”强行把交互搬走。状态、事件、浏览器 API 和客户端专用 Hook 本来就属于客户端。好的组件边界不是服务端组件越多越好,而是让数据读取、渲染和交互分别待在最合适的执行环境中。