解决ant-design/pro-components中DatePicker.RangePicker在DrawerForm中的报错问题

在使用ant-design/pro-components开发时，开发者可能会遇到一个常见问题：当在DrawerForm中使用DatePicker.RangePicker组件时，控制台会抛出"TypeError: values.test[0].format is not a function"的错误。这个问题看似简单，但实际上涉及到表单数据处理和日期格式化的深层次机制。

问题本质分析

这个错误的根本原因在于ant-design/pro-components的DrawerForm组件默认会对表单数据进行格式化处理。当使用原生的DatePicker.RangePicker组件时，返回的日期值会被pro-form自动转换，导致原本的dayjs对象变成了普通字符串或数组，从而失去了format方法。

解决方案一：使用ProFormDateRangePicker

最推荐的解决方案是使用pro-form专门提供的ProFormDateRangePicker组件。这个组件已经针对pro-form做了优化，能够正确处理日期数据的格式化和反格式化。

import { DrawerForm, ProFormDateRangePicker } from '@ant-design/pro-form';
import dayjs from 'dayjs';

function MyForm() {
  return (
    <DrawerForm
      open={true}
      onFinish={(values) => {
        console.log(dayjs(values.test?.[0]).format(), values.test)
      }}
    >
      <ProFormDateRangePicker name="test" label="日期范围" />
    </DrawerForm>
  )
}

使用ProFormDateRangePicker的优势在于：

1. 内置了日期处理逻辑，开发者无需关心数据转换
2. 与pro-form的其他功能完美兼容
3. 提供了统一的API风格

解决方案二：禁用自动格式化

如果确实需要使用原生的DatePicker.RangePicker组件，可以通过设置dateFormatter={false}来禁用pro-form的自动格式化功能。

<DrawerForm
  open={true}
  dateFormatter={false}
  onFinish={(values) => {
    console.log(values.test[0].format(), values.test)
  }}
>
  <Form.Item name="test" label="测试">
    <DatePicker.RangePicker />
  </Form.Item>
</DrawerForm>

这种方法虽然可行，但需要注意：

1. 需要自行处理所有日期数据的格式化和解析
2. 可能会影响表单中其他字段的数据处理
3. 不是官方推荐的最佳实践

最佳实践建议

对于大多数场景，建议采用第一种方案使用ProFormDateRangePicker。这不仅解决了当前问题，还能获得以下好处：

1. 一致的API设计，降低学习成本
2. 内置的校验规则和错误提示
3. 更好的类型推断和代码提示
4. 与pro-form生态的无缝集成

如果项目中有特殊需求必须使用原生组件，才考虑第二种方案，但要确保团队了解这种做法的潜在风险和维护成本。

通过理解这个问题的本质和解决方案，开发者可以更加游刃有余地处理pro-components中的日期选择器相关问题。