一、问题背景:Context 不是不能用,是我们用错了

先说结论:React Context 本身没问题,问题在于我们把 Context 当成了"全局状态管理器"在用。

项目是一个 React 18.2 + TypeScript 5.3 的中后台系统,2022 年起步时只有 10 来个页面,当时团队约定:

  • 组件内部状态用 useState
  • 跨 2-3 层的用 Props
  • 真正全局的(用户信息、主题、权限)用 Context

听起来很合理。但两年后页面涨到 60+,Context 从 3 个变成了 11 个,其中 FilterContext、TableDataContext、GlobalUIContext 这三个成了重灾区。典型的问题是:

// 典型的"Context 全家桶"写法
const FilterContext = createContext({});

function FilterProvider({ children }) {
  const [filters, setFilters] = useState({});
  const [options, setOptions] = useState({});
  const [loading, setLoading] = useState(false);
  // ...还有 5 个 useState

  const value = useMemo(
    () => ({ filters, options, loading, setFilters, setOptions, ... }),
    [filters, options, loading]
  );

  return {children};
}

问题在于:只要 value 里任何一个字段变化,所有 useFilter() 的消费者都会重渲染。我们在列表页做了埋点统计,一个筛选条件变更,触发了 217 个组件重渲染,其中真正需要更新的只有 30 个左右。React DevTools Profiler 显示这次交互耗时 340ms,用户能明显感觉到卡顿。

Props 的问题更直接:有个详情页,从路由组件到最底层的操作按钮,Props 传了 9 层,中间 6 个组件根本不关心这个数据,纯粹是"搬运工"。改一个字段名要动 7 个文件。

到这一步,迁移就不得不做了。

二、环境与版本:先把基线定清楚

迁移前记录一下环境,避免后面数据对不上:

  • React 18.2.0(并发特性已开启)
  • TypeScript 5.3.3
  • Vite 5.0.10
  • 状态管理候选:Zustand 4.4.7、Jotai 2.6.0、Redux Toolkit 2.0.0
  • 性能测试工具:React DevTools Profiler + 自研的 renderCount HOC
  • 测试页面:订单列表页(约 1200 行,21 个组件,含虚拟滚动表格)

基线数据(迁移前,Chrome 120,M1 MacBook Pro):

指标 数值
筛选条件变更触发重渲染组件数 217
该交互平均耗时 340ms
列表页首次可交互时间 1.8s
详情页 Props 传递层数 9 层

三、方案设计:为什么最后选了 Zustand

我们对比了三个方案,维度是团队熟悉度、样板代码量、重渲染控制能力、迁移成本。

Redux Toolkit:生态最成熟,但样板代码多,我们的场景没有复杂的时间旅行调试需求,团队里一半人没写过 RTK,迁移成本偏高。而且 RTK 的 selector 需要手动写 shallowEqual,容易踩坑。

Jotai:原子化思路很优雅,重渲染控制天然好,但我们的状态很多是"关联的一组"(比如筛选条件 + 分页 + 排序),拆成原子后组合逻辑反而变复杂,团队接受度一般。

Zustand:API 极简,create 一个 store 就完事,selector 天然支持细粒度订阅,不需要 Provider 包裹,迁移时可以从 Context 平滑过渡。最终选了它,版本锁定 4.4.7。

核心设计原则有三条:

  1. 按业务域拆 store,不搞一个大 store。我们拆成了 useFilterStore、useUserStore、useUIStore、useTableStore 四个。
  2. selector 必须细粒度,禁止 useStore() 不带 selector,ESLint 加规则强制。
  3. 异步逻辑放 store 内,用 middleware 处理 loading/error,组件只管调 action。

四、核心实现:从 Context 到 Zustand 的迁移

4.1 第一步:改造 FilterContext

原来的 Context 是这样用的:

// 迁移前
function OrderList() {
  const { filters, setFilters, loading } = useFilter();
  // 只要 filters 或 loading 变,这个组件就重渲染
}

改成 Zustand 后,store 定义如下:

// stores/filterStore.ts
import { create } from 'zustand';
import { subscribeWithSelector } from 'zustand/middleware';

interface FilterState {
  filters: Record;
  options: Record;
  loading: boolean;
  setFilter: (key: string, value: unknown) => void;
  resetFilters: () => void;
  fetchOptions: (type: string) => Promise;
}

export const useFilterStore = create()(
  subscribeWithSelector((set, get) => ({
    filters: {},
    options: {},
    loading: false,

    setFilter: (key, value) =>
      set((state) => ({
        filters: { ...state.filters, [key]: value },
      })),

    resetFilters: () => set({ filters: {} }),

    fetchOptions: async (type) => {
      set({ loading: true });
      try {
        const data = await api.getOptions(type);
        set((state) => ({
          options: { ...state.options, [type]: data },
          loading: false,
        }));
      } catch (e) {
        set({ loading: false });
      }
    },
  }))
);

组件里改成按字段订阅:

// 迁移后
function OrderList() {
  // 只订阅 filters,loading 变化不触发重渲染
  const filters = useFilterStore((s) => s.filters);
  const setFilter = useFilterStore((s) => s.setFilter);
  // setFilter 引用稳定,不会引起额外渲染
}

这里有个细节值得说:Zustand 的 selector 返回对象时,默认用 Object.is 比较。如果 selector 返回 { a, b } 这种新对象,每次都会判定为变化。我们的做法是一个字段一个 hook 调用,或者用 useShallow:

import { useShallow } from 'zustand/react/shallow';

// 需要同时取多个字段时用 useShallow
const { filters, loading } = useFilterStore(
  useShallow((s) => ({ filters: s.filters, loading: s.loading }))
);

4.2 第二步:消灭 9 层 Props 传递

详情页的 Props 透传,我们改成了组件直接读 store。原来中间 6 个"搬运工"组件全部删掉了对应的 Props 声明,代码量少了约 200 行。

但这里要注意一个反模式:不要让展示组件直接依赖 store。我们的做法是容器组件读 store,展示组件仍然收 Props。比如:

// 容器组件
function OrderDetailContainer({ orderId }) {
  const order = useOrderStore((s) => s.orders[orderId]);
  const updateStatus = useOrderStore((s) => s.updateStatus);
  return ;
}

// 展示组件保持纯粹,可测试
function OrderDetailView({ order, onUpdateStatus }) {
  // ...
}

这样既解决了透传问题,又没把 store 耦合进 UI 层。

4.3 第三步:异步逻辑收口

原来每个页面都自己写 useState(loading) + try/catch,重复代码很多。迁移时我们把异步逻辑收进 store,组件里只剩一行调用:

function FilterBar() {
  const fetchOptions = useFilterStore((s) => s.fetchOptions);
  const loading = useFilterStore((s) => s.loading);

  useEffect(() => {
    fetchOptions('status');
  }, [fetchOptions]);

  return ;
}

五、踩坑与优化:几个真实翻车现场

坑 1:selector 返回新对象导致无限重渲染

一开始有人写了 useFilterStore((s) => ({ filters: s.filters, options: s.options })),结果组件无限渲染。原因是每次 selector 执行都返回新对象,Object.is 判定为变化。解决方案就是上面说的 useShallow,并在 ESLint 里加了 zustand/no-unstable-selector 类似规则(社区插件,也可以自己写)。

坑 2:store 里的 action 引用不稳定

有同事在组件里这样写:

// 错误示范
const { setFilter } = useFilterStore((s) => ({ setFilter: s.setFilter }));

返回新对象,导致依赖 setFilter 的 useEffect 每次执行。正确写法是单独取 action,或者用 useShallow。Zustand 的 action 在 store 创建时就固定了引用,单独取出来是稳定的。

坑 3:测试环境需要重置 store

单测里 store 是模块级单例,用例之间会互相污染。我们在 setupTests.ts 里加了:

import { useFilterStore } from '@/stores/filterStore';

beforeEach(() => {
  useFilterStore.setState(useFilterStore.getInitialState(), true);
});

getInitialState() 是 Zustand 4.4 提供的,配合 true 参数做整体替换,比手动 reset 干净。

优化:用 subscribeWithSelector 做副作用解耦

有些逻辑需要在特定字段变化时触发(比如筛选条件变了要重新请求列表),但不想引起组件重渲染。我们用 subscribeWithSelector 在 store 外部订阅:

useFilterStore.subscribe(
  (s) => s.filters,
  (filters) => {
    useTableStore.getState().fetchList(filters);
  }
);

这段代码放在模块初始化处,组件完全感知不到,重渲染次数为 0。

六、效果数据:重渲染降了 87%

迁移完成后,用同样的 Profiler 脚本跑了一遍订单列表页(Chrome 120,M1 MacBook Pro,数据取 10 次平均值):

指标 迁移前 迁移后 变化
筛选变更重渲染组件数 217 28 -87%
该交互平均耗时 340ms 95ms -72%
列表页首次可交互 1.8s 1.1s -39%
详情页 Props 层数 9 层 2 层 -78%
相关代码行数 — — 减少约 460 行

代码行数减少主要来自两块:删掉的 Props 声明(约 200 行)和重复的 loading/error 处理逻辑(约 260 行)。

另外有个意外收获:迁移后新人上手成本降低了。以前新人要理解 11 个 Context 的嵌套关系和依赖,现在打开 stores/ 目录,4 个文件一目了然。

七、总结

这次迁移我的几点体会:

  1. Context 适合低频、稳定的全局数据(主题、用户信息、国际化),不适合高频变化、多组件消费的业务状态。判断标准很简单:如果一个 Context 的 value 里包含了频繁变化的字段,就该考虑换方案了。
  2. Zustand 的优势不在功能多,而在心智负担小。create + selector 两个概念就能覆盖 90% 场景,迁移时可以从一个 Context 开始灰度,不用一次性重构。
  3. selector 粒度是性能的关键。同样的 Zustand,写法和 Context 一样粗放,性能也好不到哪去。我们后来把"禁止无 selector 调用"写进了 Code Review checklist。
  4. 迁移不是重写。我们花了 3 周,按页面灰度,每个页面迁移后跑一遍 Profiler 对比,有问题随时回滚。如果一开始就想"全量替换",大概率会翻车。

最后说一句:没有银弹。Zustand 解决的是"高频状态 + 细粒度订阅"的问题,如果你的项目 Context 用得克制,其实没必要折腾。但如果你的 Profiler 里已经是一片红,那这篇文章的路径应该能帮到你。