一、问题背景:当 Context 和 Props 开始拖后腿
先说结论:Context 和 Props 本身没有错,错的是我们把它们用在了不该用的规模上。
项目是一个双技术栈中后台系统,React 18.2 负责数据看板和配置中心,Vue 3.3 负责运营后台。早期页面少,React 侧用 Context + useReducer 做全局状态,Vue 侧用 provide/inject 配合 Props 逐层传递,代码量小、心智负担低,一切都很美好。
问题出现在业务扩张之后。React 侧全局 Context 拆成了 6 个 Provider 嵌套,最深的组件树有 11 层;Vue 侧一个表单配置对象从祖父组件传到曾孙组件,中间经过 4 层 v-bind="$attrs"。具体症状:
- React 侧无效重渲染严重:一个 Context value 变化,所有
useContext的消费者全部重渲染。我们用 React DevTools Profiler 抓了一次配置中心列表页,单次筛选操作触发了 87 次组件渲染,其中真正需要更新的只有 12 个。 - Vue 侧 Props 链路难维护:改一个字段名要动 5 个文件,而且
provide/inject的响应式来源不透明,新人排查问题时经常找不到数据从哪来。 - 性能数据难看:React 列表页首屏 TTI(Time to Interactive)从项目初期的 1.8s 涨到 3.4s,Lighthouse 性能分从 82 掉到 61。
于是我们决定迁移。选型上,React 侧选 Zustand 4.4.7,Vue 侧选 Pinia 2.1.7。原因后面细说。
二、环境与版本
先把环境交代清楚,避免读者对号入座时踩版本坑:
- React 18.2.0 + TypeScript 5.2.2 + Vite 4.4.9
- Zustand 4.4.7(迁移前 Context 方案为原生 API,无额外依赖)
- Vue 3.3.4 + TypeScript 5.2.2 + Vite 4.4.9
- Pinia 2.1.7(迁移前为 provide/inject + Props)
- 性能采集工具:React DevTools Profiler 4.28、Vue DevTools 6.6、Lighthouse 11.0(桌面模式,CPU 4x 降速)
三、方案设计:为什么是 Zustand 和 Pinia
React 侧对比了三个候选:
| 方案 | 包体积(gzip) | 重渲染控制 | 学习成本 | 结论 |
|---|---|---|---|---|
| Context + useReducer | 0 | 差,全量订阅 | 低 | 现状,淘汰 |
| Redux Toolkit 1.9 | ~13KB | 中,需 useSelector 精细选择 | 中高 | 模板代码多,团队抵触 |
| Zustand 4.4 | ~1.2KB | 好,选择器订阅 | 低 | 采用 |
Zustand 的核心优势是选择器订阅:useStore(s => s.xxx) 只在选中切片变化时重渲染,天然解决 Context 全量订阅的问题。而且它不需要 Provider 包裹,store 是模块级单例,迁移时可以逐个模块替换,不用一次性改完。
Vue 侧对比:
| 方案 | 响应式来源 | DevTools 支持 | 结论 |
|---|---|---|---|
| provide/inject | 隐式,难追踪 | 弱 | 现状,淘汰 |
| Vuex 4 | 显式 | 中 | 官方已推荐 Pinia,不选 |
| Pinia 2.1 | 显式,setup store 语法 | 强,时间旅行 | 采用 |
Pinia 的 setup store 写法几乎就是把 ref/computed 搬进一个函数,迁移成本极低,且 DevTools 能看到每次 action 的 payload,排查问题效率提升明显。
四、核心实现与迁移步骤
4.1 React:Context 迁移到 Zustand
迁移前的典型 Context 写法(简化):
// 迁移前:GlobalContext.tsx
const ConfigContext = createContext(null);
export function ConfigProvider({ children }: { children: ReactNode }) {
const [state, dispatch] = useReducer(configReducer, initialState);
return (
{children}
);
}
// 任意深层组件
const { state } = useContext(ConfigContext)!; // 任何字段变化都会重渲染
迁移步骤分四步:
- 建立 store 骨架,按业务域拆分(config、user、permission),不搞一个大 store。
- 把 reducer 的 action 改写成 store 方法,
dispatch({type:'SET_FILTER'})变成setFilter(payload)。 - 组件内
useContext替换为选择器订阅,这是性能收益的关键。 - 删除 Provider 嵌套,保留一个仅用于初始化的副作用组件。
迁移后的 store 代码(可运行,依赖 zustand@4.4.7):
// stores/configStore.ts
import { create } from 'zustand';
import { devtools } from 'zustand/middleware';
interface Filter {
keyword: string;
status: 'all' | 'active' | 'disabled';
}
interface ConfigState {
filters: Filter;
list: ConfigItem[];
loading: boolean;
setFilter: (patch: Partial) => void;
fetchList: () => Promise;
}
export const useConfigStore = create()(
devtools(
(set, get) => ({
filters: { keyword: '', status: 'all' },
list: [],
loading: false,
setFilter: (patch) =>
set((s) => ({ filters: { ...s.filters, ...patch } }), false, 'setFilter'),
fetchList: async () => {
set({ loading: true }, false, 'fetchList/start');
const { filters } = get();
const res = await api.getConfigList(filters);
set({ list: res.data, loading: false }, false, 'fetchList/done');
},
}),
{ name: 'configStore' }
)
);
组件侧改造,注意选择器的粒度:
// 迁移后:只订阅用到的切片
function FilterBar() {
const filters = useConfigStore((s) => s.filters);
const setFilter = useConfigStore((s) => s.setFilter);
// filters 变化才重渲染,list 变化与本组件无关
return setFilter({ keyword: e.target.value })} />;
}
function ConfigTable() {
const list = useConfigStore((s) => s.list);
const loading = useConfigStore((s) => s.loading);
// ...
}
这里有个细节:不要返回新对象。useConfigStore(s => ({ a: s.a, b: s.b })) 每次都会生成新引用导致无限重渲染,要么分开订阅,要么用 useShallow(zustand/react/shallow)。我们统一规定:多字段订阅必须用 useShallow 包一层。
4.2 Vue:provide/inject + Props 迁移到 Pinia
迁移前的痛点写法:祖父组件 provide('formConfig', config),曾孙组件 inject('formConfig'),中间层还在用 Props 透传别的字段。
迁移步骤:
- 用
defineStore的 setup 语法建立 store,把原reactive对象搬进去。 inject调用点替换为useXxxStore()。- 删除中间层的 Props 声明和
$attrs透传。 - 用
storeToRefs解构保持响应性。
迁移后的 store(可运行,依赖 pinia@2.1.7):
// stores/useFormStore.ts
import { defineStore } from 'pinia';
import { ref, computed } from 'vue';
export const useFormStore = defineStore('form', () => {
const formConfig = ref({ title: '', fields: [] });
const submitting = ref(false);
const fieldCount = computed(() => formConfig.value.fields.length);
async function submit() {
submitting.value = true;
try {
await api.saveForm(formConfig.value);
} finally {
submitting.value = false;
}
}
function updateField(index: number, patch: Partial) {
Object.assign(formConfig.value.fields[index], patch);
}
return { formConfig, submitting, fieldCount, submit, updateField };
});
组件侧:
import { storeToRefs } from 'pinia';
import { useFormStore } from '@/stores/useFormStore';
const formStore = useFormStore();
// 解构必须用 storeToRefs,直接解构会丢失响应性
const { formConfig, submitting } = storeToRefs(formStore);
五、踩坑与优化
迁移过程不是一帆风顺,记录三个真实坑:
坑 1:Zustand 选择器返回新对象导致无限循环。 上面提过,s => ({a: s.a}) 每次渲染都产生新引用,React 认为状态变了就重渲染,重渲染又生成新引用,直接死循环。解决方案是 useShallow,或者拆成多个 useStore 调用。我们最终统计,迁移中有 9 处踩了这个坑。
坑 2:Pinia 直接解构丢失响应性。 const { formConfig } = useFormStore() 拿到的是普通值快照,后续 store 更新组件不刷新。必须 storeToRefs。这个坑在团队 code review 里加了一条 lint 规则拦截。
坑 3:Context 里的异步初始化逻辑没地方放。 原来 ConfigProvider 挂载时拉取字典数据,删掉 Provider 后这段逻辑要重新安置。我们的做法是保留一个极薄的 AppBootstrap 组件,在 useEffect 里调用 useConfigStore.getState().fetchDict(),避免在渲染期触发请求。
优化方面还有两点:一是给 Zustand 的 devtools 中间件只在 import.meta.env.DEV 下启用,生产包体积从 1.2KB 进一步压到 0.9KB;二是 Pinia 开启 strict 模式校验 action 内修改 state,防止绕过 action 直接改值。
六、效果数据
迁移覆盖 React 侧 23 个页面、Vue 侧 18 个页面,历时 3 周(含回归测试)。关键数据对比:
| 指标 | 迁移前 | 迁移后 | 变化 |
|---|---|---|---|
| React 列表页 TTI | 3.4s | 2.0s | -41% |
| 单次筛选操作组件渲染次数 | 87 次 | 24 次 | -72% |
| Lighthouse 性能分(React 侧) | 61 | 84 | +23 |
| Vue 表单页首屏渲染 | 1.6s | 1.2s | -25% |
| 全局状态相关代码行数 | ~2100 行 | ~1400 行 | -33% |
| 新增依赖体积(gzip) | 0 | Zustand 0.9KB + Pinia 4.2KB | 可接受 |
渲染次数下降 72% 是最直观的收益,本质是把"全量订阅"换成了"切片订阅"。代码行数减少主要来自删掉了大量 Props 声明和 $attrs 透传。
七、总结
这次迁移给我的最大感受是:状态管理方案要和项目规模匹配。Context 和 provide/inject 在中小规模下完全够用,强行上库反而是过度设计;但当全局状态消费者超过一定数量、组件层级超过 6 层时,选择器订阅和显式 store 带来的可维护性和性能收益就很明显了。
如果让我给建议:React 侧优先考虑 Zustand(体积小、迁移平滑、选择器天然防全量渲染),Vue 侧直接上 Pinia(官方推荐、DevTools 完善、setup 语法迁移成本低)。迁移时务必分模块灰度,别想着一次性替换完,我们就是先迁了配置中心一个模块验证数据,再铺开的。最后,选择器写法和 storeToRefs 这两个细节,建议直接写进团队规范,能省掉大量排查时间。