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。
方案设计上,我们做了三件事:
- 按领域拆 store:
useAuthStore、useTenantStore、useLayoutStore、usePermissionStore,不再搞一个大 Context。 - 保留 Context 做依赖注入:Zustand 不需要 Provider,但我们把
QueryClient、Router这类依赖仍放在 Context 里,状态和依赖分离。 - 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 测一下,数据会替你决策。