textContent 是最稳的批量改纯文本方案,它只修改文字内容、不解析HTML、天然防XSS、不破坏事件监听和表单值。

用 textContent 批量改纯文本,不碰结构也不执行脚本
页面加载后想批量更新文字(比如把所有“旧版本”换成“v2.1”),又不想误删按钮、破坏事件监听、或触发 XSS,textContent 是最稳的选择。它只改文字内容,跳过 HTML 解析,天然防注入,性能也比 innerHTML 高。
常见错误现象:el.innerHTML = '新文本' 导致按钮点击失效、表单输入值清空、<script></script> 被执行;而 el.textContent = '新文本' 不会。
- 必须先选中目标元素:推荐用
document.querySelectorAll('p, h2, .content-text'),避免用getElementsByClassName(返回实时集合,遍历时可能漏项) - NodeList 不支持原生
forEach(IE 和旧 Safari 会报错),安全写法是Array.from(elements).forEach(...)或[...elements].forEach(...) - 若要保留部分格式(如换行、空格),
textContent会压缩空白;此时需改用nodeValue直接操作文本节点,但得先过滤掉SCRIPT、STYLE等禁止修改的标签
用 document.createTreeWalker 安全遍历文本节点
当替换需求更精细——比如“只改用户可见文字,跳过注释、<script></script>、 里的字符串”,就得绕过元素层,直接走 DOM 树的文本节点(Node.TEXT_NODE)。document.createTreeWalker 比 querySelectorAll("*") 更准、更轻量,也不会误进隐藏区域。
使用场景:CMS 后台预览页做关键词高亮、无障碍文本替换、敏感词过滤。
- 必须排除干扰标签:
new Set(["SCRIPT", "STYLE", "NOSCRIPT", "TEXTAREA", "INPUT"])是硬性白名单,漏掉TEXTAREA会导致用户输入被覆盖 - 判断文本节点是否“可编辑”:检查
node.parentNode?.nodeType === Node.ELEMENT_NODE,避免处理文档根节点或注释节点 - 替换时别直接赋值
node.nodeValue,要用node.replaceData(0, node.length, newText),否则在某些浏览器里会丢光标位置或触发异常重排
正则 + innerHTML 替换?除非你确认内容绝对可信
内容innerHTML.replace(/旧词/g, '新词') 看似简单,实则高危。它把整个 HTML 当字符串处理,一旦“旧词”出现在 href、data-id、onclick 属性里,或嵌套在标签中间(如 ),就会一并替换,结构瞬间崩坏。
性能影响:每次 innerHTML = ... 都触发完整 DOM 解析和重排,100 个元素就卡顿明显。
- 仅限极简场景:整段静态 HTML 片段(无属性、无嵌套),且你完全控制源内容
- 若必须用正则,先提取
outerHTML,替换后再用DOMParser重新解析,而不是直接塞回innerHTML - 永远不要对
document.body.innerHTML做全局正则替换——事件监听器、已绑定的input值、Web Component 状态全部丢失
批量替换前,务必检查元素是否已挂载
脚本执行太早,document.querySelectorAll('.price') 返回空 NodeList,后续所有操作都静默失败。这不是逻辑错,是时机错。
容易踩的坑:在 里放脚本、没加 defer、也没监听 DOMContentLoaded。
- 最简方案:把
<script></script>标签移到前 - 通用方案:用
document.addEventListener('DOMContentLoaded', () => { /* 替换逻辑 */ }) - 动态插入的元素(如 AJAX 加载内容)需单独监听或用 MutationObserver,不能指望一次初始化全覆盖
真正难的不是“怎么换”,而是“换哪里、不换哪里、谁有权换”。DOM 结构越深、第三方组件越多,越要放弃“通杀式替换”,转而用语义化选择器(如 [data-replace])或明确限定作用域(如 container.querySelectorAll('.item p'))。否则修一个词,崩三个功能。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











