一、问题背景:当 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"。具体症状:

  1. React 侧无效重渲染严重:一个 Context value 变化,所有 useContext 的消费者全部重渲染。我们用 React DevTools Profiler 抓了一次配置中心列表页,单次筛选操作触发了 87 次组件渲染,其中真正需要更新的只有 12 个。
  2. Vue 侧 Props 链路难维护:改一个字段名要动 5 个文件,而且 provide/inject 的响应式来源不透明,新人排查问题时经常找不到数据从哪来。
  3. 性能数据难看: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)!; // 任何字段变化都会重渲染

迁移步骤分四步:

  1. 建立 store 骨架,按业务域拆分(config、user、permission),不搞一个大 store。
  2. 把 reducer 的 action 改写成 store 方法,dispatch({type:'SET_FILTER'}) 变成 setFilter(payload)。
  3. 组件内 useContext 替换为选择器订阅,这是性能收益的关键。
  4. 删除 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 透传别的字段。

迁移步骤:

  1. 用 defineStore 的 setup 语法建立 store,把原 reactive 对象搬进去。
  2. inject 调用点替换为 useXxxStore()。
  3. 删除中间层的 Props 声明和 $attrs 透传。
  4. 用 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 这两个细节,建议直接写进团队规范,能省掉大量排查时间。