Django模板变量默认HTML转义仅对HTML body有效，属性值、URL、script内等上下文需手动转义；mark_safe仅适用于完全可控的静态内容；禁用autoescape极危险，应优先用bleach或前端净化。
模板变量默认会自动转义，但只对HTML上下文有效
Django模板中所有用 {{ variable }} 渲染的变量，默认都会经过HTML转义：比如 <script>alert(1)</script> 会被转成文字显示，不会执行。这是最基础也最有效的防护。
但它只作用于HTML body内容，不覆盖其他上下文：
-
<style class="{{ var }}">——var被插进未加引号的属性值里，浏览器可能误解析为 JS 执行 -
<a href="{{ url }}">—— 若url是javascript:alert(1)，点击就触发 -
<script>var msg = "{{ data }}";</script>—— 单引号或反斜杠没被处理，容易闭合字符串并注入代码
这些地方必须手动做上下文感知的转义，不能依赖模板默认行为。
什么时候能用 mark_safe？只在你完全控制内容来源时
mark_safe 不是“让 HTML 正常显示”的快捷键，而是“我担保这段内容不含任何危险字符”的声明。一旦用错，XSS 漏洞直接暴露。
立即学习“Python免费学习笔记（深入）”；
常见误用场景：
- 把用户提交的富文本（哪怕经过 TinyMCE 编辑）直接
mark_safe后渲染 - 拼接 URL 或 JS 字符串时，只对一部分做了转义，另一部分靠
mark_safe“绕过” - 从数据库读取历史数据（比如旧版 CMS 存的 HTML），未经清洗就标记安全
真正安全的用法示例：
from django.utils.safestring import mark_safe <h1>完全由开发者写死、无任何用户参与的内容</h1><p>html_snippet = '<div class="badge">Verified</div>' trusted_html = mark_safe(html_snippet)
前端输出前再做一层上下文转义，比依赖后端更可靠
后端无法预知前端如何使用变量。一个 {{ user_input }} 在 <p> 里安全，在 <input value=""> 或 <script> 里就不安全。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
推荐做法：
- 后端只提供原始数据（如 JSON API），不在模板里拼接 HTML
- 前端用专用函数做上下文转义：比如用
DOMPurify.sanitize()处理富文本，用textContent替代innerHTML渲染纯文本 - 若必须服务端渲染动态 HTML，用
bleach.clean()或BeautifulSoup做白名单过滤，而不是mark_safe
例如，允许 <p><strong><ul> 等标签，但剥离所有 on* 事件和 javascript: 协议。
禁用自动转义（{% autoescape off %}）几乎总是错的
这个标签的存在，不是为了让你“方便地输出 HTML”，而是为极少数需要批量生成模板片段的底层逻辑留的后门。99.9% 的业务场景都不该碰它。
如果你写了这样的代码：
{% autoescape off %}
{{ user_content }}
{% endautoescape %}
等于主动关闭 Django 最重要的 XSS 防线。等价于把门钥匙交给攻击者。
替代方案更稳妥：
- 用
bleach清洗后再传给模板（{{ cleaned_html|safe }}） - 把富文本渲染逻辑封装成自定义模板标签，内部完成过滤
- 前端接管渲染，后端只返回结构化数据
真正难防的 XSS 往往不出现在显眼的 script 标签里，而藏在属性值、URL 协议、CSS 表达式这些边缘位置——那里正是自动转义失效的地方，也是开发者最容易忽略的点。
