表单类须放在src/Form/下、以Type结尾并继承AbstractType，命名空间为App\Form\XxxType，PHP 8.1+需加#[AsFormType]属性，Autoloader自动加载无需手动注册。
表单类写在哪、怎么注册才能被 $this->createForm() 识别
Symfony 表单不是靠手动 new 出来的，必须定义为独立的类，并让容器能自动加载。常见错误是把表单逻辑塞进 Controller 里，结果 $this->createForm(MyFormType::class) 报 Class "MyFormType" not found。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 表单类统一放在
src/Form/下，命名以Type结尾（如UserRegistrationType） - 类必须继承
AbstractType，且实现buildForm()方法 - 不需要手动注册——只要命名规范、命名空间正确（如
App\Form\UserRegistrationType），Autoloader 就能自动找到 - 如果用了 PHP 8.1+，记得加
#[AsFormType]属性（否则在某些配置下可能被忽略）
buildForm() 里怎么加字段才不丢验证规则
字段加得不对，验证就只走一半：表单能渲染、提交能接收，但 $form->isValid() 总是 false，或者错误信息不显示。核心问题在于字段名、数据映射、约束绑定三者没对齐。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 字段名必须和目标对象（如
User实体）的属性名一致，或显式用property_path指定（比如property_path: "profile.phone"） - 验证约束别只写在 FormType 里——
add('email', EmailType::class, ['constraints' => [new Email()]])是临时方案；长期维护请写在实体的#[Assert\Email]上，再用validation_groups控制场景 - 嵌套表单（如地址子表单）必须用
CollectionType或自定义AddressType，不能用TextType硬塞数组 - 日期字段务必指定
widget: 'single_text'并加format，否则浏览器默认输入格式和 PHP DateTime 解析不匹配，直接触发This value is not valid.
提交后怎么拿到数据、又不破坏原始对象状态
新手常写 $form->handleRequest($request); $user = $form->getData();，看似没问题，但一旦表单绑定了实体，getData() 返回的就是那个被原地修改的对象——后续如果要重用它（比如发邮件、记录日志），可能已是脏数据。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
$form->isSubmitted() && $form->isValid()判断，而不是只看isValid() - 想保留原始对象？别依赖
getData()做业务逻辑。先$form->submit($request->request->all(), false)（false表示不调用 setter），再手动提取字段值 - 如果必须用绑定对象，记得在处理前 clone：
$cleanUser = clone $user;，再传给createForm(UserType::class, $cleanUser) - 上传文件时，
$form->getData()返回的是UploadedFile对象，不是路径——必须调用move()才真保存，且该操作只能执行一次
CSRF 失败、空提交、重定向后表单丢失这些现象怎么快速定位
这类问题通常不报错，只是表单“没反应”：点提交没跳转、刷新页面后错误消失、返回页面时字段全空。根本原因往往不在表单本身，而在请求生命周期或会话配置。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查是否漏了
{{ form_rest(form) }}—— 它负责渲染 CSRF token 隐藏字段，缺了就必然The CSRF token is invalid - 确认 session 已启动且未过期：
var_dump($request->getSession()->isStarted())，尤其在 API 场景或 Nginx 配置了fastcgi_buffering off时容易静默失败 - 重定向后表单数据丢失？那是正常行为——HTTP POST-Redirect-GET 模式本就不带数据回来。要显示错误，必须用
$this->addFlash()+ 在模板里读取app.flashes - 开发环境开
debug:router看路由是否匹配 POST 请求方法，有时写了methods: ['GET']却去 POST，表单就卡死在路由层
最麻烦的其实是表单嵌套层级深 + 动态字段 + 自定义事件监听器混用的情况——这时候 dump($form->getErrors(true)) 和 dd($form->all()) 比任何文档都管用。
