一、问题背景:Context 不是万能药
项目是一个面向企业内部运营的中台系统,React 18.2 + TypeScript 4.9 + Vite 4.3,状态管理最初用的是最朴素的方案:局部状态用 Props 传递,跨组件共享的数据(用户信息、权限、全局筛选条件、字典缓存)放进了三个 Context。
一开始没问题。真正开始疼是在业务扩张之后:
- Provider 嵌套变深。AuthContext → PermissionContext → FilterContext → DictContext,最外层页面要包四层 Provider,新同事看到这段代码第一反应是"这啥"。
- 全局重渲染。FilterContext 里存的是列表页的筛选条件,只要改一个下拉框,Provider 下的所有消费者全部重渲染。我们用 React DevTools Profiler 抓了一次,单次筛选变更触发了 236 个组件 render,其中真正需要更新的只有 12 个。
- Props 透传。有些深层组件需要拿用户权限,中间要穿过 5 层组件,每层都得写一遍
user和permissions,改个字段名要改一串文件。
指标上很直观:列表页筛选交互的 INP(Interaction to Next Paint)从 80ms 左右涨到了 320ms,用户反馈"点筛选卡一下"。
这时候就得认真考虑换个状态管理方案了。
二、环境与版本
先把环境交代清楚,避免读者对号入座时踩版本坑:
- React 18.2.0,react-dom 18.2.0
- TypeScript 4.9.5
- Vite 4.3.9
- 原状态方案:React Context(内置)+ Props drilling
- 候选库:Zustand 4.4.1、Jotai 2.4.2、Redux Toolkit 1.9.5
- 性能测量工具:React DevTools Profiler 4.28、Chrome Performance 面板
- 测试机:MacBook Pro M1 / Chrome 118,节流 4x CPU 模拟中低端设备
三、方案设计与对比
我们没有一上来就拍板 Zustand,先做了个小范围对比。评估维度是:迁移成本、重渲染控制粒度、TypeScript 支持、包体积、学习曲线。
| 维度 | Context | Redux Toolkit | Zustand 4.4 | Jotai 2.4 |
|---|---|---|---|---|
| 包体积(gzip) | 0 | ~13KB | ~1.2KB | ~3.5KB |
| 重渲染粒度 | Provider 级 | selector 级 | selector 级 | atom 级 |
| 样板代码 | 少 | 多(slice/store) | 少 | 少 |
| 异步支持 | 手动 | createAsyncThunk | 直接在 store 里写 | 需配合工具 |
| 迁移成本 | - | 高 | 低 | 中 |
Redux Toolkit 功能最全,但对我们这种"只想要个能按需订阅的全局 store"的场景,样板代码太重。Jotai 的 atom 模型很优雅,但团队里一半人对原子化状态不熟,迁移期沟通成本高。
最终选 Zustand,核心理由是:API 极简、天然支持 selector 精确订阅、可以在 store 外部直接读写(方便在非组件逻辑里用)、迁移时能和老 Context 并存。
我们的迁移策略是"渐进式替换",不是一把梭:
- 先建 store,把字典缓存、用户信息这类"读多写少"的数据搬过去;
- 再把筛选条件这类"高频写"的状态搬过去,这是性能收益最大的部分;
- 最后清理 Context Provider 和 Props 透传,删掉废弃代码。
四、核心实现
4.1 建 store 与类型定义
先装依赖:
npm i zustand@4.4.1
我们按领域拆了两个 store:useUserStore 和 useFilterStore。以筛选条件为例,核心代码如下(可直接运行,配合 React 18):
// stores/filterStore.ts
import { create } from 'zustand';
import { subscribeWithSelector } from 'zustand/middleware';
export interface FilterState {
keyword: string;
status: 'all' | 'active' | 'closed';
page: number;
pageSize: number;
setKeyword: (v: string) => void;
setStatus: (v: FilterState['status']) => void;
setPage: (v: number) => void;
reset: () => void;
}
const initialState = {
keyword: '',
status: 'all' as const,
page: 1,
pageSize: 20,
};
export const useFilterStore = create()(
subscribeWithSelector((set) => ({
...initialState,
setKeyword: (keyword) => set({ keyword, page: 1 }),
setStatus: (status) => set({ status, page: 1 }),
setPage: (page) => set({ page }),
reset: () => set(initialState),
}))
);
这里用了 subscribeWithSelector 中间件,后面在非组件逻辑里做细粒度订阅会用到。注意 setKeyword 里顺手把 page 重置为 1,这是原来 Context 版本里容易漏掉的逻辑,放进 store 反而更集中。
4.2 组件侧按需订阅
迁移前,组件是这么拿数据的:
// 迁移前:Context 版本
const { keyword, status } = useFilterContext();
只要 Context value 变了,这个组件就重渲染,哪怕它只用 status。迁移后改成 selector 订阅:
// 迁移后:Zustand 版本
import { useFilterStore } from '@/stores/filterStore';
function StatusSelect() {
// 只订阅 status 和 setStatus,keyword 变化不会触发本组件渲染
const status = useFilterStore((s) => s.status);
const setStatus = useFilterStore((s) => s.setStatus);
return (
setStatus(e.target.value as any)}>
全部
进行中
已结束
);
}
关键点:selector 的返回值要用原始类型或稳定引用。如果写成 useFilterStore((s) => ({ status: s.status })),每次返回新对象,Zustand 默认用 Object.is 比较,会认为一直变化,反而造成无谓渲染。这种情况要么拆成两次订阅,要么用 useShallow(Zustand 4.4 提供)。
4.3 在非组件逻辑里读写
这是 Zustand 相比 Context 最舒服的地方。比如埋点上报、请求拦截器里要读当前筛选条件,直接 useFilterStore.getState():
// utils/track.ts
import { useFilterStore } from '@/stores/filterStore';
export function trackFilterChange(source: string) {
const { keyword, status, page } = useFilterStore.getState();
window.__track__?.('filter_change', { source, keyword, status, page });
}
// 细粒度订阅:只在 page 变化时触发,用于同步到 URL query
useFilterStore.subscribe(
(s) => s.page,
(page) => {
const url = new URL(window.location.href);
url.searchParams.set('page', String(page));
window.history.replaceState(null, '', url.toString());
}
);
这段订阅逻辑放在模块顶层执行一次即可,替代了原来在组件 useEffect 里同步 URL 的写法,少了一个 effect 依赖数组的坑。
五、踩坑与优化
迁移过程中踩了几个坑,记录一下:
坑 1:selector 返回新对象导致无限渲染。 有同事写了 useFilterStore((s) => s.list.filter(...)),每次返回新数组,组件疯狂重渲染。解决方式是改用 useShallow 包裹,或者把派生数据放到 useMemo 里基于原始字段计算。
坑 2:和老 Context 并存期间状态不同步。 迁移中途,一部分组件读 Context,一部分读 store,出现过筛选条件"两边不一致"。我们的处理是:迁移期间以 store 为单一数据源,Context 的 value 直接从 useFilterStore 里取,等于给老组件做了个适配层,全部迁移完再删掉 Context。
坑 3:批量更新。 有些场景要连续 set 多个字段(比如重置筛选),早期写法是连续调三次 setter,触发三次通知。改成一次 set({...}) 合并更新,或者用 useFilterStore.setState 批量改。
优化项:列表页的 pageSize 原来放在组件 state 里,现在统一进 store,配合 subscribeWithSelector 做 URL 同步;另外给 store 加了 devtools 中间件(仅开发环境),排查状态变更方便很多。
六、效果数据
迁移覆盖了 40+ 页面模块中的 3 个核心 Context 和约 60 处 Props 透传。用 React DevTools Profiler 在同一条筛选交互路径上对比(4x CPU 节流,取 10 次中位数):
| 指标 | 迁移前(Context) | 迁移后(Zustand) | 变化 |
|---|---|---|---|
| 单次筛选变更重渲染组件数 | 236 | 34 | -85.6% |
| 交互 INP | 320ms | 121ms | -62.2% |
| 列表页首屏 JS 执行时间 | 410ms | 395ms | 基本持平 |
| 状态相关样板代码行数 | ~1800 | ~900 | -50% |
说明一下:首屏 JS 执行时间基本没变,因为瓶颈在接口和表格渲染,状态管理不是主因;真正的收益在交互响应和代码可维护性上。另外包体积因为引入 Zustand 增加了约 1.2KB gzip,可以忽略。
七、总结
这次迁移给我的几点体会:
- Context 适合低频、全局、读多写少的数据(主题、用户信息),不适合高频变更的列表筛选、表单联动。选型时先想清楚数据的写入频率。
- 渐进式迁移比一次性重写稳。用 store 做单一数据源、Context 做适配层,能让新旧代码并存,降低回归风险。
- selector 的写法直接决定性能。Zustand 的精确订阅是优势,但前提是 selector 返回稳定引用,否则优势变劣势。
- 如果团队对原子化状态熟悉,Jotai 也值得一试;但对多数中台项目,Zustand 的性价比很高。
如果你的项目也在被 Context 重渲染困扰,建议先用 Profiler 量化一下问题,再决定要不要迁移——数据比感觉可靠。