一、问题背景:Context 不是银弹,Props 更不是

我们维护的是一个面向企业客户的数据看板系统,前端采用微前端架构:主应用是 React 18.2,两个子模块分别用 React 18.2 和 Vue 3.4 编写,通过 qiankun 2.10 挂载。项目初期为了"轻量",状态管理策略是:

  • 跨组件传值:Props 逐层透传,最深达到 6 层;
  • 全局共享(用户信息、主题、权限):React Context + useContext,Vue 侧用 provide/inject。

一开始没问题。但业务迭代到第 8 个月,问题集中爆发:

  1. 重渲染失控。一个 Context 里塞了用户信息、字典数据、筛选条件三块内容,任何一块变化都会让所有 useContext 的组件重渲染。用 React Profiler 录了一次筛选切换,commit 阶段耗时 186ms,重渲染组件数 47 个,其中 38 个与筛选条件无关。
  2. Props 地狱。到 中间隔了 4 层纯布局组件,每层都要写 filters={filters} onFilterChange={...},改一个字段要动 5 个文件。
  3. Vue 侧同类问题。provide/inject 的响应式对象被注入后,任何字段变更都会触发注入组件更新,且 inject 的依赖关系在 DevTools 里不可见,排查困难。
  4. 调试成本高。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 })}
    />
  );
}

关键点有三个:

  1. 每个字段一个选择器,或者用 useShallow 包一层,杜绝"返回新对象导致无限重渲染";
  2. action 单独订阅(useSetFilter),因为 action 引用稳定,组件不会因 action 变化重渲染;
  3. 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 没有悬念。

迁移步骤建议按这个顺序来,风险最低:

  1. 先迁只读的全局数据(用户信息、字典),验证 store 基础设施;
  2. 再迁页面级筛选状态,这一步收益最大,因为它是重渲染的主要来源;
  3. 最后删 Context/Provider,清理 Props 透传,同步补 ESLint 规则防回退;
  4. 每一步都保留旧实现一个迭代周期,用 feature flag 切换,出问题能回滚。

最后一句实话:状态管理库解决的是"状态该放哪、谁该更新"的组织问题,不是性能问题的万能药。我们这次能拿到 78% 的耗时下降,一半功劳在库,一半功劳在迁移时被迫重新梳理了状态边界——那些混在 Context 里的派生状态和副作用,才是真正的性能杀手。