一、问题背景: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 支持完善,直接上。
设计原则定三条:
- 按领域拆 store,不搞一个大 store。拆成
useUserStore、usePermissionStore、useDictStore、useUIStore、useMessageStore五个。 - 服务端数据不进 store。列表数据、详情数据属于请求缓存,交给 SWR 思路的请求层(我们用的 ahooks 的 useRequest / VueUse 的 useFetch),store 只放真正的客户端全局状态。这条很重要,很多人把接口数据也塞 store,最后 store 变成垃圾场。
- 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,老模块按访问热度逐个改,别想着一次性全量重构,风险太大。
我们这次是分了三批迁的,前后两周,中间线上没出过状态相关的故障。慢即是快。