一、问题背景:Props透传和Context堆叠是怎么把我们逼疯的
项目是一个典型的中后台系统,React 18.2 + Vue 3.4 双栈并存(历史原因,老模块Vue,新模块React,通过微前端拼在一起)。状态管理一开始很“朴素”:React侧用Props一层层往下传,跨层级就用Context;Vue侧用provide/inject加props。
问题在业务膨胀后集中爆发:
- Props透传链路太长。一个订单详情页,从Page到最底层的StatusTag组件,中间隔了7层,其中5层组件根本不关心order状态,只是“搬运工”。改一个字段名要动6个文件。
- Context Provider嵌套灾难。React侧全局有UserContext、ThemeContext、PermissionContext、DictContext、LayoutContext……最深的页面嵌套了9层Provider。每次UserContext变化(比如切换租户),整棵子树全部重渲染。我们用React DevTools Profiler测过一次:切换租户时提交阶段耗时142ms,重渲染组件数约120个。
- Vue侧provide/inject的响应式边界模糊。inject进来的ref在子组件里被意外修改,排查了半天才发现是某个孙组件直接改了inject的值,没有走约定的action。
- 状态逻辑散落。同一个“当前选中门店”的状态,在3个Context、2个Vue store文件、若干组件local state里各存了一份,同步靠useEffect和watch, bug频发。
我们统计了一个季度内的bug,约18%和状态不同步、多余渲染相关。这时候迁移到正经状态管理库就被提上日程了。
二、环境与版本
- React 18.2.0,React-Redux 8.1.3(只在一个老模块用),Zustand 4.4.7
- Vue 3.4.21,Pinia 2.1.7
- 构建:Vite 5.1.6
- 性能测量:React DevTools Profiler 4.28、Vue DevTools 6.6、Chrome Performance 面板(Chrome 122)
- 测试机:MacBook Pro M1 16G,节流4x CPU模拟中端机
选型时对比了 Redux Toolkit、Zustand、Jotai、Pinia、Vuex。结论:React侧选Zustand(样板代码少、不需要Provider、selector粒度细),Vue侧选Pinia(Vue官方推荐、Vuex的继任者、TS支持好)。Redux Toolkit对我们这种“从Context迁移”的场景来说心智负担偏重,Jotai的原子化模型对团队学习成本偏高,最终没选。
三、方案设计:迁移不是重写,是分层替换
我们的原则是渐进式迁移,不搞大爆炸重写。具体策略:
React侧(Context → Zustand)
- 按领域拆分store:
useUserStore、usePermissionStore、useDictStore、useLayoutStore,一个领域一个文件,避免单一大store。 - 保留Context作为“注入容器”的场景(比如微前端传下来的theme),但把可变业务状态全部搬到Zustand。
- 组件消费方式统一改成selector:
useUserStore(s => s.tenantId),而不是useUserStore()拿整个state。这是性能的关键。 - 写一个兼容层:迁移期间老的
useContext(UserContext)和新store并存,用feature flag控制,按页面灰度切换。
Vue侧(provide/inject + props → Pinia)
- 按模块建store:
useOrderStore、useUserStore、useDictStore。 - 用setup语法写store,state用ref/reactive,action里只做状态变更,副作用(请求)放外层composable。
- 移除所有“孙组件直接改inject值”的写法,统一走store action。
目录结构(以React为例):
src/
stores/
user.ts
permission.ts
dict.ts
index.ts
四、核心实现(含代码)
4.1 React:从Context到Zustand
迁移前(典型的Context写法,Provider嵌套 + 全量消费):
// 迁移前:UserContext.tsx
import { createContext, useContext, useState } from 'react';
interface UserState {
tenantId: string;
userName: string;
roles: string[];
}
const UserContext = createContext void }>(null!);
export function UserProvider({ children }: { children: React.ReactNode }) {
const [user, setUser] = useState({ tenantId: 't1', userName: '张三', roles: ['admin'] });
const setTenant = (id: string) => setUser(prev => ({ ...prev, tenantId: id }));
return {children};
}
// 组件里:任何字段变化都会让整个消费组件重渲染
export function Header() {
const { userName, setTenant } = useContext(UserContext); // 注意:即使只用userName,tenantId变化也会重渲染
return setTenant('t2')}>{userName};
}
迁移后(Zustand + selector):
// stores/user.ts
import { create } from 'zustand';
interface UserStore {
tenantId: string;
userName: string;
roles: string[];
setTenant: (id: string) => void;
reset: () => void;
}
const initialState = { tenantId: 't1', userName: '张三', roles: ['admin'] };
export const useUserStore = create((set) => ({
...initialState,
setTenant: (id) => set({ tenantId: id }),
reset: () => set(initialState),
}));
// 组件里:只订阅 userName,tenantId 变化不会触发重渲染
import { useUserStore } from '@/stores/user';
export function Header() {
const userName = useUserStore((s) => s.userName);
const setTenant = useUserStore((s) => s.setTenant);
return setTenant('t2')}>{userName};
}
几个关键配置参数和注意点:
- Zustand 4.x 默认用
Object.is比较selector结果。返回对象/数组的selector必须配useShallow,否则每次都是新引用导致无限重渲染:
import { useShallow } from 'zustand/react/shallow';
const { roles, tenantId } = useUserStore(useShallow((s) => ({ roles: s.roles, tenantId: s.tenantId })));
- 不在组件里写
useUserStore()不传selector——那等于订阅整个store,性能倒退。 - 需要跨store读取时用
useUserStore.getState(),不要在一个store的create里直接调另一个hook。
4.2 Vue:从provide/inject到Pinia
迁移后(setup store写法):
// stores/order.ts
import { defineStore } from 'pinia';
import { ref, computed } from 'vue';
export const useOrderStore = defineStore('order', () => {
const orderId = ref('');
const status = ref('pending');
const detail = ref | null>(null);
const isPaid = computed(() => status.value === 'paid');
async function fetchDetail(id: string) {
orderId.value = id;
const res = await fetch(`/api/order/${id}`);
detail.value = await res.json();
status.value = detail.value?.status ?? 'pending';
}
function markPaid() {
status.value = 'paid';
}
return { orderId, status, detail, isPaid, fetchDetail, markPaid };
});
import { storeToRefs } from 'pinia';
import { useOrderStore } from '@/stores/order';
const orderStore = useOrderStore();
const { status, isPaid } = storeToRefs(orderStore); // 注意:action 不要解构,直接 orderStore.fetchDetail
{{ status }} - {{ isPaid }}
Vue侧的坑点:storeToRefs 只对state和getter有效,action解构出来会丢失this绑定(setup store里其实还好,但options store会出问题),统一约定action不解构。
五、踩坑与优化
坑1:Zustand selector返回新对象导致无限重渲染。 上面提过,配 useShallow 解决。上线前我们用ESLint自定义规则扫了一遍所有 useXxxStore( 调用,没有selector的直接报错。
坑2:Context迁移期间双写不同步。 灰度阶段老Context和新store同时存在,有一次setTenant只更新了store没更新Context,导致老模块显示旧租户。后来加了一个同步中间件,在store的setTenant里同时调Context的setter,迁移完成后删掉。
坑3:Pinia在微前端里的实例隔离。 主应用和子应用各建了一个Pinia实例,子应用里 useOrderStore 拿到的是自己的实例,和主应用不共享。我们的处理是主应用通过props把pinia实例传给子应用挂载函数,子应用用 app.use(pinia) 复用。这个在 qiankun 场景下要特别注意。
坑4:Vue的watch深度监听store导致性能下降。 有同事写了 watch(orderStore, ..., { deep: true }),order详情对象一大,每次任何字段变化都触发深比较。改成 watch(() => orderStore.status, ...) 精准监听后,这个页面的脚本耗时从27ms降到9ms。
优化手段汇总:
- React侧所有store消费强制selector,对象用useShallow。
- 高频变化的状态(如鼠标位置、滚动)不进全局store,留在组件local state。
- 字典类只读数据用
useDictStore.getState()在非渲染逻辑里读取,避免订阅。 - Vue侧大对象用
shallowRef存detail,只在整体替换时触发更新。
六、效果数据
迁移覆盖了React侧23个页面、Vue侧17个页面,历时约6周(含灰度)。用Profiler在相同页面、相同操作下对比:
| 指标 | 迁移前 | 迁移后 |
|---|---|---|
| React最深Provider嵌套层数 | 9 | 2 |
| 切换租户重渲染组件数 | ~120 | ~15 |
| 切换租户提交阶段耗时 | 142ms | 41ms |
| 订单列表页平均帧耗时(4x CPU节流) | 38ms | 16ms |
| 单页状态相关代码行数(订单详情) | 约410行 | 约260行 |
| 季度状态相关bug数 | 基线 | 下降约62% |
代码行数下降主要来自Props透传链路的消除和重复状态定义的合并。bug数下降则是因为状态变更收敛到了action,排查时用DevTools能看到明确的调用来源。
另外有个意外收获:Zustand的 getState() 让我们的埋点代码可以直接在非组件环境读状态,之前为了在工具函数里拿用户信息,专门搞了个全局变量 hack,现在删掉了。
七、总结
如果你也在Props透传和Context堆叠里挣扎,我的建议是:
- 先量化再动手。用Profiler测出重渲染组件数和耗时,拿数据说服团队,也作为迁移后的验收标准。
- 按领域拆store,不要建大store。大store的selector粒度再细,维护成本也高。
- React侧务必强制selector,这是Zustand性能的生命线;Vue侧注意
storeToRefs和精准watch。 - 渐进迁移,留兼容层。别想着一个PR改完,灰度期间双写虽然丑但稳。
- 状态库不是银弹,高频局部状态别往全局塞。
对我们来说,这次迁移的收益是实打实的:帧耗时降了一半多,状态相关bug降了六成。如果你项目里Provider也叠到5层以上了,值得动手了。