twig在symfony中开箱即用，核心是掌握控制器传参、模板输出、继承与引入的常见报错点：render传数组键变变量名，避免深层嵌套和对象方法调用，注意extends首行限制、block名称严格匹配、include路径相对templates且需扩展名。
Twig 在 Symfony 项目里不是“要学完才能用”，而是开箱即用——只要控制器传了数据，模板里写 {{ }} 就能输出，{% if %} 就能判断，{% extends %} 就能复用布局。关键不是语法多全，而是知道哪几处不填坑就直接报错。
控制器怎么传数据给 Twig 模板
Symfony 默认用 render() 方法把数组传进模板，键名变成模板里的变量名：
-
$this->render('blog/index.html.twig', ['posts' => $posts, 'user' => $user])→ 模板里就能直接用{{ posts }}和{{ user.name }} - 别传对象方法调用（如
['title' => $post->getTitle()]），Twig 会尝试在模板里再调一次，可能触发未预期的副作用 - 数组嵌套层级别太深，
{{ data.a.b.c.d.e }}不仅难读，空值时还会抛TwigErrorRuntimeError，建议在控制器里提前解构或用??运算符兜底
为什么 {{ variable }} 有时输出空白或原始字符串
常见原因不是语法错，而是上下文缺失或转义逻辑干扰：
- 变量根本没传进来：检查控制器是否漏写了该键，或用了
renderView()却忘了return new Response()包裹 - 内容被自动转义成 HTML 实体：比如传入
'<strong>标题</strong>'，{{ content }}会显示为文字而非加粗——这时才加|raw：{{ content|raw }}，但仅限你完全信任该变量来源 - 用了
|trans却没配翻译文件：如果输出仍是app.welcome这种键名，八成是translations/messages.en.yaml文件不存在、拼错名，或default_locale没设
模板继承时 {% block %} 不生效的典型场景
{% extends %} 必须是模板第一行，且子模板中 {% block %} 名称要和父模板严格一致（包括空格）：
- 父模板写的是
{% block content %}，子模板写成{% block Content %}或{% block "content" %}都不会覆盖 - 想在子模板里追加内容而不是替换，得显式调用
{{ parent() }}，否则父模板同名 block 内容会被清空 - 路径写错：用
{% extends 'base.html.twig' %}时，Twig 默认从templates/目录找；若放在templates/layout/下，就得写{% extends 'layout/base.html.twig' %}
{% include %} 引入子模板总报 “Template not found”
这不是路径写法问题，而是 Twig 加载器默认不递归扫描子目录，且对命名敏感：
- 路径必须相对
templates/根目录，比如templates/components/button.html.twig，引入时写{% include 'components/button.html.twig' %}，不能省略扩展名 - 加
ignore missing是线上必备项：{% include 'ads/banner.html.twig' ignore missing %}，否则一个临时下线的广告位就能让整页 500 - 别在
{% include %}里传大量数据或复杂对象，它只是静态嵌入；真需要动态渲染逻辑，应该用{{ render(controller('App\Controller\AdController::bannerAction')) }}
真正卡住人的往往不是语法记不住，而是控制器传参漏字段、继承时 block 名大小写不一致、include 路径少写了 .html.twig 后缀——这些地方一错，Twig 报错信息又常模糊，容易绕远路查半天。
