使用Django嵌套include模板标签是否会产生不良副作用？

我在多个基于模板引擎的项目开发中，碰到过多次嵌套include引发的问题，常见的不良副作用如下：

• 上下文变量污染：绝大多数模板引擎默认会把当前模板的全量上下文传递给被include的子模板，嵌套层级越多，同名变量覆盖的概率越高。出现变量值不符合预期的问题时，很难排查到具体是哪一层嵌套模板修改了变量值。
• 循环引入错误：多人协作场景下很容易无意写出循环引入的逻辑，比如y.html引入x.html、x.html引入z.html、z.html又引入y.html，轻则触发模板引擎的栈溢出报错，重则直接导致服务进程卡死。
• 性能损耗：未开启模板缓存的环境下，多层嵌套意味着模板解析阶段要发起多次IO请求读取模板文件，渲染阶段也要反复切换上下文栈，页面加载速度会明显下降，部分老旧模板引擎甚至会出现内存泄漏问题。
• 维护成本过高：嵌套层级超过2层后，很难直观梳理出页面最终的渲染结构，修改公共模板片段的逻辑或样式时，无法快速评估影响范围，也很难定位具体逻辑所在的模板文件。

优化建议 #

如果模板嵌套层级超过2层，优先使用模板继承（extends）代替嵌套include；如果确实需要使用include，建议显式传递需要的变量，禁止传递全量上下文，比如Django模板引擎中可以用以下写法限制上下文传递范围：

{% include "x.html" with custom_param=target_value only %}

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