Twig使用extends时触发Twig_Error_Syntax：cannot extend from a block，求解析

嘿，这个错误我之前踩过坑，其实核心原因特别直白：你把{% extends %}标签放到了某个{% block %}块的内部（或者其他嵌套的模板标签里），而Twig的规则不允许这么做。

为什么会触发这个错误？ #

Twig的模板继承逻辑要求，{% extends %}必须是模板里最顶层的有效代码——简单说，除了注释之外，它得是你写的第一行模板标签。因为Twig需要先明确你当前模板继承的父模板是谁，才能正确识别、替换或者覆盖父模板里的各个block。如果把extends放到某个块里面，Twig在解析模板的时候，还没搞清楚继承关系，就先碰到了块内容，自然会报错。

错误示例 vs 正确示例 #

举个最常见的错误写法：

{% block main_content %}
    {% extends 'base_layout.twig' %} {# 这里是错误根源！extends嵌套在block里了 #}
    <div class="content">
        这是页面内容
    </div>
{% endblock %}

正确的写法应该把extends放在最外层，所有block的外面：

{% extends 'base_layout.twig' %} {# 放在最顶层，这才是正确位置 #}

{% block main_content %}
    <div class="content">
        这是页面内容
    </div>
{% endblock %}

额外提醒 #

除了block，如果你不小心把extends写到{% if %}、{% for %}这类条件/循环标签里，也会触发同样的错误。Twig不支持动态条件式的模板继承，要是有这种需求，建议在控制器层面判断后选择不同的模板，或者用{% include %}配合条件来实现类似效果。

内容的提问来源于stack exchange，提问作者user7430779