一、问题背景: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。
核心设计原则有三条:
- 按业务域拆 store,不搞一个大 store。我们拆成了
useFilterStore、useUserStore、useUIStore、useTableStore四个。 - selector 必须细粒度,禁止
useStore()不带 selector,ESLint 加规则强制。 - 异步逻辑放 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 个文件一目了然。
七、总结
这次迁移我的几点体会:
- Context 适合低频、稳定的全局数据(主题、用户信息、国际化),不适合高频变化、多组件消费的业务状态。判断标准很简单:如果一个 Context 的 value 里包含了频繁变化的字段,就该考虑换方案了。
- Zustand 的优势不在功能多,而在心智负担小。
create+ selector 两个概念就能覆盖 90% 场景,迁移时可以从一个 Context 开始灰度,不用一次性重构。 - selector 粒度是性能的关键。同样的 Zustand,写法和 Context 一样粗放,性能也好不到哪去。我们后来把"禁止无 selector 调用"写进了 Code Review checklist。
- 迁移不是重写。我们花了 3 周,按页面灰度,每个页面迁移后跑一遍 Profiler 对比,有问题随时回滚。如果一开始就想"全量替换",大概率会翻车。
最后说一句:没有银弹。Zustand 解决的是"高频状态 + 细粒度订阅"的问题,如果你的项目 Context 用得克制,其实没必要折腾。但如果你的 Profiler 里已经是一片红,那这篇文章的路径应该能帮到你。