React / 系统课时

使用 Zustand 管理全局状态

使用 Zustand 管理全局状态

本课用一个可运行的 React 18 示例创建 Zustand Store,把用户会话、主题配置和跨页面草稿集中管理。完成后,你能让不同组件按需读取同一份状态,并通过明确的 Action 更新它。

学习目标

  • 使用 create 定义带 TypeScript 类型的全局 Store
  • 在多个组件中通过选择器订阅所需状态
  • 区分全局客户端状态与服务端数据缓存

Zustand 的职责边界

Zustand 适合管理多个页面或远距离组件共同依赖的客户端状态,例如当前用户摘要、主题、侧边栏开关和未提交草稿。服务端返回的列表、详情和分页结果更适合交给服务端缓存工具处理,不要因为“多个页面会用到”就全部塞进全局 Store。TanStack Query 官方也将 Zustand 归为客户端状态方案,并把异步服务端状态视为另一类问题。:contentReference[oaicite:0]{index=0}

Zustand 全局状态读写流程

创建并验证 Store

create 接收状态创建函数并返回可在 React 组件中调用的 Hook;基于旧状态计算新值时,应使用 set((state) => ...) 的更新函数。:contentReference[oaicite:1]{index=1}

在已有 React 18 与 TypeScript 项目中安装依赖,并确认包已进入当前项目:

bash
npm install zustand
npm ls zustand --depth=0

预期输出如下,实际版本号以本地安装结果为准:

text
<PROJECT_NAME>@<VERSION> <PATH>
└── zustand@<VERSION>

将 src/App.tsx 替换为下面的完整示例:

tsx
import { create } from 'zustand'

type Theme = 'light' | 'dark'

interface User {
  id: string
  name: string
}

interface AppState {
  user: User | null
  theme: Theme
  orderDraft: string
  login: (name: string) => void
  logout: () => void
  toggleTheme: () => void
  setOrderDraft: (value: string) => void
}

// Store 同时定义共享状态与允许组件调用的 Action
const useAppStore = create<AppState>()((set) => ({
  user: null,
  theme: 'light',
  orderDraft: '',
  login: (name) => set({ user: { id: 'u-1001', name } }),
  logout: () => set({ user: null, orderDraft: '' }),
  // 新值依赖旧值时使用函数式 set
  toggleTheme: () =>
    set((state) => ({
      theme: state.theme === 'light' ? 'dark' : 'light',
    })),
  setOrderDraft: (value) => set({ orderDraft: value }),
}))

function Header() {
  // 精确选择字段,避免订阅整个 Store
  const user = useAppStore((state) => state.user)
  const logout = useAppStore((state) => state.logout)

  return (
    <header>
      <strong>{user ? `当前用户:${user.name}` : '当前未登录'}</strong>
      {user && <button onClick={logout}>退出</button>}
    </header>
  )
}

function OrderEditor() {
  const orderDraft = useAppStore((state) => state.orderDraft)
  const setOrderDraft = useAppStore((state) => state.setOrderDraft)

  return (
    <label>
      订单备注:
      <input
        value={orderDraft}
        onChange={(event) => setOrderDraft(event.target.value)}
      />
    </label>
  )
}

function OrderPreview() {
  // 预览区与编辑器读取同一份跨组件草稿
  const orderDraft = useAppStore((state) => state.orderDraft)
  return <p>预览:{orderDraft || '暂无内容'}</p>
}

export default function App() {
  const theme = useAppStore((state) => state.theme)
  const login = useAppStore((state) => state.login)
  const toggleTheme = useAppStore((state) => state.toggleTheme)

  return (
    <main
      style={{
        minHeight: '100vh',
        padding: 24,
        background: theme === 'dark' ? '#1f2937' : '#ffffff',
        color: theme === 'dark' ? '#ffffff' : '#111827',
      }}
    >
      <Header />
      <h2>Zustand 状态演示</h2>
      <button onClick={() => login('Simon')}>模拟登录</button>
      <button onClick={toggleTheme}>切换主题</button>
      <OrderEditor />
      <OrderPreview />
    </main>
  )
}

预期结果:

text
初始页面显示“当前未登录”和“预览:暂无内容”。
点击“模拟登录”后,Header 显示“当前用户:Simon”。
输入订单备注时,OrderPreview 同步显示相同内容。
点击“切换主题”后,整个页面在明暗主题之间切换。

组件如何订阅状态

组件调用 useAppStore((state) => state.user) 时,只声明自己需要 user。当 theme 或 orderDraft 改变而 user 未变时,Header 不需要因整棵 Store 更新而读取无关字段。选择器越精确,组件依赖越清晰,也越容易定位重复渲染。

Action 统一放在 Store 中,可以让“谁能改、怎样改”保持明确。组件负责表达用户意图,Store 负责执行状态变更;不要在组件里直接拼装复杂的跨字段更新,否则同一业务规则容易散落到多个页面。

关键边界与常见错误

  • 不要在渲染过程中调用 login、setOrderDraft 等 Action,否则可能形成重复更新。
  • 基于旧值切换主题时使用函数式 set,避免读取过期状态。
  • 不要把订单列表等远程数据长期复制进 Zustand;远程数据存在失效、重试和后台刷新问题,应由服务端缓存方案负责。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Zustand 管理全局状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通