Django 2.0.4含HTML模板变量渲染异常求助

嘿，我刚入门Django的时候也踩过类似的坑！咱们一步步拆解这个问题：

首先明确核心场景：你在父模板里用{{ data.content|safe }}能正常渲染HTML，但当父模板通过{% include %}引入其他子模板后，原本的HTML内容要么被转义成纯文本，要么显示异常——这其实是Django模板自动转义机制的常见“小陷阱”。

常见原因&对应解决方案 #

• 子模板未添加|safe过滤器
  如果子模板里直接写{{ data.content }}而没加|safe，Django默认会转义所有HTML标签。解决起来很直接，在子模板的变量后补上过滤器：

  {{ data.content|safe }}
  

• 用with传递变量时丢失安全标记
  要是你在父模板里用{% with content=data.content %}{% include 'child.html' %}{% endwith %}传递变量，这个过程会丢失data.content的安全标记。可以在传递时就加上|safe：

  {% with content=data.content|safe %}{% include 'child.html' %}{% endwith %}
  

  或者直接在子模板里对接收的变量再用一次|safe。

• 子模板开启了强制自动转义
  检查子模板里有没有类似这样的代码：

  {% autoescape on %}
      {{ data.content }}
  {% endautoescape %}
  

  哪怕父模板里加了|safe，这里的autoescape on会强制触发转义。你可以把on改成off，或者在变量后追加|safe：

  {% autoescape on %}
      {{ data.content|safe }}
  {% endautoescape %}
  

额外小技巧 #

如果你频繁需要渲染同一份带HTML的内容，也可以在视图里提前把字符串标记为安全的，这样模板里就不用每次加过滤器了：

from django.utils.safestring import mark_safe

# 在视图中处理data.content
data.content = mark_safe(data.content)

⚠️ 注意：只有当你完全信任这份HTML的来源时才用这个方法，避免XSS攻击风险！

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