python标准库html.escape()和html.unescape()分别用于html编码与解码:escape()默认转义、&及引号(quote=true),unescape()支持命名、十进制、十六进制实体,但不校验合法性且无属性值解析模式。

直接用标准库函数,别自己写正则或拼接逻辑——容易漏字符、不兼容、还埋XSS风险。
Python 用 html.escape 和 html.unescape 就够了
Python 标准库的 html 模块已覆盖绝大多数场景,无需额外安装第三方包。
-
html.escape默认转义、<code>>、&,加quote=True(默认)还会转"和';若只处理标签上下文(比如生成 HTML 属性值),可设quote=False避免单引号被转成'(部分旧浏览器不识别) -
html.unescape能安全识别命名实体(如©)、十进制(©)、十六进制(©),但不会校验实体是否合法——比如&xyz;会被原样保留,不报错 - 注意:它不处理 Unicode 编码错误(如
\ud800),遇到无效 surrogate pair 会抛UnicodeEncodeError,需在外层 try/catch
JavaScript 优先用 he 库,别依赖 innerText/innerHTML 模拟
浏览器原生没有 encodeHTML / decodeHTML 函数,用 DOM 模拟虽可行,但有隐藏坑:
-
document.createElement('div').textContent = str; div.innerHTML在某些 IE 版本下对处理异常,可能截断字符串 - 不支持
useNamedReferences或isAttributeValue这类细粒度控制,比如属性值中要不要把"编成",DOM 方法无法指定 -
he.encode(str, { useNamedReferences: true })可输出而非 <code>,更利于调试和阅读;<code>he.decode(str, { strict: true })遇到&bad;直接 throw,避免静默失败
解码时 isAttributeValue=True 很关键,尤其处理表单值
HTML 属性值中的实体解析规则和普通文本不同——比如 value="a&b" 解析后是 a&b,但 (空格)在属性里会被规范为普通空格,而不在属性里则可能被 HTML 解析器合并。
- 用
he.decode(input, { isAttributeValue: true })才能模拟真实浏览器对<input value="...">的解析行为 - Python 的
html.unescape没这个开关,它统一按“数据状态”解码,所以从input.value读出的字符串若含实体,必须用 JS 端解码,或提前在服务端约定不往属性值里塞未解码实体 - 常见翻车点:把用户昵称
O'Reilly存进数据库,前端用innerHTML渲染<span>{{name}}</span>没问题,但填进<input value="{{name}}">就会显示O'Reilly而非O'Reilly—— 因为属性值自动解码了一次
别混淆 HTML 实体和 URL 编码,也别混用 htmlspecialchars 和 html.escape
PHP 的 htmlspecialchars 默认只转 、<code>>、&、"、',而 Python 的 html.escape 行为一致,但名字相似的 urllib.parse.quote 是干另一件事的。
- URL 参数里的
q=hello+world是application/x-www-form-urlencoded编码,不是 HTML 实体;误用html.unescape解q=hello%20world会原样返回,毫无效果 -
he.encode的encodeEverything: true会把所有 ASCII 控制符(如\x00-\x1f)也转成~,这在日志脱敏或 XML 场景有用,但普通网页渲染没必要,反而增大体积 - 真正要防 XSS 的地方,编码只是第一道防线;输入验证、CSP、
Content-Security-Policyheader 才是关键,光靠转义挡不住javascript:alert(1)这类事件处理器注入
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











