React / 系统课时
状态边界与持久化
状态边界与持久化
本课建立一套可执行的状态归类方法,并用 Zustand persist 选择性保存主题和工作区。完成后,你能判断数据应放在组件、URL、服务端缓存还是全局 Store,也能避免把敏感或短期状态写入本地存储。
学习目标
- 按生命周期、所有权和共享范围划分状态
- 识别适合进入 URL 与服务端缓存的数据
- 使用
partialize只持久化必要的全局字段
用三个问题确定状态归属
判断状态位置时,先问三个问题:它由浏览器还是服务器拥有;是否需要被分享、收藏或通过前进后退恢复;刷新页面后是否仍应保留。不要先选工具再迁就数据,而要先确认状态的所有权和生命周期。

四类状态的最小边界
| 状态位置 | 适合的数据 | 判断依据 |
|---|---|---|
| 组件状态 | 输入框内容、弹窗开关、局部校验结果 | 只服务当前组件或局部组件树 |
| URL 状态 | 搜索词、筛选条件、排序方式、页码 | 需要分享链接、刷新恢复或浏览器历史 |
| 服务端缓存 | 用户列表、订单详情、统计结果 | 数据由服务器拥有,可能过期并需要重新获取 |
| 全局状态 | 主题、当前工作区、跨页面临时草稿 | 客户端拥有,且多个远距离组件共同使用 |
服务端状态通常需要请求去重、失效判断、后台刷新和缓存回收,这些职责与普通客户端状态不同。TanStack Query 官方文档也将其定位为服务端状态管理工具,而不是所有全局状态的替代品。:contentReference[oaicite:2]{index=2}
URL 状态应直接编码在路径参数或查询参数中。React Router 提供 URL 参数和搜索参数接口,使筛选条件能随导航保存,而不是额外复制到 Zustand 后再手工同步。:contentReference[oaicite:3]{index=3}
选择性持久化 Store
Zustand 的 persist 中间件可以把状态写入浏览器存储,partialize 用于过滤真正需要保存的字段。:contentReference[oaicite:4]{index=4} 示例只持久化主题和工作区,不保存访问令牌与页面草稿。
在 React 18 与 TypeScript 项目中安装并确认依赖:
npm install zustand
npm ls zustand --depth=0预期输出如下,实际路径和版本号可能不同:
<PROJECT_NAME>@<VERSION> <PATH>
└── zustand@<VERSION>将 src/App.tsx 替换为下面的完整浏览器端示例:
import { create } from 'zustand'
import { createJSONStorage, persist } from 'zustand/middleware'
type Theme = 'light' | 'dark'
interface PreferenceState {
theme: Theme
selectedWorkspaceId: string | null
accessToken: string | null
pageDraft: string
toggleTheme: () => void
selectWorkspace: (id: string) => void
setAccessToken: (token: string | null) => void
setPageDraft: (value: string) => void
}
// persist 负责恢复白名单字段,其他字段仍只存在于内存
const usePreferenceStore = create<PreferenceState>()(
persist(
(set) => ({
theme: 'light',
selectedWorkspaceId: null,
// 敏感会话与短期草稿不应默认写入浏览器存储
accessToken: null,
pageDraft: '',
toggleTheme: () =>
set((state) => ({
theme: state.theme === 'light' ? 'dark' : 'light',
})),
selectWorkspace: (id) => set({ selectedWorkspaceId: id }),
setAccessToken: (token) => set({ accessToken: token }),
setPageDraft: (value) => set({ pageDraft: value }),
}),
{
// 固定键名便于检查、升级与清理持久化数据
name: 'anystack-preferences',
storage: createJSONStorage(() => localStorage),
// 只保存刷新后仍需要、且可安全暴露的字段
partialize: (state) => ({
theme: state.theme,
selectedWorkspaceId: state.selectedWorkspaceId,
}),
},
),
)
export default function App() {
// 组件仍按字段订阅,不因持久化而改为读取整个 Store
const theme = usePreferenceStore((state) => state.theme)
const workspaceId = usePreferenceStore(
(state) => state.selectedWorkspaceId,
)
const pageDraft = usePreferenceStore((state) => state.pageDraft)
const accessToken = usePreferenceStore((state) => state.accessToken)
const toggleTheme = usePreferenceStore((state) => state.toggleTheme)
const selectWorkspace = usePreferenceStore(
(state) => state.selectWorkspace,
)
const setPageDraft = usePreferenceStore((state) => state.setPageDraft)
const setAccessToken = usePreferenceStore(
(state) => state.setAccessToken,
)
return (
<main style={{ padding: 24 }}>
<p>主题:{theme}</p>
<p>工作区:{workspaceId ?? '未选择'}</p>
<p>令牌:{accessToken ?? '无'}</p>
<button onClick={toggleTheme}>切换主题</button>
<button onClick={() => selectWorkspace('workspace-1001')}>
选择工作区
</button>
<button onClick={() => setAccessToken('temporary-token')}>
写入临时令牌
</button>
<input
value={pageDraft}
placeholder="输入临时草稿"
onChange={(event) => setPageDraft(event.target.value)}
/>
</main>
)
}预期结果:
操作前:theme=light,selectedWorkspaceId=null,accessToken=null,pageDraft=""。
操作并刷新前:主题、工作区、临时令牌和草稿都显示新值。
刷新页面后:主题和工作区保持不变;临时令牌恢复为 null,草稿恢复为空字符串。
localStorage 中只保存 theme 与 selectedWorkspaceId。持久化的安全与生命周期边界
持久化并不等于“更可靠”。localStorage 中的数据可被浏览器端脚本读取,也可能因结构升级而失效,因此不要默认保存访问令牌、支付信息、完整用户资料或一次性表单内容。敏感会话优先由后端会话与安全 Cookie 方案管理。
只保存可恢复的偏好和标识,而不是保存可由服务器重新获取的完整对象。例如保存 selectedWorkspaceId,刷新后再按 ID 请求工作区详情;不要把工作区名称、权限和成员列表一起长期复制到本地。
当持久化结构发生变化时,应增加版本与迁移策略;在支持服务端渲染的项目中,还要把浏览器存储读取限制在客户端,并处理首次渲染与恢复后的状态差异。
验收清单
- 搜索、筛选和页码能够通过 URL 复制给其他人。
- 列表与详情仍由服务端缓存管理,没有重复存入 Zustand。
- 刷新后只恢复主题、工作区等必要偏好。
localStorage中不存在令牌、敏感资料和可重新请求的大对象。