1. 问题背景:Context 和 Props 不是不能用,是规模上来后真顶不住

项目是一个后台管理系统,React 18.2 + TypeScript 4.9 + Vite 4.3,Vue 子应用是 Vue 3.3 + Pinia 2.1(当时还没全面切 Pinia,部分页面仍在用 props 透传)。团队 6 个人,代码量大概 8 万行。

React 侧最早用的是 Context + useReducer 管理全局状态,比如用户信息、权限、主题、侧边栏折叠、当前租户。小规模时很舒服,但页面一多,问题就出来了:

  • 一个 Context 里塞了 12 个字段,任何字段变化,所有 useContext 的组件都重渲染;
  • 列表页有 120 多个消费组件,切换租户时明显卡顿;
  • Context 嵌套了 4 层:AuthContext > ThemeContext > TenantContext > LayoutContext,调试时很难追踪状态从哪来;
  • Vue 子应用那边更原始,爷爷组件给孙子组件传 props,中间 5 到 7 层,每层都要声明 defineProps,改一个字段要动 6 个文件。

我们不是一开始就想上状态管理库的。先试过 useMemo 拆 Context、React.memo 包组件、Vue 用 provide/inject,但治标不治本。最后决定迁移到 Zustand 4.4 和 Pinia 2.1,原因很简单:API 轻、TypeScript 友好、不需要包 Provider(Zustand)、Vue 官方推荐(Pinia)。

2. 环境与版本:别小看版本号,有些坑就是版本带来的

迁移前锁定版本:

  • React 18.2.0
  • TypeScript 4.9.5
  • Vite 4.3.9
  • Zustand 4.4.1
  • Vue 3.3.4
  • Pinia 2.1.4
  • vue-tsc 1.8.8

Zustand 4.4 的 create API 和 persist 中间件已经比较稳定,但 subscribeWithSelector 在 4.4.1 里对 selector 的引用相等判断需要自己注意。Pinia 2.1.4 在 Vue 3.3 下 storeToRefs 的解构响应性没问题,但如果你在 setup 外直接解构 store,会丢响应性,这个后面踩坑部分会说。

3. 方案设计:为什么选 Zustand 和 Pinia,不选 Redux Toolkit / Vuex

我们对比了四个方案:

方案 包体积(min+gzip) 样板代码 TS 支持 迁移成本 适用场景
React Context 0 中 中 低 小型全局状态
Redux Toolkit 1.9 ~13KB 高 好 高 大型团队、严格规范
Zustand 4.4 ~1.2KB 低 很好 低 中小型、按需订阅
Vuex 4 ~3KB 中 中 中 Vue 2 遗留
Pinia 2.1 ~1.5KB 低 很好 低 Vue 3 官方推荐

选 Zustand 的核心理由是按需订阅:组件只订阅自己用到的 slice,不会因为别的字段变化而重渲染。选 Pinia 的理由更直接:Vue 3 官方推荐,defineStore 的 setup 语法和 Composition API 一致,迁移 props 时几乎是把 props 换成 storeToRefs。

方案设计上,我们做了三件事:

  1. 按领域拆 store:useAuthStore、useTenantStore、useLayoutStore、usePermissionStore,不再搞一个大 Context。
  2. 保留 Context 做依赖注入:Zustand 不需要 Provider,但我们把 QueryClient、Router 这类依赖仍放在 Context 里,状态和依赖分离。
  3. Vue 侧用 Pinia 替代 props 透传:跨层级超过 2 层的状态一律进 store,1 层以内仍用 props,避免过度设计。

4. 核心实现:迁移代码长什么样

4.1 React:从 Context 到 Zustand

迁移前的 Context 大概长这样:

// 迁移前:AuthContext.tsx
const AuthContext = createContext(null);

export function AuthProvider({ children }: { children: React.ReactNode }) {
  const [state, dispatch] = useReducer(authReducer, initialState);
  return {children};
}

// 消费组件
const { user, tenantId, permissions } = useContext(AuthContext)!;

问题很明确:user 变了,只用 tenantId 的组件也重渲染。

迁移后:

// store/authStore.ts
import { create } from 'zustand';
import { subscribeWithSelector } from 'zustand/middleware';

interface AuthState {
  user: User | null;
  tenantId: string;
  permissions: string[];
  setUser: (user: User | null) => void;
  setTenantId: (id: string) => void;
  setPermissions: (p: string[]) => void;
}

export const useAuthStore = create()(
  subscribeWithSelector((set) => ({
    user: null,
    tenantId: '',
    permissions: [],
    setUser: (user) => set({ user }),
    setTenantId: (tenantId) => set({ tenantId }),
    setPermissions: (permissions) => set({ permissions }),
  }))
);

// 消费组件:只订阅 tenantId
const tenantId = useAuthStore((s) => s.tenantId);

关键点:useAuthStore((s) => s.tenantId) 返回的是原始值,Zustand 用 Object.is 比较,tenantId 不变就不会触发重渲染。如果 selector 返回对象,要么用 useShallow,要么自己保证引用稳定。

4.2 Vue:从 props 透传到 Pinia

迁移前,爷爷组件到孙子组件:


迁移后:

// stores/tenant.ts
import { defineStore } from 'pinia';
import { ref, computed } from 'vue';

export const useTenantStore = defineStore('tenant', () => {
  const tenantId = ref('');
  const tenantName = ref('');
  const tenantConfig = ref>({});

  const isDefaultTenant = computed(() => tenantId.value === 'default');

  function setTenant(id: string, name: string) {
    tenantId.value = id;
    tenantName.value = name;
  }

  return { tenantId, tenantName, tenantConfig, isDefaultTenant, setTenant };
});
import { storeToRefs } from 'pinia';
import { useTenantStore } from '@/stores/tenant';

const tenantStore = useTenantStore();
const { tenantId, tenantName } = storeToRefs(tenantStore);

注意:storeToRefs 是必须的,直接 const { tenantId } = tenantStore 会丢响应性。这个坑我们踩过一次,页面数据不更新,查了半小时。

5. 踩坑与优化:迁移不是换个 API 就完事

坑 1:Zustand selector 返回新对象导致无限重渲染。
一开始写了 useAuthStore((s) => ({ user: s.user, tenantId: s.tenantId })),每次返回新对象,Object.is 永远 false,组件疯狂重渲染。改成 useShallow 或者拆成两个 selector 解决。

坑 2:Pinia 在 setup 外解构丢响应性。
在 router.beforeEach 里写了 const { tenantId } = useTenantStore(),后面 tenantId 不更新。正确做法是保留 store 实例,用 store.tenantId 访问。

坑 3:迁移期间两套状态并存,数据不一致。
我们按页面灰度迁移,Context 和 Zustand 同时存在了两周。解决办法是写了一个同步层:Context 的 dispatch 里同时调用 Zustand 的 set,迁移完一个页面删一个同步。别想着一次性全切,风险太大。

优化 1:Zustand 用 subscribeWithSelector 做副作用。
比如租户切换后要清空缓存:

useAuthStore.subscribe(
  (s) => s.tenantId,
  (tenantId, prevTenantId) => {
    if (tenantId !== prevTenantId) {
      queryClient.clear();
    }
  }
);

优化 2:Pinia 的 $subscribe 做持久化。
只持久化 tenantId 和 theme,不持久化 permissions,避免权限过期后读到旧数据。

优化 3:React 列表组件用 useShallow 包 selector,减少对象比较带来的重渲染。Vue 侧对大型列表用 shallowRef 存 store 里的数组,避免深响应式开销。

6. 效果数据:重渲染和交互延迟确实降了

我们用 React DevTools Profiler 和 Chrome Performance 面板测了三轮,取中位数:

指标 迁移前 Context 迁移后 Zustand 变化
租户切换时重渲染组件数 124 18 -85.5%
列表页首屏交互延迟(ms) 182 62 -65.9%
全局状态更新 commit 耗时(ms) 46 11 -76.1%
单页 bundle 增量(gzip) 0 +1.2KB 可接受

Vue 侧没有做重渲染计数,但 props 声明行数从迁移前 7 层共 38 行降到 9 行,defineProps 相关代码减少约 40%。另外,Vue 页面切换时 Pinia store 的读取耗时在 1ms 以内,基本无感。

需要说明的是,这些数字跟业务场景强相关。我们的列表页有 200 行数据、12 列,重渲染成本高,所以收益明显。如果你的项目全局状态很少变,Context 完全够用,没必要为了迁移而迁移。

7. 总结:什么时候该迁,什么时候别折腾

这次迁移给我的感受是:状态管理库解决的是“订阅粒度”和“跨层级传递”两个问题,不是“状态多”的问题。 如果你的 Context 里只有主题和用户信息,且一年不变几次,别迁。如果出现以下信号,可以考虑:

  • 一个 Context 超过 8 个字段,且更新频率不同;
  • 跨层级 props 超过 3 层;
  • Profiler 里全局状态更新导致 50+ 组件重渲染;
  • 团队里有人开始写 useMemo 包 Context value 包到怀疑人生。

迁移步骤上,建议按领域拆 store、灰度迁移、保留同步层、最后删旧代码。Zustand 和 Pinia 的 API 都很轻,真正花时间的是梳理状态边界和回归测试,不是写代码。版本上,Zustand 4.4.1 和 Pinia 2.1.4 在我们项目里稳定跑了 3 个月,没出现框架层面的问题。如果你正在纠结要不要迁,先拿一个重渲染最严重的页面做试点,用 Profiler 测一下,数据会替你决策。