form_start() 和 form_end() 必须成对出现，否则 csrf 字段丢失，导致 400 错误；mapped=false 字段需用 form_widget() 显式渲染，否则静默不显示。
form_start() 和 form_end() 必须成对出现，否则 CSRF 字段丢失
Twig 渲染 Symfony 表单不是靠手写 <form></form> 标签，form_start() 会自动注入隐藏的 CSRF token 字段和 method 属性（根据表单配置决定是 POST 还是 PUT/PATCH）。漏掉 form_end() 不仅会让提交失败（CSRF 验证不通过），还可能让自定义主题里的 form_rest() 无法渲染未显式调用的字段。
常见错误现象：400 Bad Request 提示 “The CSRF token is invalid.”，但控制器里明明调用了 $form->handleRequest($request) —— 很大概率是模板里只写了 form_start() 没写 form_end()，或者中间混入了未闭合的 HTML 标签导致 Twig 解析错位。
- 始终用
{{ form_start(form) }}开头、{{ form_end(form) }}结尾，不要手动写 - 如果只想渲染部分字段（比如跳过某些 hidden 字段），用
{{ form_row(form.fieldName) }}显式控制，再补上{{ form_rest(form) }}收尾，它会渲染所有未被显式调用的字段 + CSRF 隐藏域 - 自定义主题中若重写了
form_startblock，必须确保包含{{ form.vars.enctype }}和{{ form.vars.attr }}，否则文件上传或自定义属性会失效
form_row() 渲染效率高，但不适合复杂布局嵌套
form_row() 是最常用的渲染方式：它一次性输出 label + widget + errors，语义清晰、代码简洁。但它把三者封装在一个 <div>（默认）里，CSS 类名固定为 <code>form-row，不适合需要 Grid 布局、浮动排列或 label 在右侧等定制场景。
使用场景：后台管理页、内部工具表单等对 UI 要求不高、追求开发速度的地方；或者字段少、结构扁平的联系表单。
- 想改外层容器标签？在自定义主题里重写
form_rowblock，把<div> 换成 <code><section></section>或带 class 的<div class="field-group"> <li>要 label 和 input 分开控制样式？改用 <code>form_label()+form_widget()+form_errors()三段式调用 - 嵌套太深（比如
form_row()里又include另一个含form_row()的子模板），WebProfiler 里 Total time 会明显高于 Render time —— 此时应把子表单逻辑提前在控制器里拆解，避免模板层重复解析 - 必须显式调用
{{ form_widget(form.confirmPassword) }}，并自行补上 label 和 error：{{ form_label(form.confirmPassword) }}、{{ form_errors(form.confirmPassword) }} - 如果用了自定义主题，检查该主题是否覆盖了
form_widgetblock 且没处理mapped=false的分支 —— 有些老主题会跳过 unmapped 字段 - 验证规则仍可加：在 FormType 的
add()中传入'constraints' => [new NotBlank()]，框架照常校验 - 主题文件路径必须存在且可读，否则 Twig 报错
Unable to find template "xxx"，而不是静默忽略 - 调试时可在 WebProfiler → Templates 标签页里点开当前模板，看 “Form themes” 区域列出哪些主题已加载、顺序如何
- 别在全局配置（
twig.form_themes）和模板内form_theme同时引入同一主题 —— 会导致 block 被重复定义，Twig 报Conflict between blocks
mapped=false 字段必须用 form_widget() 单独渲染
当表单字段设为 mapped=false（比如验证码、确认密码、临时筛选条件），它不会绑定到底层对象，Symfony 不会自动把它纳入 form_rest() 或 form_row() 的默认渲染流。直接写 {{ form_row(form.confirmPassword) }} 会静默失败（无输出），也不报错。
原因：这类字段没有关联的实体属性，form_row 的默认逻辑依赖 form.vars.mapped === true 才触发完整渲染链。
form_theme 引入顺序影响最终样式，@block 名称区分大小写
多个表单主题叠加时，后 form_theme 的模板优先级更高。但如果你在控制器里用 $this->render('xxx.html.twig', ['form' => $form])，然后在模板里写 {% form_theme form 'form/my_theme.html.twig' %}，这个主题只作用于当前 form 变量，不影响其他表单。
容易踩的坑是 block 名称拼错：form_row 和 formrow 是两个东西；submit_widget 和 button_widget 在不同 Symfony 版本中行为也不同（5.4+ 推荐用 submit_widget）。
mapped=false 字段不显示 + 自定义主题里漏了 unmapped 分支处理，这两处没日志、不报错、只沉默丢字段。
