直接继承AbstractType并复用标准类型最稳妥，但需手动透传选项、显式注册DataTransformer、注意数据流向，否则getData()返回空或原始字符串而非预期对象/数组。
直接继承 AbstractType 并复用标准类型是最稳妥的起点，但必须手动透传选项、显式注册转换器、注意数据流向——否则表单提交后 getData() 返回空或原始字符串，而不是你预期的对象或数组。
自定义表单类型怎么继承并复用标准行为
多数自定义类型不是从零写，而是扩展已有类型（如 DateTimeType、TextType）。关键在 getParent() 返回父类，同时在 configureOptions() 中只覆盖需要修改的默认值。
- 不重写
buildView()或finishView()就能复用渲染逻辑，但若需注入 JS 属性（如data-flatpickr-class），必须在attr里声明 -
'widget' => 'single_text'和'html5' => false要成对出现，否则浏览器可能忽略自定义 JS 插件 - 若父类是
DateTimeType，且业务要求输入不可变对象，务必设'input' => 'datetime_immutable'，否则getData()返回DateTime实例而非DateTimeImmutable
数据转换器（DataTransformer）必须显式添加
表单字段值（字符串）和模型属性（对象/数组）之间的转换，不能靠类型配置自动完成。即使你用了 TagsInputType 这种封装好的自定义类型，只要底层涉及结构转换（如逗号分隔字符串 ↔ 数组），就必须绑定 DataTransformer。
- 在自定义类型的
buildForm()中调用$builder->addModelTransformer(new TagArrayToStringTransformer()) - 转换器必须实现
transform()（模型 → 表单显示）和reverseTransform()（表单提交 → 模型），且两个方法都不能返回null，否则触发TransformationFailedException - 若转换失败，
reverseTransform()应抛出TransformationFailedException，Symfony 会自动转为表单级错误，而不是静默丢弃数据
嵌套子表单收不到父级自定义选项
这是 Symfony 表单最常被忽略的隔离机制：父表单传入的 $options 不会自动下放给 add('child', ChildType::class) 的子表单。子表单只能看到自己 configureOptions() 定义的默认值。
- 必须在
add()的第三个参数中手动透传，例如：$builder->add('tags', TagsInputType::class, ['max_tags' => $options['max_tags']]) - 如果子表单也支持多级嵌套，它同样需要把收到的选项再往下透传，不存在“继承链”
- 别依赖
$options['attr']自动合并——父级attr和子级attr是完全独立的，要合并得自己写逻辑（如array_merge($options['attr'], ['data-parent-id' => 123])）
表单提交后 getData() 返回什么，取决于绑定方式
$form->getData() 的返回值类型不是由表单类型决定的，而是由你创建表单时是否传入了数据对象（data class）以及该对象的属性映射规则决定。
- 没绑定任何对象（即
createForm(MyType::class)）→ 返回关联数组 - 绑定了实体（
createForm(MyType::class, $user)）→ 返回该实体实例，但仅当所有字段名与实体属性名一致，或你已配置了property_path - 绑定了 DTO，但 DTO 属性名与表单字段名不匹配 → 需在
add()时指定'property_path' => 'title'，否则该字段不会写入 DTO - 用了
DataTransformer但没正确处理空值 →getData()可能返回null或原始字符串，而不是转换后的结构
真正难调试的点往往不在类型定义本身，而在选项透传链断裂、转换器未注册、或 property_path 与实际属性名存在大小写/下划线差异——这些都不会报错，只会让 getData() “看起来正常”，实则数据丢失。
