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