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

我们这套系统是 2022 年起步的,前端分两块:运营后台用 React 18 + TypeScript,C 端活动页用 Vue 3。后台最初只有五六个页面,全局状态无非是「当前用户信息」「权限列表」「主题配置」这几样,用 React Context 包一层 Provider 完全够用,局部状态就靠 Props 传。

问题出在 2023 年下半年,业务扩张后后台页面涨到 40 多个,Context 里塞的东西越来越多:用户信息、权限、字典缓存、未读消息数、全局 loading、多标签页状态……一个 AppContext 的 value 对象有 20 多个字段。

然后就开始难受了:

第一,任何一个小字段变化,所有 useContext 的组件全部重渲染。未读消息数每 30 秒轮询一次,一更新,整个页面树抖一遍。我们用 React DevTools Profiler 抓了一次,消息数从 3 变成 4,触发了 87 个组件重渲染,其中 80 个跟消息数毫无关系。

第二,Provider 嵌套地狱。为了做「按需订阅」,我们拆了 UserContext、PermissionContext、DictContext、UIContext 四个 Provider,main.tsx 里套了四层,新人接手第一句话都是「这啥玩意儿」。

第三,Vue 那边用 provide/inject 做跨层级传递,问题是 inject 的响应式来源不明确,改一个值要全局搜半天才知道谁提供的,调试成本极高。

第四,Props 透传在表单页尤其恶心。一个三级嵌套的弹窗表单,中间层组件收了 8 个 props 只为了往下传,纯粹是搬运工。

痛定思痛,决定迁移到专门的状态管理库。React 侧选 Zustand,Vue 侧选 Pinia。

二、环境与版本

先把版本钉死,避免读者对不上:

  • React 18.2.0 + TypeScript 5.2.2 + Vite 4.4.9
  • Zustand 4.5.2(选了轻量方案,没上 Redux Toolkit,理由见下)
  • Vue 3.4.15 + Pinia 2.1.7 + Vite 4.4.9
  • 浏览器基准:Chrome 120,测试机 MacBook Pro M1 16G
  • 性能采集工具:React DevTools Profiler、Chrome Performance 面板、PerformanceObserver 打点

三、方案设计:为什么是 Zustand 和 Pinia

React 侧我们对比了四个候选:

方案 包体积(gzip) 学习成本 按需订阅 样板代码 结论
Context(现状) 0 低 差 少 淘汰
Redux Toolkit ~13KB 中高 好 多 过重
Zustand ~1.2KB 低 好 少 采用
Jotai ~3.5KB 中 好 少 备选

选 Zustand 的核心理由:选择器天然支持按需订阅,useStore(s => s.unreadCount) 只在这个值变化时重渲染,直接解决 Context 的全量刷新问题;而且不需要 Provider 包裹,store 是模块级单例,main.tsx 清清爽爽。Redux Toolkit 功能全但样板太多,我们这个量级用不上 devtools 时间旅行那套。

Vue 侧没什么纠结的,Pinia 是官方推荐,setup 语法写 store 跟写组合式函数一样,类型推导好,devtools 支持完善,直接上。

设计原则定三条:

  1. 按领域拆 store,不搞一个大 store。拆成 useUserStore、usePermissionStore、useDictStore、useUIStore、useMessageStore 五个。
  2. 服务端数据不进 store。列表数据、详情数据属于请求缓存,交给 SWR 思路的请求层(我们用的 ahooks 的 useRequest / VueUse 的 useFetch),store 只放真正的客户端全局状态。这条很重要,很多人把接口数据也塞 store,最后 store 变成垃圾场。
  3. Context 不完全消灭。主题、国际化这种「配置型、低频变化、需要透传到深层」的,保留 Context,因为它本质是依赖注入而非状态管理。

四、核心实现

4.1 React 侧:从 Context 到 Zustand

先看迁移前的 Context 写法(简化):

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

export function AppProvider({ children }: { children: ReactNode }) {
  const [user, setUser] = useState(null);
  const [unreadCount, setUnreadCount] = useState(0);
  const [dicts, setDicts] = useState>({});
  // ... 还有十几个 state

  const value = useMemo(
    () => ({ user, setUser, unreadCount, setUnreadCount, dicts, setDicts }),
    [user, unreadCount, dicts]
  );

  return {children};
}

// 任何组件里
const { unreadCount } = useContext(AppContext)!; // 消息数一变,这里就重渲染

迁移后的 Zustand store:

// stores/messageStore.ts
import { create } from 'zustand';
import { subscribeWithSelector } from 'zustand/middleware';

interface MessageState {
  unreadCount: number;
  messages: Message[];
  fetchUnread: () => Promise;
  markRead: (id: string) => Promise;
  reset: () => void;
}

const initialState = { unreadCount: 0, messages: [] as Message[] };

export const useMessageStore = create()(
  subscribeWithSelector((set, get) => ({
    ...initialState,
    fetchUnread: async () => {
      const res = await api.getUnreadMessages();
      set({ unreadCount: res.count, messages: res.list });
    },
    markRead: async (id) => {
      await api.markRead(id);
      // 局部更新,不整体替换
      set((state) => ({
        unreadCount: Math.max(0, state.unreadCount - 1),
        messages: state.messages.map((m) =>
          m.id === id ? { ...m, read: true } : m
        ),
      }));
    },
    reset: () => set(initialState),
  }))
);

组件里按需订阅,关键就在选择器:

// 只订阅 unreadCount,messages 变化不会触发这个组件
function MessageBadge() {
  const unreadCount = useMessageStore((s) => s.unreadCount);
  return ;
}

// 需要多个字段时,用 useShallow 避免对象引用变化导致的重渲染
import { useShallow } from 'zustand/react/shallow';

function MessagePanel() {
  const { messages, markRead } = useMessageStore(
    useShallow((s) => ({ messages: s.messages, markRead: s.markRead }))
  );
  // ...
}

这里有个细节值得说:Zustand 4.4 之后 useShallow 从 zustand/shallow 挪到了 zustand/react/shallow,我一开始按老文档 import,构建直接报错。另外选择器返回对象时必须用 useShallow 或者自己保证引用稳定,否则 { a, b } 每次都是新对象,等于没做优化——这个坑我踩了整整半天,Profiler 里看着组件还在狂刷,一度怀疑人生。

4.2 Vue 侧:从 provide/inject 到 Pinia

迁移前的 provide/inject:

const userInfo = ref(null);
const permissions = ref([]);
provide('userInfo', userInfo);
provide('permissions', permissions);




const userInfo = inject('userInfo'); // 来源不明,类型是 any

迁移后的 Pinia store:

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

export const useUserStore = defineStore('user', () => {
  const userInfo = ref(null);
  const permissions = ref([]);
  const token = ref('');

  const isAdmin = computed(() => permissions.value.includes('admin'));

  function hasPermission(code: string) {
    return permissions.value.includes(code);
  }

  async function login(payload: LoginPayload) {
    const res = await api.login(payload);
    token.value = res.token;
    userInfo.value = res.user;
    permissions.value = res.permissions;
  }

  function logout() {
    userInfo.value = null;
    permissions.value = [];
    token.value = '';
  }

  return { userInfo, permissions, token, isAdmin, hasPermission, login, logout };
});

组件里用 storeToRefs 解构保留响应式:

import { storeToRefs } from 'pinia';
import { useUserStore } from '@/stores/user';

const userStore = useUserStore();
// 注意:直接解构会丢响应式,必须用 storeToRefs
const { userInfo, isAdmin } = storeToRefs(userStore);
// 方法直接从 store 上取
const { hasPermission } = userStore;

storeToRefs 这个点也是经典坑,直接 const { userInfo } = userStore 拿到的是普通值,模板不更新,排查起来很费劲。

五、踩坑与优化

坑一:持久化与 SSR 冲突。用户信息需要存 localStorage,我用了 zustand/middleware 的 persist,但项目里有部分页面做预渲染,hydration 时读 localStorage 报错。解法是给 persist 加 skipHydration: true,在 useEffect 里手动 rehydrate()。

坑二:store 之间的循环依赖。usePermissionStore 里想读 useUserStore 的 token,useUserStore 又想在 logout 时清权限,结果循环 import 报 undefined。解法是把清理逻辑抽到独立的 resetAllStores() 函数里,由调用方统一触发,而不是 store 之间互相调用。

坑三:批量更新触发多次渲染。轮询接口一次返回消息数和列表,我分两次 set 调用,中间有一次不一致的渲染。Zustand 的 set 是同步的,两次调用就是两次通知,改成一次 set 合并即可。React 18 的自动批处理管不到 store 外部的订阅通知。

优化一:选择器粒度。原来有个组件订阅了 useUIStore(s => s),整个 store 任何字段变都重渲染。改成只订阅需要的 theme 字段后,这个组件的重渲染次数从每分钟 40+ 降到 0。

优化二:字典缓存加 TTL。useDictStore 启动时全量拉字典,200 多条,接口耗时 400ms 阻塞首屏。改成按需加载 + 内存缓存 30 分钟,首屏直接省掉这 400ms。

优化三:Vue 侧用 markRaw 处理大对象。字典数据是纯静态的,不需要深度响应式,markRaw 包一层后,Vue 的响应式代理开销明显下降,字典下拉框首次渲染从 90ms 降到 35ms。

六、效果数据

迁移前后在同一个测试机、同一份数据量(列表 500 条)下对比:

指标 迁移前 迁移后 变化
后台首屏可交互时间 1.8s 1.1s -39%
列表滚动平均 FPS 42 58 +38%
消息轮询触发的组件重渲染数 87 4 -95%
main.tsx Provider 嵌套层数 4 1 -75%
状态相关代码行数 ~620 ~480 -23%

首屏提升主要来自字典按需加载,重渲染数下降是 Zustand 选择器的功劳,代码行数减少则是因为去掉了大量 Provider 样板和 props 类型声明。

七、总结

这次迁移最大的感受是:Context 和 provide/inject 适合做依赖注入,不适合做高频变化的状态管理。它们的订阅粒度是「整个 value」,一旦状态多了,性能问题是必然的,不是写法问题。

Zustand 和 Pinia 的核心价值不在「多了一个库」,而在于订阅粒度可编程——你可以精确控制「谁在什么值变化时更新」。这是 Context 架构下做不到的。

给准备迁移的同行三条建议:一是先按领域拆 store,别搞大一统;二是服务端数据别进 store,交给请求层;三是迁移可以渐进,新模块直接用 store,老模块按访问热度逐个改,别想着一次性全量重构,风险太大。

我们这次是分了三批迁的,前后两周,中间线上没出过状态相关的故障。慢即是快。