React Hook Form 表单规范
在写或改任何表单代码前必须先读的表单规范:数据流、订阅、重置、脏状态与数字输入的处理方式。
功能与用途
在复杂前端单体仓库中,随着表单功能扩展,旧代码往往充斥着各种 React Hook Form 反模式,例如通过 Props 透传表单对象并直接调用 form.watch()、只订阅不渲染的空 watch、未加防护的 valueAsNumber 以及受控值写为 ?? undefined 等。本工具提供严格的表单编写与审查规范。其核心心智模型是“由订阅决定谁重渲染”:RHF 内部依赖非受控的 ref 存储数据,必须通过明确的 API 决策控制渲染范围——在子组件中一律传递 control 并使用 useWatch 或
适用场景
- 表单字段新增与修改:在现有表单中添加新输入项或修改已有字段,保证默认值完整且校验逻辑无遗漏。
- 响应式表单状态读取:在子组件中安全读取表单值或监听变更,用 useWatch 替代导致全树重渲染的反模式。
- 弹窗与抽屉表单集成:为模态框或抽屉配置表单提交、重置与脏状态检查逻辑,规避不必要的重渲染与状态失效。
适用人群
- 前端开发者
- 技术团队
- 代码审查者
使用步骤
- 在写或改任何表单代码之前先加载这份规范,不要以现有代码库为参考。
- 按「订阅决定重渲染」的心智模型判断每个读取 API(watch / useWatch / formState / getValues)的影响。
- 改动时遵循「改到哪修到哪」:正在编辑的字段、hook 和组件顺带升级到合规写法。
- 不要碰没改到的代码,但把发现的反模式告诉用户。
- 确认没有引入新的违规——CI 里 no-use-watch 警告数是递增校验,涨一就构建失败。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- master
- 最近更新
- 2026-09-17
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Correct React Hook Form usage anywhere in the monorepo — data flow, subscriptions,
使用前准备
- React 项目与 react-hook-form 依赖
- 要处理的表单代码上下文
依赖与权限
- 读取用户主动提供的内容