一、问题背景:Context 不是银弹
我们项目是一个中后台管理系统,React 18.2.0 + TypeScript 5.3 + Vite 4.5,状态管理最初用的是最朴素的方式:局部状态用 useState,跨层级用 Props 透传,全局状态(用户信息、权限、主题、字典缓存)用 Context。
这套组合在项目早期完全够用,但随着业务膨胀,问题开始集中爆发:
- Props Drilling 太深。一个订单详情页,从 Page 到最底层的 OrderStatusTag,中间要穿过 6 层组件,每层都在透传
user、permissions、dictMap三个对象。改一个字段名要改 6 个文件。 - Context 重渲染失控。我们的
AppContext里同时放了 user、theme、dict、notification 四类数据。任何一处 setState,所有useContext(AppContext)的组件全部重渲染。用 React DevTools Profiler 抓了一次「切换主题」的操作,提交阶段渲染了 218 个组件,其中真正需要更新的只有 12 个。 - 逻辑分散。同一个 dict 缓存,A 页面在 useEffect 里请求,B 页面又写了一遍,C 页面用 Context 里的。三份数据源,缓存不一致的 bug 出现过两次。
我们统计了一下:全项目 useContext 调用点 63 处,Props 透传链超过 3 层的组件 29 个,与状态相关的重复请求逻辑 8 处。这时候就决定:迁移。
二、环境与版本
- React 18.2.0 / ReactDOM 18.2.0
- TypeScript 5.3.3
- Vite 4.5.0
- 迁移前:React Context(内置)
- 迁移后:Zustand 4.4.7
- 辅助:
zustand/middleware的 persist、devtools;use-sync-external-store由 Zustand 内部处理 - 性能测量:Chrome 120 + React DevTools Profiler + Lighthouse 11
选 Zustand 而不是 Redux Toolkit / Jotai / MobX,理由在下一节说。
三、方案设计:为什么是 Zustand
我们横向对比了四个候选:
| 方案 | 包体积(gzip) | 学习成本 | 选择器粒度 | 与 Context 迁移成本 | 结论 |
|---|---|---|---|---|---|
| Redux Toolkit | ~13KB | 中高 | 需 reselect | 高,样板代码多 | 团队已有历史包袱,放弃 |
| Zustand | ~1.2KB | 低 | 天然支持 selector | 低,API 极简 | 采用 |
| Jotai | ~4KB | 中 | atom 级 | 中,需重构成原子 | 适合细粒度,但重构量大 |
| MobX | ~16KB | 高 | observer 自动追踪 | 中,需装饰器/配置 | 团队不熟,放弃 |
核心决策点有三个:
- 选择器粒度。Zustand 的
useStore(state => state.xxx)天然按字段订阅,只有选中的切片变化才触发重渲染,正好解决 Context 全量重渲染的问题。 - 迁移成本。Zustand 的 store 就是一个普通对象 + set 函数,我们可以在不改变组件结构的前提下,把
useContext(AppContext)逐个替换成useAppStore(s => s.user),可以按模块灰度迁移,不用一次性推倒。 - 无需 Provider。Zustand 的 store 是模块级单例,不需要在根节点包 Provider,省掉一层嵌套,也避免了 Provider 嵌套地狱。
Store 拆分设计:按业务域拆成 4 个 store——useUserStore(用户+权限)、useThemeStore(主题,persist 到 localStorage)、useDictStore(字典缓存,带 TTL)、useNotificationStore(消息)。跨 store 读取用 getState() 或在组件里分别订阅,不搞大杂烩。
四、核心实现
4.1 Store 定义(带 persist 和 devtools)
// src/stores/userStore.ts
import { create } from 'zustand';
import { devtools } from 'zustand/middleware';
interface UserInfo {
id: string;
name: string;
avatar: string;
}
interface UserState {
user: UserInfo | null;
permissions: string[];
setUser: (user: UserInfo | null) => void;
setPermissions: (perms: string[]) => void;
hasPermission: (code: string) => boolean;
}
export const useUserStore = create()(
devtools(
(set, get) => ({
user: null,
permissions: [],
setUser: (user) => set({ user }, false, 'user/setUser'),
setPermissions: (permissions) =>
set({ permissions }, false, 'user/setPermissions'),
hasPermission: (code) => get().permissions.includes(code),
}),
{ name: 'UserStore', enabled: import.meta.env.DEV }
)
);
注意 create()(...) 的柯里化写法,这是 Zustand 4.x 配合 TS 中间件的标准写法,不这么写 devtools 的类型会丢。set 的第三个参数是 devtools 的 action name,方便在 Redux DevTools 里追踪。
4.2 字典 Store:带 TTL 的缓存
// src/stores/dictStore.ts
import { create } from 'zustand';
const TTL = 5 * 60 * 1000; // 5 分钟
interface DictEntry {
data: Record;
fetchedAt: number;
}
interface DictState {
cache: Record;
loading: Record;
fetchDict: (type: string) => Promise;
getDict: (type: string) => Record;
}
export const useDictStore = create((set, get) => ({
cache: {},
loading: {},
fetchDict: async (type) => {
const { cache, loading } = get();
const entry = cache[type];
if (loading[type]) return;
if (entry && Date.now() - entry.fetchedAt ({ loading: { ...s.loading, [type]: true } }));
try {
const res = await fetch(`/api/dict/${type}`);
const data = await res.json();
set((s) => ({
cache: { ...s.cache, [type]: { data, fetchedAt: Date.now() } },
loading: { ...s.loading, [type]: false },
}));
} catch (e) {
set((s) => ({ loading: { ...s.loading, [type]: false } }));
throw e;
}
},
getDict: (type) => get().cache[type]?.data ?? {},
}));
这里有个细节:loading 的判断放在最前面,防止并发重复请求——原来 Context 版本里两个组件同时 mount 会发两次请求,这是老 bug,顺手修了。
4.3 组件侧迁移:从 useContext 到 selector
迁移前:
const { user, theme, dictMap } = useContext(AppContext);
迁移后:
const user = useUserStore((s) => s.user);
const theme = useThemeStore((s) => s.theme);
const dictMap = useDictStore((s) => s.cache['orderStatus']?.data);
关键原则:一个组件订阅几个字段就写几个 selector,不要 const store = useUserStore() 整体订阅——那等于回到 Context 的老路。如果确实需要多个字段,用 useShallow:
import { useShallow } from 'zustand/react/shallow';
const { user, permissions } = useUserStore(
useShallow((s) => ({ user: s.user, permissions: s.permissions }))
);
useShallow 是 Zustand 4.4 引入的(替代旧的 shallow 比较函数写法),做浅比较,避免每次返回新对象导致重渲染。
对于非组件环境(比如 axios 拦截器里要拿 token),直接用 useUserStore.getState().user,不需要 hook。
五、踩坑与优化
坑 1:selector 返回新对象导致无限重渲染。 一开始写了 useDictStore(s => s.cache[type] ?? {}),每次返回新的 {},浅比较永远不等,组件疯狂重渲染。改成返回 undefined 再在组件里兜底,或者把空对象常量提到模块顶层。
坑 2:persist 的 rehydrate 时序。 主题 store 用了 persist,SSR/hydrate 场景下首帧拿到的还是默认值。解决:在入口处 await useThemeStore.persist.rehydrate(),或者用 onRehydrateStorage 回调控制渲染时机。
坑 3:批量更新。 迁移初期有个页面在 useEffect 里连续调了 4 次 setState,触发了 4 次渲染。Zustand 4.x 在 React 18 的 automatic batching 下,同一事件循环内的多次 set 会被合并,但跨 await 的不会。我们把关联的 set 合并成一个 action,减少到 1 次。
坑 4:devtools 在生产被打包。 忘了加 enabled: import.meta.env.DEV,devtools 中间件进了生产包。加上后 gzip 体积回到 1.2KB。
优化:selector 稳定化。 对于派生数据(如「已选中的订单列表」),用 useMemo 或在 store 里预计算,避免在 selector 里做 filter/map——selector 每次渲染都会执行,重计算会拖慢渲染。
六、效果数据
迁移分三批灰度,历时两周,覆盖 47 个组件、12 个模块。用 Lighthouse 和 React Profiler 在相同设备(M1 MacBook,Chrome 120,4x CPU 降速)下对比:
| 指标 | 迁移前(Context) | 迁移后(Zustand) | 变化 |
|---|---|---|---|
| 首屏 TTI | 3.2s | 1.9s | -40.6% |
| 单次交互平均渲染组件数 | 218 | 83 | -61.9% |
| 主题切换提交耗时 | 46ms | 11ms | -76.1% |
| 状态相关代码行数 | ~2400 | ~1300 | -45.8% |
| 重复请求 bug | 8 处 | 0 | 消除 |
| 包体积增量(gzip) | 0 | +1.2KB | 可接受 |
最直观的是主题切换:原来点一下,整个页面肉眼可见地卡一下(46ms 提交 + 218 个组件重渲染),现在基本无感。字典缓存的重复请求也彻底没了。
七、总结
Context 适合低频、全局、变化不频繁的数据(比如用户信息、i18n),一旦数据高频变化或者订阅者众多,它的全量广播模型就是性能杀手。Zustand 用 selector 订阅 + 模块级单例,把「谁订阅谁更新」这件事做对了,迁移成本也低——我们基本是机械替换 useContext 为 useStore(s => ...),没有改组件结构。
几点建议给准备迁移的同行:一是按业务域拆 store,别搞一个大 store;二是严格用 selector,禁止整体订阅;三是派生数据尽量在 store 里算好或用 useShallow;四是迁移可以灰度,Zustand 和 Context 能共存,不用一刀切。
如果你们项目也是 Context 满天飞、Profiler 一片红,值得花一周试一下。至少我们这 47 个组件的重构,回本只用了一个迭代。