Flask结合HTMX时如何根据请求头返回完整页面或HTML片段

直接使用Jinja2原生支持的条件继承特性即可，不需要修改现有路由逻辑，也不需要重复编写页面内容，是Flask+HTMX项目的通用成熟实践。

实现步骤 #

1. 先在模板目录下新建空布局模板templates/empty_layout.html，仅保留内容块定义，不添加任何全局头尾、公共资源代码：

   {% block container %}{% endblock %}
   

2. 调整所有业务页模板的继承逻辑，用三目表达式根据fullpage参数动态选择父模板，业务内容仍然只需要在container块中编写一次：

   {% extends "pagelayout.html" if fullpage else "empty_layout.html" %}
   {% block container %}
   <button>Click me</button>
   <!-- 其余业务内容统一写在这里，不需要重复维护两份 -->
   {% endblock %}
   

逻辑说明 #

• 当用户直接在浏览器地址栏访问时，路由传入fullpage=True，模板会继承预先写好的带固定头尾、公共资源引用的pagelayout.html，输出完整页面，符合直接访问的渲染预期。
• 当请求由HTMX发起时，路由传入fullpage=False，模板会继承无任何额外内容的空布局，最终仅输出container块内的HTML片段，满足HTMX局部更新的要求。

方案优势 #

• 完全遵循DRY原则，业务HTML内容只需要编写一次，不存在双份内容维护不一致的问题
• 不需要编写自定义Jinja扩展、上下文处理器或者额外路由判断逻辑，全部用模板原生语法实现
• 和现有路由层的HX-Request头判断逻辑完全兼容，不需要改动后端代码

不推荐为完整页面和片段分别维护两套模板的写法，后续内容迭代很容易出现两边渲染逻辑不一致的问题。

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