1 / 4概念
State and Data
状态管理的大部分事故不是「不会用库」,而是把不该放一起的状态放一起了。判断标准是能否给每份状态指定一个唯一归属,并说清它什么时候失效。
1 概念
1.1 一句话定义
状态是渲染的输入,位置决定耦合。React 只内建局部状态,其余五类状态各有归属:最近的公共祖先、上下文、外部存储、URL、服务端缓存。
1.2 它解决什么问题
- 单一数据源:同一份数据只有一处可写,避免多副本不同步。
- 避免层层透传:低频全局状态走上下文,高频状态走订阅。
- 缓存与失效:服务端数据有生命周期,不该塞进组件状态。
- 可分享与可回退:筛选条件放 URL,操作可撤销,页面可刷新。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 渲染、协调、副作用时机 | Rendering and Reconciliation |
| 浏览器存储、History、Fetch | Browser Environment |
| 接口契约与错误码 | Backend Frameworks |
| 数据库事务与索引 | Data |
| 类型标注与收窄 | TS Type System |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 状态提升 | 把状态移到公共祖先 | 不是移到全局 |
| 派生状态 | 由已有状态算出的值 | 不要用状态存它 |
| 受控组件 | 值由 React 状态驱动 | 每次输入都重渲染 |
| 非受控组件 | 值由 DOM 自己维护 | 用 ref 读取 |
| 上下文 | 跨层传值 | 不是性能工具 |
| 外部 store | React 之外的订阅源 | 需要 tear-free 读取 |
| 服务端状态 | 来自网络、有缓存生命周期的数据 | 与 UI 状态不同 |
| 缓存键 | 区分不同请求的标识 | 少一个参数就会串数据 |
| 乐观更新 | 先改界面再等结果 | 必须有回滚 |
| 竞态 | 旧响应覆盖新状态 | 用取消或版本号 |
| 闭包旧值 | 回调里读到旧状态 | 用函数式更新或 ref |
2 机制
2.1 心智模型
先问四个问题:这份状态由谁写,能被几处读到,刷新页面后应不应该还在,失效后由谁负责重取。四个答案决定它放在组件、上下文、外部 store、URL 还是查询缓存里。
2.2 机制拆解
- 局部状态:
useState与useReducer,更新是替换而不是修改。 - 不可变更新:对象与数组要新建,否则引用不变,渲染不会发生。
- 上下文:值是引用比较,每次新建对象都会让所有消费者重渲染。
- 外部 store:通过
useSyncExternalStore订阅,React 用快照保证同一次渲染读到一致的值。 - 服务端缓存:以查询键区分条目,条目带新鲜度与回收时间,重取时保留旧数据。
- 请求竞态:旧请求晚到会覆盖新结果,取消或比较请求版本才能避免。
- 乐观更新:先写入临时结果,失败时用保存的快照回滚,成功时用服务端结果替换。
2.3 完整枚举
六类状态与推荐归属:
| 状态类别 | 例子 | 推荐位置 |
|---|---|---|
| 局部 UI | 展开、输入、悬停 | 组件 useState |
| 跨组件 | 当前选中项、主题 | 最近公共祖先或上下文 |
| 高频全局 | 光标、播放进度 | 外部 store 加订阅 |
| 可分享 | 筛选、分页、标签页 | URL 查询参数 |
| 服务端数据 | 列表、详情、用户 | 查询缓存库 |
| 表单 | 字段值与校验 | 非受控表单库 |
状态方案的对比:
| 方案 | 读写方式 | 重渲染范围 | 适用 |
|---|---|---|---|
useState | 组件内 | 当前组件 | 局部状态 |
useReducer | 事件驱动 | 当前组件 | 多字段联动 |
| 上下文 | 提供者写入 | 全部消费者 | 低频全局值 |
| Zustand | 选择器订阅 | 订阅该切片的组件 | 高频全局状态 |
| Redux Toolkit | 单一 store | 选择器命中者 | 大型团队、可追溯 |
| Jotai | 原子订阅 | 依赖该原子的组件 | 细粒度派生 |
| 查询缓存库 | 键驱动 | 使用该键的查询 | 服务端数据 |
服务端数据的四个状态位:
| 状态位 | 含义 | 界面处理 |
|---|---|---|
| 加载中且无数据 | 首次请求 | 骨架屏 |
| 有数据但已过期 | 陈旧数据 | 显示旧值并后台重取 |
| 有数据且新鲜 | 可用 | 直接使用 |
| 失败 | 请求错误 | 显示错误并提供重试 |
三种请求竞态处理:
| 方式 | 做法 | 代价 |
|---|---|---|
| 取消 | 带 AbortSignal 请求 | 需要底层支持 |
| 版本号 | 比较最新请求序号 | 需要额外状态 |
| 键驱动 | 结果绑定查询键 | 依赖查询库 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 新鲜期 | 秒到分钟 | 按业务容忍度设定 |
| 回收时间 | 分钟级 | 决定离开页面后保留多久 |
| 重试次数 | 两到三次 | 配指数退避 |
| 上下文消费者 | 数百个开始明显 | 高频值不宜放上下文 |
| 单个请求体积 | 数十到数百 KB | 决定是否需要分页 |
| 乐观回滚窗口 | 请求往返时间 | 太长会让用户困惑 |
3 实践
3.1 最小示例
用一个极小的外部 store 演示订阅与快照。这是接入任何状态库的最小骨架。
import {useSyncExternalStore} from 'react';
type Selection = {id: string | null};
let selection: Selection = {id: null};
const listeners = new Set<() => void>();
function subscribe(listener: () => void) {
listeners.add(listener);
return () => listeners.delete(listener);
}
function getSnapshot() {
return selection;
}
export function select(id: string | null) {
selection = {id};
for (const listener of listeners) listener();
}
export function useSelection() {
return useSyncExternalStore(subscribe, getSnapshot);
}
追踪一次更新:select('u1') 替换 selection 的引用并通知监听者;组件的订阅回调触发重渲染;渲染时 getSnapshot 返回新的引用,React 判定值变了,于是重渲染。整个过程没有 context,也不会让无关组件重渲染。
关键约束:getSnapshot 必须返回稳定引用,每次返回新对象会导致无限重渲染。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 函数式更新 | setCount((c) => c + 1) | 避免闭包旧值 |
| 复杂迁移 | useReducer(reducer, init) | 事件可追溯 |
| 稳定上下文值 | useMemo(() => ({...}), deps) | 防止全量重渲染 |
| 订阅外部源 | useSyncExternalStore | SSR 要给快照函数 |
| 查询键 | ['user', id] | 参数齐全 |
| 失效重取 | invalidateQueries({queryKey}) | 写入后失效 |
| 取消请求 | signal 参数 | 组件卸载时中止 |
| 表单 | 非受控加 schema 校验 | 大表单更省重渲染 |
3.3 标准流程
- 列出所有状态,标注写入方与读取方。
- 能被现有状态算出来的,一律删除,改成派生。
- 只有一处读写的留在组件内。
- 跨组件且低频的放上下文,高频的放外部 store。
- 服务端数据全部交给查询缓存,键要包含全部参数。
- 写操作完成后失效相关键,不要手动改缓存副本。
3.4 与相邻技术的组合
- 渲染:状态变化触发渲染,state 更新必须不可变。
- 异步:取消信号与并发控制决定竞态是否发生。
- 浏览器:URL 用 History API,持久化用本地存储,跨标签页用
storage事件。 - 服务端:查询键对应接口路径与参数,错误码对应界面分支。
- 框架:框架提供路由数据加载时,优先使用框架的缓存而不是再叠一层库。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 归属 | 本地 / 祖先 / 上下文 / store / URL / 缓存 | 耦合与同步成本 |
| 更新频率 | 低频 / 高频 | 是否用订阅 |
| 来源 | 本地 / 服务端 | 是否需要缓存与失效 |
| 可分享 | 内部 / URL | 刷新与分享行为 |
| 一致性要求 | 最终 / 强 | 乐观更新的可行性 |
3.6 决策规则
- 能派生就不要用状态存。
- 上下文只放低频值;高频值用选择器订阅的 store。
- 服务端数据不复制进组件状态,直接读查询缓存。
- 一旦状态会影响分享或刷新,就放进 URL。
- 乐观更新必须准备回滚,界面与最后确认状态要能对齐。
- 表单字段多时用非受控加 schema 校验,不要每个字段一个 state。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 组件状态 | 零依赖 | 跨组件难共享 | 局部交互 |
| 上下文 | 内建、写法统一 | 高频更新代价大 | 主题、语言 |
| Zustand | 轻、选择器精确 | 约定靠团队 | 中型应用 |
| Redux Toolkit | 可追溯、工具强 | 模板代码 | 大团队 |
| Jotai | 原子派生自然 | 心智模型新 | 细粒度关联 |
| 查询缓存库 | 缓存与失效内建 | 多一层抽象 | 服务端数据 |
3.8 何时不该用
- 不要在只有两三个组件的应用里引入全局状态库。
- 不要用上下文传高频变化的值。
- 不要把服务端数据再复制进
useState,那是两份真相。 - 不要在 URL 里放敏感信息。
- 不要为了「以后可能共享」提前把状态提升到顶层。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 界面不更新 | 直接改了对象或数组 | 新建引用 |
| 每次输入整页重渲染 | 值放在上下文顶层 | 下沉或改订阅 |
| 列表串数据 | 查询键缺参数 | 键包含全部参数 |
| 旧响应覆盖新状态 | 请求竞态 | 取消或版本号 |
| 提交后页面还是旧数据 | 未失效缓存 | 写入后失效键 |
| 回调里读到旧值 | 闭包旧值 | 函数式更新或 ref |
| 乐观更新后界面错乱 | 失败未回滚 | 保存快照回滚 |
| 刷新后筛选丢失 | 状态没进 URL | 同步到查询参数 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 派生值存进状态 | 两处真相 | 直接计算 |
| 全局放所有状态 | 重渲染与耦合 | 就近归属 |
| 手动改缓存副本 | 与服务器漂移 | 失效重取 |
用 useEffect 同步请求结果 | 竞态与多余渲染 | 查询缓存库 |
| 一个表单一个 state | 输入卡顿 | 非受控加校验 |
4.3 可观测信号
重渲染次数按组件统计、请求总数与去重率、缓存命中率与陈旧比例、接口错误率、乐观更新回滚次数、URL 与界面状态不一致的工单。
4.4 安全 / 性能 / 一致性边界
- 泄露边界:URL 会进日志与历史,本地存储可被脚本读取,敏感数据只放内存或安全 Cookie。
- 性能边界:上下文更新成本与消费者数量成正比;选择器订阅成本与依赖切片数量成正比。
- 一致性边界:多个标签页之间需要
storage事件或广播通道同步,否则状态各不相同。 - 失效边界:缓存键少一个参数就会串数据,键的设计属于接口契约的一部分。