twig include 默认自动传递所有变量，但易引发隐式依赖；推荐用 with 显式传参并重命名；ignore missing 防模板缺失崩溃；动态模板名须校验兜底，避免路径遍历。
include 时变量默认是否自动传递
默认会。写 {% include 'header.html.twig' %}，子模板能直接访问当前模板所有变量，比如 user、title、comments 都可用。
这很方便，但也容易引发隐式依赖——你改了父模板变量名，子模板可能就报 Variable "xxx" does not exist 错误，却没任何提示。
- 适合简单复用，如静态页眉、通用按钮
- 不适合逻辑强耦合的片段，比如一个评论项模板依赖
comment和currentUser，但父模板里变量叫item和authUser，就会出错 - 调试时注意：子模板里
{{ dump() }}能看到当前上下文所有变量，是排查“为什么这个变量没传进来”的最快方式
with 关键字怎么控制传哪些变量
用 with 显式传参，是最推荐的做法，尤其当子模板只关心一两个值时。
写法：{% include 'card.html.twig' with {'product': item, 'is_preview': true} %} —— 子模板只能访问 product 和 is_preview，其他一概不可见。
- 变量名可以重命名，比如把
item改成product，让子模板语义更清晰 - 支持表达式：
with {'url': path('product_show', {'id': item.id})} - 如果同时需要传变量 + 用
only，顺序必须是with {...} only，不能颠倒
ignore missing 和 fallback 路径怎么防崩溃
线上环境千万别让缺失模板导致整个页面 500。加 ignore missing 是最低成本的容错。
Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.
下载
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
{% include 'sidebar_ad.html.twig' ignore missing %} —— 模板不存在就跳过，不报错也不渲染。
更进一步，可以用数组提供多个候选路径：
{% include ['@App/ads/banner-' ~ device ~ '.html.twig', '@App/ads/default.html.twig'] %}
- Twig 会按顺序检查每个路径，加载第一个存在的模板
- 数组里支持动态拼接，但注意：路径字符串本身不能含 Twig 表达式以外的内容（比如不能写
'@App/ads/' ~ device | upper ~ '.html.twig'，|upper在这里不生效） -
ignore missing对数组形式也有效：{% include [...] ignore missing %}
动态模板名怎么写才安全
模板名可以是任意 Twig 表达式，但别直接拼接用户输入。
常见安全写法：{% include type|default('post') ~ '/item.html.twig' %}，其中 type 来自可信上下文（如路由参数或服务返回值）。
- 务必用
|default或条件判断兜底，避免type为空时变成//item.html.twig这种非法路径 - 不要用
{% include user_input ~ '.html.twig' %}—— 这等于开放模板路径遍历漏洞 - 如果类型很多，建议用映射表预定义：
{% set templates = {'blog': 'blog/item.html.twig', 'news': 'news/card.html.twig'} %}{% include templates[type] | default('default/item.html.twig') %}
{% for %} 循环里 include，子模板看到的 loop 变量是父模板的，不是它自己的。这种嵌套层级下的变量覆盖和遮蔽，比语法错误更难定位。
