表单类未被识别需检查命名空间、路径和PHP属性；字段数据不绑定需配置property_path和data_class；日期/上传/嵌套字段须用对应Type类；Twig渲染必须包含form_start/form_end。
表单类没被识别？检查命名空间、路径和 PHP 属性
运行 $this->createForm(MyType::class) 报 Class not found，基本是三件事没对上：文件位置、类名后缀、命名空间。Symfony 7 默认只扫描 src/Form/（注意是大写 F），不是 src/form 或 src/Forms；类名必须以 Type 结尾，比如 UserType；命名空间必须是 App\Form\。PHP 8.1+ 还得加 #[AsFormType] 属性，否则容器可能跳过这个类。
字段渲染了但数据不绑定？查 property_path 和 data_class
常见现象：表单能显示、提交不报错，但 $form->getData() 返回空或字段值丢失。根本原因是字段名和目标对象属性名不一致，又没配 property_path。比如实体里是 $profile->phone，但你写了 $builder->add('phone')，就得补上 ['property_path' => 'profile.phone']。另外，configureOptions() 里漏写 'data_class' => User::class，也会导致表单初始化时拿不到映射上下文，handleRequest() 后无法反向赋值。
日期/上传/嵌套字段总出错？别用 TextType 硬扛
DateTimeImmutable 字段配 TextType::class → 提交直接报 This value is not valid；文件上传用 TextType → 后端收不到 UploadedFile 实例；地址字段用数组模拟 → 验证和绑定全失效。正确做法：
• 日期字段用 DateType::class 或 DateTimeType::class，并设 'widget' => 'single_text' 和 'format' => 'yyyy-MM-dd'
• 文件上传字段用 FileType::class，且 'mapped' => false，实体中单独声明 public ?UploadedFile $avatarFile = null;
• 嵌套结构（如地址）必须用独立的 AddressType 类或 CollectionType::class，不能靠 add('street', TextType::class) 拼凑
Twig 渲染时字段不显示错误？别跳 form_start / form_end
{{ form_row(form.email) }} 不输出错误信息？大概率是因为没调 {{ form_start(form) }} —— 它不只是输出 <form> 标签，还注入 CSRF token 和全局错误容器。漏掉这句，验证失败时错误消息就无处落脚。另外，form_row 是“标签 + 输入框 + 错误提示”三位一体，别拆成 form_label + form_widget + form_errors 手动拼，除非你明确需要控制每个部分的 HTML 结构。
最常被忽略的点：表单类生成后，configureOptions() 是空的，data_class 不设，property_path 不配，mapped 不调，这些都不是“可选优化”，而是绑定生效的前提条件。
