一、问题背景:Context 不是银弹,Props 更不是
我们维护的是一个面向企业客户的数据看板系统,前端采用微前端架构:主应用是 React 18.2,两个子模块分别用 React 18.2 和 Vue 3.4 编写,通过 qiankun 2.10 挂载。项目初期为了"轻量",状态管理策略是:
- 跨组件传值:Props 逐层透传,最深达到 6 层;
- 全局共享(用户信息、主题、权限):React Context +
useContext,Vue 侧用provide/inject。
一开始没问题。但业务迭代到第 8 个月,问题集中爆发:
- 重渲染失控。一个 Context 里塞了用户信息、字典数据、筛选条件三块内容,任何一块变化都会让所有
useContext的组件重渲染。用 React Profiler 录了一次筛选切换,commit 阶段耗时 186ms,重渲染组件数 47 个,其中 38 个与筛选条件无关。 - Props 地狱。
到中间隔了 4 层纯布局组件,每层都要写filters={filters} onFilterChange={...},改一个字段要动 5 个文件。 - Vue 侧同类问题。
provide/inject的响应式对象被注入后,任何字段变更都会触发注入组件更新,且 inject 的依赖关系在 DevTools 里不可见,排查困难。 - 调试成本高。Context 的值没有时间旅行能力,线上偶发的"筛选条件错乱"问题只能靠加日志复现。
团队讨论后决定:引入专门的状态管理库。React 侧选 Zustand,Vue 侧选 Pinia。选型理由见下一节。
二、环境与版本
| 依赖 | 版本 | 说明 |
|---|---|---|
| react / react-dom | 18.2.0 | 并发特性可用 |
| vue | 3.4.21 | Composition API |
| zustand | 4.5.2 | 含 useShallow |
| pinia | 2.1.7 | 配合 pinia-plugin-persistedstate 3.2.1 |
| vite | 5.2.8 | 构建 |
| qiankun | 2.10.16 | 微前端 |
| typescript | 5.4.3 | strict 模式 |
Node 18.19.0,包管理 pnpm 8.15.4。
三、方案设计:为什么是 Zustand + Pinia
先上对比表(基于我们项目的实际约束:包体积敏感、需要 TS 类型推导、需要跨微应用共享、团队 6 人):
| 维度 | Context/Props | Redux Toolkit 2.2 | Zustand 4.5 | Pinia 2.1 | MobX 6.12 |
|---|---|---|---|---|---|
| 包体积(gzip) | 0 | ~13KB | ~1.2KB | ~2.5KB | ~16KB |
| 重渲染粒度 | 组件树级 | 选择器级 | 选择器级 | 属性级 | 观察者级 |
| 样板代码 | 少 | 多 | 极少 | 少 | 中 |
| TS 推导 | 一般 | 好 | 优秀 | 优秀 | 好 |
| DevTools | 无 | 强 | 有(devtools 中间件) | 强 | 强 |
| 学习成本 | 低 | 高 | 低 | 低 | 中 |
结论:Redux Toolkit 对我们这种"没有复杂异步编排、没有时间旅行强需求"的后台项目来说偏重;MobX 的响应式心智模型和 Vue 侧重复;Zustand 的"store 就是一个 hook"模型与 React 心智最贴合,且能通过 useStore.getState() 在非组件环境(如 axios 拦截器)读写;Pinia 是 Vue 官方推荐,DevTools 体验好,与 Composition API 天然契合。
架构上我们做了一个关键决定:按领域切片,而不是按页面切片。最终 store 划分为:
useUserStore:登录态、用户信息、权限码;useDictStore:字典数据,带缓存与 TTL;useFilterStore:各页面的筛选条件,按pageKey分桶;useUIStore:主题、侧边栏折叠、全局 loading。
跨微应用共享只保留 user 和 dict 两个 store,通过 qiankun 的 initGlobalState 同步到 Vue 子应用,避免两套 store 重复请求。
四、核心实现
4.1 React 侧:从 Context 到 Zustand
迁移前的 Context 写法(节选):
// 迁移前:一个 Context 塞三块数据,任何变更全量重渲染
const AppContext = createContext(null);
export function AppProvider({ children }: { children: ReactNode }) {
const [user, setUser] = useState(null);
const [dict, setDict] = useState>({});
const [filters, setFilters] = useState({});
const value = useMemo(
() => ({ user, setUser, dict, setDict, filters, setFilters }),
[user, dict, filters]
);
return {children};
}
// 任意组件
const { filters, setFilters } = useContext(AppContext)!; // 依赖整个 value
迁移后的 Zustand store,以 filter 为例(可直接运行,依赖仅 zustand):
// stores/filterStore.ts
import { create } from 'zustand';
import { devtools, subscribeWithSelector } from 'zustand/middleware';
import { useShallow } from 'zustand/react/shallow';
export interface Filters {
keyword: string;
dateRange: [string, string] | null;
status: string[];
}
interface FilterState {
buckets: Record;
setFilter: (pageKey: string, patch: Partial) => void;
resetFilter: (pageKey: string) => void;
}
const EMPTY: Filters = { keyword: '', dateRange: null, status: [] };
export const useFilterStore = create()(
devtools(
subscribeWithSelector((set) => ({
buckets: {},
setFilter: (pageKey, patch) =>
set(
(s) => ({
buckets: {
...s.buckets,
[pageKey]: { ...(s.buckets[pageKey] ?? EMPTY), ...patch },
},
}),
false,
`filter/${pageKey}/set`
),
resetFilter: (pageKey) =>
set(
(s) => ({ buckets: { ...s.buckets, [pageKey]: EMPTY } }),
false,
`filter/${pageKey}/reset`
),
})),
{ name: 'FilterStore', enabled: import.meta.env.DEV }
)
);
// 组件内使用:选择器精确订阅,避免无关重渲染
export function usePageFilters(pageKey: string) {
// useShallow 做浅比较,返回新对象也不会无限重渲染
return useFilterStore(
useShallow((s) => s.buckets[pageKey] ?? EMPTY)
);
}
export function useSetFilter(pageKey: string) {
return useFilterStore((s) => s.setFilter);
}
组件中的调用:
function FilterPanel({ pageKey }: { pageKey: string }) {
const filters = usePageFilters(pageKey);
const setFilter = useSetFilter(pageKey);
// 只有 filters 变化才重渲染,user/dict 变更完全不影响
return (
setFilter(pageKey, { keyword: e.target.value })}
/>
);
}
关键点有三个:
- 每个字段一个选择器,或者用
useShallow包一层,杜绝"返回新对象导致无限重渲染"; - action 单独订阅(
useSetFilter),因为 action 引用稳定,组件不会因 action 变化重渲染; subscribeWithSelector中间件让我们能在非组件代码里做细粒度订阅,比如埋点:
// 埋点:只在 keyword 变化时上报,不触发任何组件渲染
useFilterStore.subscribe(
(s) => s.buckets['order-list']?.keyword,
(kw, prev) => track('filter_keyword_change', { from: prev, to: kw })
);
4.2 Vue 侧:从 provide/inject 到 Pinia
迁移前的 provide/inject:
// 迁移前
const filterCtx = reactive({ filters: {}, setFilter: (p) => Object.assign(filterCtx.filters, p) });
provide('filterCtx', filterCtx);
// 子组件
const ctx = inject('filterCtx')!; // 任何字段变更都触发更新
迁移后的 Pinia store(可直接运行):
// stores/filter.ts
import { defineStore } from 'pinia';
import { ref, computed } from 'vue';
export interface Filters {
keyword: string;
dateRange: [string, string] | null;
status: string[];
}
const EMPTY: Filters = { keyword: '', dateRange: null, status: [] };
export const useFilterStore = defineStore('filter', () => {
const buckets = ref>({});
const getFilters = computed(() => (pageKey: string) => buckets.value[pageKey] ?? EMPTY);
function setFilter(pageKey: string, patch: Partial) {
buckets.value[pageKey] = { ...(buckets.value[pageKey] ?? EMPTY), ...patch };
}
function resetFilter(pageKey: string) {
buckets.value[pageKey] = { ...EMPTY };
}
return { buckets, getFilters, setFilter, resetFilter };
});
组件内使用 storeToRefs 保持解构后的响应性:
import { storeToRefs } from 'pinia';
import { computed } from 'vue';
import { useFilterStore } from '@/stores/filter';
const props = defineProps();
const store = useFilterStore();
const { buckets } = storeToRefs(store);
const filters = computed(() => buckets.value[props.pageKey] ?? { keyword: '', dateRange: null, status: [] });
五、踩坑与优化
迁移过程并非一帆风顺,记录 5 个真实踩到的坑:
坑 1:Zustand 选择器返回新对象导致无限重渲染。
最初写 useFilterStore((s) => ({ ...s.buckets[key] })),每次返回新引用,React 认为状态变了,死循环。解决:用 useShallow 或拆成原子选择器。这个问题在 React 18 StrictMode 下会以"Maximum update depth exceeded"暴露。
坑 2:Pinia 解构丢失响应性。
const { buckets } = useFilterStore() 解构后 buckets 变成普通值。必须用 storeToRefs。团队里两个人踩了同一个坑,后来在 ESLint 加了 pinia/no-destructure-store 规则。
坑 3:微应用间 store 不同步。
主应用改 userStore,Vue 子应用读到的还是旧值。解决:在主应用 subscribe 里调 props.setGlobalState,子应用 onGlobalStateChange 回调里写回自己的 store,并加 _fromMaster 标记防环。
坑 4:字典缓存 TTL 与并发请求。
useDictStore 的 fetchDict 最初没做去重,页面同时挂载 8 个图表组件,发了 8 次同样的字典请求。加了 in-flight Promise 缓存:pending[key] ??= request(key),请求数从 8 降到 1。
坑 5:DevTools 生产环境泄漏。
Zustand 的 devtools 中间件忘了加 enabled: import.meta.env.DEV,生产包多打 4KB 且暴露 action 名。加上开关后恢复正常。
优化方面还做了两件事:一是把 filterStore 的 setFilter 加了 100ms 防抖(在 Input 的 onChange 里),输入框打字时重渲染次数从每次按键 1 次降到每 100ms 最多 1 次;二是给图表组件加了 React.memo + 稳定的 selector,配合 Zustand 后基本只在数据变化时渲染。
六、效果数据
测试环境:Chrome 120,MacBook Pro M1,16GB,Lighthouse 移动端模拟(4G 降速)。测试页面为订单列表页(含 6 个图表、1 个表格、筛选面板)。
| 指标 | 迁移前(Context/Props) | 迁移后(Zustand/Pinia) | 变化 |
|---|---|---|---|
| 筛选切换 commit 耗时 | 186ms | 41ms | -78% |
| 单次交互重渲染组件数 | 47 | 9 | -81% |
| LCP | 2.8s | 1.4s | -50% |
| TTI | 3.6s | 2.1s | -42% |
| 首屏 JS(gzip) | 412KB | 415.2KB | +3.2KB |
| TBT | 380ms | 150ms | -60% |
| 字典重复请求数 | 8 | 1 | -87.5% |
React Profiler 火焰图对比最直观:迁移前筛选切换会点亮大半棵组件树,迁移后只有 FilterPanel、OrderTable 和两个受筛选影响的图表变红。Vue DevTools 的 Pinia 面板也让状态变更链路一目了然,之前排查"筛选条件错乱"平均要 40 分钟,现在看 action 时间线 5 分钟内能定位。
需要说明的是,LCP 的大幅下降不完全归功于状态库——迁移过程中顺手拆了 Context 导致的同步渲染阻塞,并给图表做了懒加载。但重渲染次数的下降是实打实的,commit 耗时从 186ms 到 41ms 这一项可以单独归因。
七、总结
如果你的项目满足以下任意两条,Context/Props 就够用,别急着上库:全局状态少于 5 个字段、组件层级不超过 3 层、没有跨页面共享的筛选/缓存需求。
反之,像我们这样"Context 里塞了三块数据、Props 透传 6 层、微前端要共享登录态"的场景,迁移收益非常明确:重渲染降 80%、交互耗时降 78%、包体积只增加 3KB。选型上,React 选 Zustand 的核心原因是"store 即 hook"的心智负担最低,且 getState/subscribe 让非组件环境读写很自然;Vue 选 Pinia 没有悬念。
迁移步骤建议按这个顺序来,风险最低:
- 先迁只读的全局数据(用户信息、字典),验证 store 基础设施;
- 再迁页面级筛选状态,这一步收益最大,因为它是重渲染的主要来源;
- 最后删 Context/Provider,清理 Props 透传,同步补 ESLint 规则防回退;
- 每一步都保留旧实现一个迭代周期,用 feature flag 切换,出问题能回滚。
最后一句实话:状态管理库解决的是"状态该放哪、谁该更新"的组织问题,不是性能问题的万能药。我们这次能拿到 78% 的耗时下降,一半功劳在库,一半功劳在迁移时被迫重新梳理了状态边界——那些混在 Context 里的派生状态和副作用,才是真正的性能杀手。