必须显式传入childList: true，否则MutationObserver不会监听子节点增删；它仅监听目标节点的直接子节点，深层变动需配合subtree: true，且目标节点必须是实际被操作的父容器。
childList: true 为什么必须显式传入
MutationObserver 不会自动监听任何变化，childList: true 是开启子节点增删监听的开关。漏掉它，哪怕 DOM 真实新增了元素，回调也完全不会触发。
常见错误现象：console.log 一行不输出，但用开发者工具确认节点已插入；或者只监听到部分变化（比如删了没反应、加了有反应）。
- 仅
new MutationObserver(callback)不够，必须调用observe(target, { childList: true }) - 目标节点必须是实际被操作的父容器——例如你往
#list里append()，就得观察#list，而不是它的某个子li或document.body -
childList: true默认只监听「直接子节点」，不包含后代节点。深层嵌套变动（比如#list > .item > span被替换）不会被捕获
subtree: true 要不要开？开多大范围才合理
加 subtree: true 后，childList: true 的作用域会从「仅 target 的直系子节点」扩展到「target 及其所有后代节点」。但它不是免费的——会显著增加监听开销，且容易误触发无关变动。
使用场景判断：
立即学习“前端免费学习笔记（深入）”；
html-to-pptx-converter
下载
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
- 需要监听动态组件内部结构（如 Vue/React 渲染后插入的子树），且无法提前知道具体插入位置 → 开
subtree: true - 只关心某个固定容器内的一级列表项（如评论区每条
.comment的增删）→ 关闭subtree，更轻量、更可控 - 若同时开了
subtree: true和attributes: true，又没配attributeFilter，可能因 class 切换、style 更新等频繁触发回调
监听不到新增节点？先查 target 是否还活着
框架（Vue/React）下最常踩的坑：observer 绑定的 target 节点被框架整个替换了（比如 v-if 切换、key 变更导致旧 DOM 卸载）。此时 observer 并不会报错或重连，而是静默失效。
验证方式：
- 在回调里打印
mutation.target === yourTargetNode，返回false就说明 target 已失联 - 检查是否在节点挂载前就调用了
observe()—— 对于异步渲染内容，得等mounted或useEffect执行后再初始化 observer - 更稳的做法：监听一个生命周期稳定的父容器（如
#app或.content-wrapper），配合childList: true+subtree: true，靠mutation.addedNodes过滤出你真正关心的节点类型
回调里怎么安全读取新增节点内容
MutationObserver 回调是异步 microtask，执行时 DOM 已更新，但某些节点可能尚未完成内部初始化（比如自定义元素的 connectedCallback 还没跑完）。
实操建议：
- 用
node.nodeType === Node.ELEMENT_NODE过滤掉文本节点（空格、换行符等），避免误处理 - 不要直接访问
node.innerHTML或node.textContent后立刻做复杂逻辑，尤其当节点含异步加载内容（如图片、iframe）时 - 若需等子元素就绪，可用
node.querySelector配合简单存在性检查，或对关键子节点再设一层MutationObserver - 避免在回调里反复调用
querySelectorAll全局扫描——性能差，且结果可能和当前mutation记录不一致
最易忽略的一点：observer 不是“监听 innerHTML 字符串变化”，而是监听 DOM 树结构变动。改 innerHTML 会触发 childList，但改 textContent 属于 characterData 类型，得单独开 characterData: true 才能捕获。
