React-hook-form用户修改字段后dirty状态始终未更新的原因排查

• 默认值与表单字段类型不匹配
  比如默认值是数字类型（如0），但输入框返回的是字符串类型（如"0"），react-hook-form做值对比时会认为两者没有变化，不会标记字段为dirty。日期类型也容易踩这个坑：默认值是Date对象，表单返回ISO字符串，或者反过来，都会导致对比逻辑失效。

• 默认值设置时机错误
  如果不在useForm的defaultValues里初始化默认值，而是在组件渲染后通过reset设置，react-hook-form可能没捕获到正确的初始快照，后续修改时无法和初始值对比。异步获取默认值时，要是调用reset没加{ keepDirty: false }参数，也会让dirty状态的判断基准出错。

• 字段名不匹配
  表单控件的name属性和useForm注册的字段名对不上，比如注册的是user.email，但input的name写的是user_email，这种情况下修改输入框不会触发对应字段的dirty状态，整个表单的dirty状态也不会更新。

• 自定义控件未正确同步值
  使用第三方UI组件或者自定义输入组件时，没通过register或Controller正确同步值。比如只绑定了onChange却没把field.value传给组件，react-hook-form感知不到值的变化，自然不会更新dirty状态。

• 启用shouldUnregister导致字段丢失
  开启shouldUnregister: true后，字段对应的组件卸载时，该字段会从表单状态中移除。如果之前修改过这个字段，整体dirty状态可能无法正确反映；重新挂载组件后，初始值被重置，也会让dirty判断混乱。

• 复杂对象/数组的深层对比问题
  当默认值是嵌套对象或数组时，react-hook-form的浅对比检测不到深层变化。比如默认值是{ address: { city: "Beijing" } }，修改city为"Shanghai"后，浅对比认为对象引用没变化，不会标记为dirty。这种情况要开启deepDirty选项，或者修改深层值时更新对象引用。

• 表单重置操作不当
  用setValue代替reset设置初始值，会导致react-hook-form的初始快照没被更新，后续修改时对比的还是原来的初始值，dirty状态不触发。另外，调用reset时没重置dirty状态，也会让后续的dirty判断基准错误。

内容的提问来源于stack exchange，提问作者Titan689