Twig模板继承需严格遵循规则：必须用完整文件名（如'base.html.twig'）声明{% extends %}，显式定义title、stylesheets、content、javascripts等{% block %}，子模板中追加资源须首行调用{{ parent() }}且仅一次，多级继承不超过3层，动态继承需置于模板最顶部且唯一。
直接写 {% extends 'base.html.twig' %} 就能继承，但漏掉 {% block %} 声明或误用 {{ parent() }} 会导致样式/脚本不加载、内容消失、甚至 Twig 报错。
基础模板必须显式定义所有可替换块
不能只靠 HTML 结构“猜”哪里能填内容。常见错误是漏写 javascripts 或 stylesheets 块，结果子模板里加的 JS/CSS 完全不生效。
-
templates/base.html.twig至少要包含title、stylesheets、content、javascripts四个{% block %} -
{% block content %}{% endblock %}里不要写默认文字（如 “Page content goes here”），否则没覆盖时会意外显示占位符 - 文件名严格区分大小写：
Base.html.twig≠base.html.twig
子模板追加资源必须调用 {{ parent() }}
直接重写 {% block javascripts %}<script>...</script>{% endblock %} 会清空父模板已有的全部 JS——这是最常踩的坑。
- 正确写法是在块内第一行写
{{ parent() }}，再追加自己的资源 -
{{ parent() }}只能在{% block %}内部使用，且只能出现一次；放在块外或重复调用会触发Twig\Error\SyntaxError - 同理适用于
stylesheets块，但注意：CSS 文件顺序敏感，{{ parent() }}要放在你自定义样式之前还是之后，取决于依赖关系
多级继承路径必须写全名，不能省略扩展名
中间层模板（比如后台专用布局）如果写 {% extends 'base' %} 或 {% extends 'base.html' %}，Twig 会找不到模板并报错。
- 所有
{% extends %}指令必须带完整文件名和扩展名：{% extends 'base.html.twig' %} - 子模板继承中间层时，路径也要完整：
{% extends 'base-admin.html.twig' %}，不能写相对路径或省略.html.twig - 继承链建议 ≤3 层（
base → base-admin → user-list），过深会让调试变困难，模板加载也变慢
动态选父模板只能在顶部写一条 {% extends %}
想根据条件换布局？比如登录用户用 base-auth.html.twig，游客用 base-guest.html.twig。这可以，但规则极严。
- 条件表达式必须写在模板最顶部，且整个模板中只能有一条
{% extends %}指令 - 写成：
{% extends app.user ? 'base-auth.html.twig' : 'base-guest.html.twig' %} - 一旦在它下面写了任何输出、HTML 或其他
{% %}标签，Twig 就会直接报错：Unexpected "extends" tag
最容易被忽略的是：所有模板都放在 templates/ 目录下，Twig 自动解析路径，所以 {% extends 'base.html.twig' %} 里的路径不加 templates/ 前缀；但如果你手误写了 templates/base.html.twig，Twig 就会去 templates/templates/base.html.twig 找——然后 404。
