如何避免HTML模板大量{% include %}生成多<footer>及分页变量传递问题

你遇到的重复渲染、样式堆叠问题的核心原因是分页模板的继承逻辑错误引发了循环嵌套渲染：pagination.html 被 blog.html 引入，同时又继承了 blog.html，每次引入时都会重复渲染一次 blog.html 的完整内容块，才会出现内容重复、样式叠加的异常。

修复步骤 #

第一步：修改pagination.html代码 #

作为被include引入的独立片段，不需要继承父模板、也不需要用block包裹内容，直接保留分页逻辑即可：

<div class="pagination">
    <span class="step-links">
        {% if page.has_previous %}
            <a href="?page={{ page.previous_page_number }}">上一页</a>
        {% endif %}
        <span class="current">
            第 {{ page.number }} 页 / 共 {{ page.paginator.num_pages }} 页
        </span>
        {% if page.has_next %}
            <a href="?page={{ page.next_page_number }}">下一页</a>
        {% endif %}
    </span>
</div>

第二步：确认变量传递逻辑 #

你当前在blog.html中写的{% include "app/pagination.html" with page=posts %}语法完全正确，只要视图层传递给blog.html的posts是分页对象，pagination.html就可以直接读取page变量，不需要从layout.html额外传参。

跨模板通用变量的通用解决方案 #

如果后续需要在layout.html、所有子模板中共享通用变量（比如全局站点配置、用户信息等），可以使用Django上下文处理器：

1. 新建context_processors.py文件，编写处理器逻辑：

import datetime
def common_variables(request):
    return {
        "site_name": "站点名称",
        "year": datetime.datetime.now().year,
        # 其他需要全局共享的变量
    }

2. 在settings.py的TEMPLATES.OPTIONS.context_processors中新增你写的处理器路径：

TEMPLATES = [
    {
        # 其他原有配置保持不变
        'OPTIONS': {
            'context_processors': [
                # 原有默认处理器全部保留
                '你的应用名.context_processors.common_variables',
            ],
        },
    },
]

配置完成后所有模板都可以直接读取你在处理器中返回的变量，不需要每个视图单独传参。

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