parent() 是 twig 块继承专用函数，只能在同名 {% block %} 内调用，用于复用父模板中该块的内容；不可在顶层、{% if %} 外、{% set %} 或宏中使用，不支持传参，且仅限直接父级，不能跨层或读取其他 block。
Twig 中 parent() 函数只能在块（block）内调用
直接在模板顶层或 {% if %} 之外写 {{ parent() }} 会报错：Twig\Error\SyntaxError: "parent" function can only be used inside a block。它不是通用函数，而是块继承机制的语法糖，专用于覆盖父模板中某个 {% block %} 时“复用父内容”。
常见错误场景包括：在 {% set %} 变量赋值里调用、在宏（macro）里误用、或试图在未定义同名 block 的子模板中调用。
- 必须和同名
{% block xxx %}配对使用，且父模板中该 block 已存在 - 不能跨层级“跳级”调用 —— 如果 A extends B，B extends C，那么 B 中的
parent()指向 C，A 中的parent()指向 B - 不支持传参，
parent('header')是非法写法；只能调用当前正在重写的那个 block 的父级内容
正确用法：在子模板 block 中嵌入父内容再追加
典型需求是“保留父模板的默认样式/结构，只添加额外 JS 或 class”。比如父模板 base.html.twig 定义了 body_class block：
{% block body_class %}page-default{% endblock %}
子模板想加一个 page-product 类，就得这样写：
{% extends 'base.html.twig' %}
{% block body_class %}
{{ parent() }} page-product
{% endblock %}
注意：parent() 返回的是字符串（非自动转义），所以可直接拼接、trim 或用 filter 处理：
{{ parent()|trim|lower }}-special-
{% if parent() is defined %}{{ parent() }}{% endif %}—— 实际上没必要，只要 block 存在，parent()就一定可用 - 不能用
parent()获取其他 block 的内容，比如当前在titleblock 里调用parent()，拿不到sidebar的内容
Symfony 中常被忽略的继承链陷阱
Symfony 默认使用 Twig，但实际继承链可能比想象中深 —— 比如用了 twig/extra-bundle 或某些 Admin Bundle，模板可能经过多层 extends。此时 parent() 总是指向上一级，而非最顶层 base。
调试方法：临时在子模板 block 里输出 {{ dump(parent()) }}（需开启 debug 模式），确认拿到的内容是否符合预期。
- 如果发现
parent()返回空字符串，大概率是父模板里对应 block 根本没定义（不是空白，是压根不存在） - 若继承了第三方 bundle 模板（如
@EasyAdmin/page/content.html.twig），先查清它的父模板是谁，别假设 “base.html.twig” 是唯一源头 - 避免在同一个 block 中多次调用
parent()—— 合法但无意义，它每次返回的都是同一份父内容
替代方案：什么时候不该用 parent()
当需要复用的不是“块内容”，而是“逻辑片段”或“可复用结构”，parent() 就力不从心了。比如想在多个页面统一插入一段带参数的面包屑导航，应该用 macro 或 include：
{% import '_macros.html.twig' as macros %}
{{ macros.breadcrumb(['Home', 'Products', product.name]) }}
或者用 {% include %} 加 with 传参：
{% include 'components/_alert.html.twig' with { type: 'info', message: 'Saved.' } %}
parent() 的边界很清晰：只服务于继承体系下的块内容叠加。一旦需求超出这个范围，强行套用反而会让模板难维护、难测试。
真正容易出问题的，是以为它能“读取任意父级内容”，或在复杂继承中误判了 parent() 到底指向哪一层 —— 动手前先看清楚 extends 链和各层 block 定义，比背语法重要得多。
