一、问题背景:Context 不是万能药

项目是一个面向企业内部运营的中台系统,React 18.2 + TypeScript 4.9 + Vite 4.3,状态管理最初用的是最朴素的方案:局部状态用 Props 传递,跨组件共享的数据(用户信息、权限、全局筛选条件、字典缓存)放进了三个 Context。

一开始没问题。真正开始疼是在业务扩张之后:

  1. Provider 嵌套变深。AuthContext → PermissionContext → FilterContext → DictContext,最外层页面要包四层 Provider,新同事看到这段代码第一反应是"这啥"。
  2. 全局重渲染。FilterContext 里存的是列表页的筛选条件,只要改一个下拉框,Provider 下的所有消费者全部重渲染。我们用 React DevTools Profiler 抓了一次,单次筛选变更触发了 236 个组件 render,其中真正需要更新的只有 12 个。
  3. 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 并存。

我们的迁移策略是"渐进式替换",不是一把梭:

  1. 先建 store,把字典缓存、用户信息这类"读多写少"的数据搬过去;
  2. 再把筛选条件这类"高频写"的状态搬过去,这是性能收益最大的部分;
  3. 最后清理 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,可以忽略。

七、总结

这次迁移给我的几点体会:

  1. Context 适合低频、全局、读多写少的数据(主题、用户信息),不适合高频变更的列表筛选、表单联动。选型时先想清楚数据的写入频率。
  2. 渐进式迁移比一次性重写稳。用 store 做单一数据源、Context 做适配层,能让新旧代码并存,降低回归风险。
  3. selector 的写法直接决定性能。Zustand 的精确订阅是优势,但前提是 selector 返回稳定引用,否则优势变劣势。
  4. 如果团队对原子化状态熟悉,Jotai 也值得一试;但对多数中台项目,Zustand 的性价比很高。

如果你的项目也在被 Context 重渲染困扰,建议先用 Profiler 量化一下问题,再决定要不要迁移——数据比感觉可靠。