ahooks-v3
ahooks-v3 是一套面向 React 状态管理的实用 Hooks 技能,聚焦于分组状态更新与 localStorage 持久化两类场景。它适用于 ahooks v3+、React 18+ 且支持 Hooks 的项目,推荐配合 TypeScript v5+ 以获得类型推断,并且仅限客户端使用(localStorage 依赖浏览器 API)。核心用法包括:用 useSetState 管理会一起变化的分组状态(如表单状态、游戏引擎状态、临时 UI 状态),用 useLocalStorageState 让状态跨浏览器会话持久保存(如用户偏好、调试开关、设置项)。技能同时给出明确边界:URL 可共享状态应使用 nuqs,异步操作与加载状态应使用 TanStack Query,复杂状态机与异步操作不在覆盖范围内;并强调避免将 URL 状态与 localStorage 混用而不做显式同步。