SuperAPI AI 工具集

managing-state

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:为 React/TypeScript 应用提供状态管理模式的选型与编码规则,指导创建 store、管理组件状态以及选择合适的状态方案。

主要能力与选型:全局 Zustand store 用于业务逻辑、CRUD 与领域状态(如 useProductStore、useAuthStore);原子 Zustand store 用于组件 UI 状态与局部行为;React Context 仅用于框架集成与组件树配置(如 ThemeProvider),不用于业务状态;nuqs 用于可分享、可收藏的 URL 状态(分页、筛选、搜索);React Hook Form + Zod 用于带校验的复杂表单;useState 仅用于简单局部 UI 状态(1-2 个值)。决策要点:需跨组件共享用 Zustand;需 URL 持久化用 nuqs;带校验的表单用 RHF + Zod;框架/库集成用 Context。

全局 store 规范:State 与 Actions 接口分离并导出,合并为 Store = State & Actions;create 回调标注返回类型,动作方法写显式返回类型;动作返回 StoreResult<T>,便于组件响应成功或失败;用 mapApiResultToStoreResult() 把 ApiResult 映射为 StoreResult;错误状态包含面向用户的 errorMessageForUser;业务逻辑放在 store 方法中而非组件内。

分层与依赖:第 1 层全局领域 store;第 2 层原子组件 store;第 3 层横切 store(通知、UI)。原子可注入全局依赖,通信方向为原子到全局(委派)与全局到原子(订阅),可用工厂模式做依赖注入以避免循环依赖;禁止原子对原子直接通信,禁止全局导入原子。

用法示例:nuqs 中使用 useQueryState('page', parseAsInteger.withDefault(1)) 管理分页;表单用 zodResolver(schema) 与 mode: 'onChange',并以模式优先方式用 z.infer 推导类型,同时把服务端校验错误映射回各字段。

数据流:组件调用 store.action(),store 调用 API 客户端并包装为 Result,更新状态后触发组件重渲染。

反模式:用 Context 存频繁变化的状态、把业务逻辑写进组件、组件直连 API、用 useState 共享跨组件状态、原子 store 彼此直接通信。

限制:资料未提供具体版本要求、安装命令、性能基准或测试方案,暂未提供。