最简形式为{% include 'header.html.twig' %}，但线上必须加ignore missing防500；推荐写法是{% include 'header' ignore missing %}，配合with {'product': item} only限定变量作用域，禁用相对路径与硬编码扩展名。
include 标签怎么写才不报错
直接写 {% include 'header.html.twig' %} 是最简形式，但容易在模板缺失时崩掉。线上环境必须加 ignore missing，否则一个漏传的路径就让整页 500。它不是可选项，是上线前必加的安全底线。
常见错误现象：Unable to find template "sidebar.html.twig"——这个异常在开发期可能被忽略，但部署后会直接中断用户访问。
- 永远优先用
{% include 'header.html.twig' ignore missing %}，哪怕你 100% 确认文件存在 - 路径别硬编码扩展名，Twig 默认识别
.html.twig，写成'header'即可（前提是命名规范） - 绝对别用相对路径如
../partials/footer.html.twig，Twig 不支持文件系统级相对引用
怎么只传特定变量，避免子模板读到不该读的东西
默认情况下，include 会把当前作用域所有变量都透过去，比如控制器传了 user、posts、config，子模板全都能访问。这既不安全也不清晰，尤其当子模板只渲染一个 product 时。
用 with + only 组合能彻底隔离作用域：
{% include 'product/card.html.twig' with {'product': item} only %}
这时 card.html.twig 里只能访问 product，user 或 posts 都不可见，连 dump() 都查不到。
-
with单独用：变量仍会透传，只是新增或覆盖部分值 -
only必须跟在with后面，顺序不能颠倒 - 传空数组
with {} only是合法的，适合纯静态片段
动态路径和多路径回退怎么写才可靠
硬编码模板名无法应对不同模块、主题或 A/B 测试场景。Twig 支持表达式和数组路径，但写法有坑。
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
动态判断推荐用三元运算，简洁且易读：
{% include type == 'blog' ? 'blog/item.html.twig' : 'news/item.html.twig' %}
多路径回退要小心顺序和语法：Twig 会按数组顺序逐个检查是否存在，第一个存在的即被加载。
- 数组必须用方括号
[ ]，不能用括号( )或花括号{ } - 路径拼接要用波浪线
~，不是点号或加号：'@theme/' ~ theme ~ '/header.html.twig' - 混合 bundle 语法和路径拼接时，确保 bundle 别名已正确定义，否则
@CustomBundle会直接报错
include 和 extends 的核心区别别搞混
include 是“复制粘贴”，extends 是“父子继承”。两者混用是常见设计误判。
比如你有个 _alert.html.twig，只含一段带 class 的 <div>，那就该用 include；但如果你要统一页面结构、复用 head/meta/script，就必须用 {% extends 'base.html.twig' %} + {% block content %}。
-
include没有block、不支持parent()、不能覆盖逻辑 - 大量嵌套
include（比如 5 层深）会明显拖慢渲染，尤其未启用 Twig 缓存时 - 需要状态管理、回调或复杂条件分支的 UI 片段，
include不是解法，应改用宏（macro）或前端组件
最常被忽略的一点：include 的模板里不能再写 {% extends %}。Twig 不允许嵌套继承，但允许嵌套 include——这点边界必须卡死。
