1 / 4概念
Lifecycle
React 的核心不是 JSX,而是一条固定的流水线:状态变化触发重新渲染,渲染产出一棵描述树,协调把新树映射到宿主环境。判断标准不是会不会写组件,而是能否说清一次更新走了几遍渲染、为什么某个组件被复用或重建。
1 概念
1.1 一句话定义
组件是返回元素树的纯函数。React 在渲染阶段算出新元素树,在提交阶段把差异写入宿主环境,然后运行副作用。协调比较新旧树,决定复用、更新还是卸载。
1.2 它解决什么问题
- 声明式更新:只描述「界面应该是什么样」,不手写 DOM 操作。
- 可组合:组件是函数,组合方式就是函数组合。
- 一致更新:多次状态变化合并成一次渲染,避免中间态闪烁。
- 跨宿主:同一套组件模型可以输出 DOM、原生视图或字符串。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 状态管理库、数据获取与缓存 | State and Data |
| 浏览器 DOM、事件模型、渲染管线 | Browser Environment |
| 打包、HMR、产物分析 | Toolchain |
| 服务端框架的路由与部署 | State and Data |
| HTML 语义与 CSS 布局 | HTML / CSS |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 元素 | 描述 UI 的不可变对象 | 不是 DOM 节点 |
| 组件 | 返回元素的函数或类 | 不是文件 |
| 实例 | 挂载后对应的 fiber 节点 | 函数组件也有实例 |
| fiber | 协调用的内部节点结构 | 不是公开 API |
| 渲染阶段 | 计算新树,必须纯 | 不能有副作用 |
| 提交阶段 | 写宿主环境,同步执行 | 不可中断 |
| 协调 | 比较新旧节点决定操作 | 不等于 diff 算法 |
| key | 列表元素的身份标识 | 不是性能开关 |
| 副作用 | 渲染之外的动作 | 不能在渲染阶段做 |
| 水合 | 复用服务端 HTML 并绑定事件 | 不是重新渲染 |
| Suspense | 声明式等待异步内容 | 不是错误边界 |
2 机制
2.1 心智模型
把一次更新想成三步:调度(决定何时算)、渲染(算出树)、提交(写入并跑副作用)。渲染可以被打断、可以重复执行,所以必须纯;提交不可打断,所以只能做必要的最小写入。
2.2 机制拆解
- 元素不可变:每次渲染都新建元素对象,元素只是描述,不是状态容器。
- 组件调用:函数组件在渲染阶段被直接调用,所以不能在里面改状态或发请求。
- 协调规则:类型相同且
key相同就复用,类型不同就整棵重建,这就是状态丢失的来源。 - 两阶段:渲染阶段可中断、可重放;提交阶段同步执行完,再依次执行布局副作用与被动副作用。
- 副作用顺序:子组件先于父组件挂载,卸载时顺序相反;清理函数在同一次提交里先运行。
- 严格模式:开发环境会双调用渲染与副作用,用来暴露不纯的实现与缺失的清理。
- 水合:客户端首次渲染必须与服务端输出一致,否则会有告警并改为客户端重建。
- 并发特性:
startTransition、useDeferredValue让低优先级更新让路,配合 Suspense 保持界面可交互。
2.3 完整枚举
四个核心概念的关系:
| 概念 | 生命周期 | 是否可变 | 用途 |
|---|---|---|---|
| 元素 | 每次渲染新建 | 不可变 | 描述 UI |
| 组件 | 代码中定义 | — | 产生元素 |
| fiber | 挂载到卸载 | 可变 | 协调与调度 |
| DOM 节点 | 提交时创建 | 可变 | 宿主输出 |
一次更新的五个阶段:
| 阶段 | 是否可中断 | 允许副作用 | 典型工作 |
|---|---|---|---|
| 调度 | — | — | 计算优先级、合并更新 |
| 渲染 | 是 | 否 | 调用组件、比较子节点 |
| 提交前 | 否 | 否 | 执行 DOM 变更前的钩子 |
| 布局副作用 | 否 | 是 | 读取布局、同步测量 |
| 被动副作用 | 否 | 是 | 订阅、请求、日志 |
常用 Hook 的职责,这是常用的集合:
| Hook | 用途 | 注意 |
|---|---|---|
useState | 局部状态 | 更新函数接收旧值 |
useReducer | 复杂状态迁移 | 适合多字段联动 |
useRef | 跨渲染保存值 | 变更不触发渲染 |
useMemo | 缓存计算结果 | 不是语义保证 |
useCallback | 缓存函数引用 | 依赖数组必须完整 |
useEffect | 渲染后副作用 | 清理函数必须对称 |
useLayoutEffect | 提交前同步副作用 | 阻塞绘制 |
useContext | 读取上下文 | 值变化会让消费者重渲染 |
useSyncExternalStore | 订阅外部存储 | SSR 需要快照函数 |
useTransition | 标记低优先级更新 | 返回挂起状态 |
useDeferredValue | 延后某个值 | 不能控制请求 |
useId | 稳定标识 | 服务端与客户端一致 |
五种渲染策略:
| 策略 | 首屏 | 交互 | 适用 |
|---|---|---|---|
| CSR | 空白加脚本 | 挂载后可用 | 后台系统 |
| SSR | 服务端 HTML | 水合后可用 | 内容站点 |
| SSG | 预生成 HTML | 水合后可用 | 文档、博客 |
| ISR | 预生成并可更新 | 同上 | 频繁更新的内容 |
| RSC | 服务端组件输出 | 客户端组件水合 | 数据密集页面 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 一帧预算 | 约 16.7 毫秒 | 超过即掉帧 |
| 渲染次数 | 每次状态变化一次 | 批处理后可能合并 |
| 严格模式调用 | 开发环境两次 | 生产环境一次 |
| 水合成本 | 与 DOM 节点数成正比 | 大页面首屏可感知 |
| fiber 优先级 | 若干档 | 交互高于过渡 |
| 组件树深度 | 建议不超过十几层 | 影响协调与调试 |
3 实践
3.1 最小示例
同一个列表,换 key 就换身份。示例用受控输入证明状态跟着 key 走。
function Row({user}: {user: {id: string; name: string}}) {
const [draft, setDraft] = useState(user.name);
return (
<li>
<input value={draft} onChange={(event) => setDraft(event.target.value)} />
</li>
);
}
function Team({users}: {users: Array<{id: string; name: string}>}) {
return (
<ul>
{users.map((user) => (
<Row key={user.id} user={user} />
))}
</ul>
);
}
追踪:把 key 换成数组下标,再在列表头部插入一个用户。React 认为第 0 个位置的元素类型没变,于是复用旧 fiber,draft 状态留在原来的行里,输入框内容错位到新用户上。换成 user.id 后,key 变化让 React 重建该行,状态与数据重新对齐。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 稳定身份 | key={item.id} | 不用下标 |
| 条件渲染 | cond ? <A /> : null | 不要用 && 配数字 |
| 缓存计算 | useMemo(fn, deps) | 只在测量到瓶颈时加 |
| 缓存回调 | useCallback(fn, deps) | 依赖完整才有效 |
| 跳过重渲染 | memo(Component) | props 浅比较 |
| 延迟更新 | startTransition(() => setQuery(q)) | 输入保持响应 |
| 延后取值 | useDeferredValue(query) | 结果可以滞后 |
| 声明等待 | 外层包 Suspense | 提供回退 UI |
| 捕获渲染错误 | 错误边界 | 函数组件要用库实现 |
3.3 标准流程
- 先画出组件树,确定每份状态的最小归属。
- 列表一律用稳定 id 作 key,不用下标。
- 渲染函数保持纯:只做计算,不做请求与订阅。
- 副作用只在
useEffect里做,并且写对称的清理。 - 先测量再优化:用 Profiler 找出真正贵的组件。
- 水合页面保证服务端与客户端首帧一致,不读本地存储决定首屏。
3.4 与相邻技术的组合
- 浏览器环境:React 只写 DOM,不改变事件模型;合成事件在根节点委托。
- 异步:过渡与 Suspense 依赖微任务调度,阻塞渲染会撑大首帧。
- 状态与数据:本页只管渲染,数据获取与缓存归下一页。
- 服务端渲染:框架负责把组件树变成 HTML 与数据流,本页管组件是否可水合。
- 工具链:React Compiler 能自动插入记忆化,手动
memo的必要性下降。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 渲染策略 | CSR / SSR / SSG / ISR / RSC | 首屏与 SEO |
| 记忆化 | 不记忆 / 手动 / 编译器 | 可读性与性能 |
| 优先级 | 单一 / 过渡与延迟值 | 交互流畅度 |
| 数据位置 | 组件内 / 外层 / 服务端组件 | 网络往返与耦合 |
| 错误处理 | 错误边界 / 全局兜底 | 局部失败的影响面 |
3.6 决策规则
- 列表 key 用稳定 id;只有静态、不可重排的列表才允许下标。
- 默认不写
memo与useMemo,先用 Profiler 证明有必要。 - 输入框保持即时更新,重计算部分用
useDeferredValue或过渡。 - 需要读布局的同步副作用用
useLayoutEffect,其余用useEffect。 - 服务端组件里不写交互状态;交互边界用
'use client'标出。 - 水合不一致时先修首帧逻辑,不要用
useEffect补渲染。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 纯客户端渲染 | 简单、部署轻 | 首屏空白、SEO 弱 | 后台系统 |
| SSR | 首屏可见 | 服务器与缓存成本 | 内容站点 |
| SSG | 最快、可 CDN | 构建时间长 | 文档、博客 |
| RSC | 数据靠近组件 | 心智负担与框架依赖 | 数据密集页面 |
| 手动记忆化 | 精确 | 依赖数组易错 | 热点组件 |
| 编译器记忆化 | 省心 | 需要构建集成 | 新项目 |
3.8 何时不该用
- 不要在小页面上引入完整框架与路由,静态 HTML 更省。
- 不要在渲染阶段发请求或订阅,严格模式会立刻暴露。
- 不要用
useEffect同步派生状态,直接计算即可。 - 不要给每个组件套
memo,浅比较本身有成本。 - 不要在服务端组件里塞浏览器 API,那层代码根本不在浏览器跑。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 输入框内容串行 | 列表用下标作 key | 换稳定 id |
| 渲染死循环 | 渲染阶段调 setState | 移到事件或副作用 |
| 副作用执行两次 | 开发环境严格模式 | 补齐清理,不要靠开关 |
| 水合告警 | 服务端与客户端首帧不同 | 首帧不读随机值与时区 |
| 订阅泄漏 | 副作用没有清理 | 返回清理函数 |
| 上下文变化导致整页重渲染 | 值每次新建 | 拆分上下文或记忆化 |
| 过渡不生效 | 更新包在同步事务里 | 用 startTransition 包裹 |
| 错误边界没接住 | 异步错误不在渲染路径 | 在数据层处理并在边界抛出 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 下标作 key | 状态错位 | 稳定 id |
| 渲染里改状态 | 死循环 | 事件驱动 |
useEffect 同步派生值 | 多一次渲染、易不一致 | 直接计算 |
到处 useMemo | 噪声与开销 | 测量后加 |
用 && 显示计数 | 0 被渲染出来 | 三元或布尔转换 |
4.3 可观测信号
Profiler 的提交时长与渲染次数、组件重渲染次数、水合告警数量、首屏绘制时间、Suspense 回退出现频率、错误边界触发次数。
4.4 安全 / 性能 / 一致性边界
- 注入边界:
dangerouslySetInnerHTML与用户内容结合就是 XSS 入口,必须先行净化。 - 性能边界:一次渲染的组件数量与 DOM 写入量决定帧时间;协调是 O(节点数)。
- 一致性边界:服务端与客户端首帧必须一致,时区、随机数与本地存储都会破坏它。
- 版本边界:并发特性与 RSC 依赖 React 19 及以上,混用旧版渲染器会静默降级。