必须转义的只有5个字符:、&、"、',分别对应、&、"、',其他Unicode字符无需转义;纯文本显示优先用textContent,富文本需先转义再白名单过滤。

HTML内容直接插入前必须转义哪些字符
用户输入或后端返回的字符串,只要会拼进 HTML 文本流(比如 innerHTML、模板字符串插值、document.write),就可能触发 XSS。真正需要转义的只有 5 个基础字符:、>、&、"、'。其他 Unicode 字符(比如 emoji、中文、数学符号)本身不构成标签或事件语法,无需转义。
常见错误现象:<script>alert(1)</script> 直接进 innerHTML 就执行;onerror="alert(1)" 插入属性值中也会触发。
→(防止开启新标签)-
>→>(虽多数情况非必需,但保持对称更安全) -
&→&(所有实体都以&开头,不转义会导致解析错乱) -
"→"(仅在双引号包围的属性值中必要) -
'→'(仅在单引号包围的属性值中必要;IE 不支持该实体,稳妥起见可统一用')
用 textContent 还是手动转义函数
如果只是往元素里塞纯文本,textContent 是最省心、零风险的选择——它完全绕过 HTML 解析器,浏览器不会把内容当 markup 处理。
但一旦你需要保留部分格式(比如用户发的「加粗文字」想渲染成 ),就必须走转义 + 有限白名单解析这条路,不能全量信任输入。
- 只显示不交互?优先用
textContent,快且绝对安全 - 要渲染富文本片段?先用转义函数处理全部内容,再对明确可控的标签(如
、)做白名单过滤,别碰<script></script>、、onxxx属性 - 别自己写正则去“删 script 标签”——容易被
或注释绕过ipt>
服务端转义和前端转义谁更可靠
服务端转义是底线,前端转义是补漏。如果后端返回的 JSON 字段已经做过 HTML 转义(比如 "),前端再用 innerHTML 插入时,实际渲染的是字面量 ,而非可执行结构。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
常见错误:前后端都以为对方处理了,结果谁都没做;或者后端转义了,前端又用 innerHTML 拼接未转义字段(比如从 URL 参数取值)。
- 后端输出 HTML 片段前,必须确保所有动态内容已转义(如 PHP 的
htmlspecialchars()、Python 的html.escape()) - 前端拿到数据后,除非明确知道是「已转义 HTML」,否则一律按原始字符串处理:显示用
textContent,插入 HTML 必须再过一遍转义逻辑 - 避免混合策略:比如后端转义了,前端又用
DOMPurify.sanitize(),既慢又可能误杀
JSON 中的 HTML 字符串怎么安全透传
API 返回的字段如果含 HTML(比如富文本编辑器内容),这个字符串本身就得是「已转义的 HTML 字符串」,而不是原始 HTML。否则前端一解码、一插入,XSS 就来了。
典型翻车点:{"content": "<script>alert(1)</script>"} 这种响应体,不管前端用不用 innerHTML,只要没转义就危险。
- 后端序列化 JSON 前,对所有可能含 HTML 的字段调用语言原生转义函数(如 Node.js 的
he.escape(),注意不是JSON.stringify自带的引号转义) - 前端收到后,若需渲染为 HTML,直接赋给
innerHTML即可;若需进一步处理,先用DOMParser解析再操作节点,别用字符串替换 - 警惕
JSON.parse()后直接拼接:el.innerHTML = '—— 此时' + data.content + ''data.content必须已是转义后的结果
最容易被忽略的是:富文本内容在数据库存的是原始 HTML,但 API 输出时忘了转义。这一层漏掉,前面所有前端防护都白搭。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










