一、问题背景:Context 不是银弹

我们项目是一个中后台管理系统,React 18.2.0 + TypeScript 5.3 + Vite 4.5,状态管理最初用的是最朴素的方式:局部状态用 useState,跨层级用 Props 透传,全局状态(用户信息、权限、主题、字典缓存)用 Context。

这套组合在项目早期完全够用,但随着业务膨胀,问题开始集中爆发:

  1. Props Drilling 太深。一个订单详情页,从 Page 到最底层的 OrderStatusTag,中间要穿过 6 层组件,每层都在透传 user、permissions、dictMap 三个对象。改一个字段名要改 6 个文件。
  2. Context 重渲染失控。我们的 AppContext 里同时放了 user、theme、dict、notification 四类数据。任何一处 setState,所有 useContext(AppContext) 的组件全部重渲染。用 React DevTools Profiler 抓了一次「切换主题」的操作,提交阶段渲染了 218 个组件,其中真正需要更新的只有 12 个。
  3. 逻辑分散。同一个 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 自动追踪 中,需装饰器/配置 团队不熟,放弃

核心决策点有三个:

  1. 选择器粒度。Zustand 的 useStore(state => state.xxx) 天然按字段订阅,只有选中的切片变化才触发重渲染,正好解决 Context 全量重渲染的问题。
  2. 迁移成本。Zustand 的 store 就是一个普通对象 + set 函数,我们可以在不改变组件结构的前提下,把 useContext(AppContext) 逐个替换成 useAppStore(s => s.user),可以按模块灰度迁移,不用一次性推倒。
  3. 无需 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 个组件的重构,回本只用了一个迭代。