不能。NodeIterator 仅线性遍历文档顺序节点，不自动进入子树；需配合手动查询或改用 TreeWalker 才能实现真正深度优先嵌套匹配。
NodeIterator 能不能直接深度递归遍历子树？
不能。NodeIterator 本身是单层迭代器，只按文档顺序线性访问节点，不自动进入子节点——哪怕你设置了 whatToShow: NodeFilter.SHOW_ELEMENT，它也不会“递归跳进”嵌套的 <div> 或 <code><pre class="brush:php;toolbar:false;"></code> 内部去检查深层结构。</p>
<p>常见误解是以为 <code>NodeIterator</code> 和 <code>TreeWalker</code> 行为一致；其实 <code>TreeWalker</code> 才内置了 <code>firstChild()</code>/<code>nextNode()</code> 等导航方法，天然支持深度优先遍历。</p>
<ul>
<li>如果你需要“匹配某类嵌套结构”，比如所有包含 <code>class="highlight"</code> 且内部有 <code><code></code> 标签的 <code><pre class="brush:php;toolbar:false;"></code> 块，NodeIterator 单靠 <code>nextNode()</code> 无法保证捕获到内层 <code><code></code></li>
<li>必须配合手动递归或改用 <code>TreeWalker</code>，否则会漏掉深层节点</li>
<li>浏览器中 <code>NodeIterator</code> 的 <code>expandEntityReferences</code> 参数已被废弃，不用考虑兼容性</li>
</ul>
<H3>用 NodeIterator + 手动递归实现“伪深度检索”</H3>
<p>可行，但得自己补全子树遍历逻辑：拿到一个节点后，若它符合初步条件（如是 <code><pre class="brush:php;toolbar:false;"></code>），就用 <code>node.querySelectorAll()</code> 或递归函数检查其后代是否含目标模式。</p>
<p>例如检索所有带 <code>data-language="python"</code> 的 <code><pre class="brush:php;toolbar:false;"></code> 中，是否含有被 <code><span class="keyword"></code> 包裹的 <code>def</code>：</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
<p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力：
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面；
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”；
- 提及位于 `apps/console/src/featur</p>
</div>
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）</a>”；</p>
<pre class='brush:php;toolbar:false;'>const iter = document.createNodeIterator(
document.body,
NodeFilter.SHOW_ELEMENT,
{
acceptNode: node =>
node.tagName === 'PRE' && node.dataset.language === 'python'
? NodeFilter.FILTER_ACCEPT
: NodeFilter.FILTER_REJECT
}
);
let candidate;
while ((candidate = iter.nextNode())) {
// 手动深入后代查找
const keywordSpans = candidate.querySelectorAll('span.keyword');
const hasDef = Array.from(keywordSpans).some(span =>
span.textContent.trim() === 'def'
);
if (hasDef) {
console.log('Found Python def block:', candidate);
}
}</pre>
<ul>
<li>这里 <code>NodeIterator 只负责“快速定位候选容器”，真正的模式匹配交给 querySelectorAll 完成
acceptNode 里做 DOM 查询（性能差、易出错）querySelectorAll 返回的是静态 NodeList，不会受后续 DOM 变更影响为什么不用 TreeWalker 直接替代？
因为 TreeWalker 天然支持深度优先遍历，写法更贴近“递归检索”的直觉。如果你的目标是“对每个节点判断是否匹配某嵌套条件”，它比手动补递归更简洁可靠。
等价功能的 TreeWalker 写法：
const walker = document.createTreeWalker(
document.body,
NodeFilter.SHOW_ELEMENT,
{
acceptNode: node => {
if (node.tagName !== 'PRE') return NodeFilter.FILTER_SKIP;
if (node.dataset.language !== 'python') return NodeFilter.FILTER_SKIP;
// 深度检查：当前 pre 下是否有 span.keyword 包含 'def'
const defSpan = node.querySelector('span.keyword');
return defSpan && defSpan.textContent.trim() === 'def'
? NodeFilter.FILTER_ACCEPT
: NodeFilter.FILTER_REJECT;
}
}
);
let node;
while ((node = walker.nextNode())) {
console.log('Matched Python def block:', node);
}
-
TreeWalker的acceptNode是在每个节点被访问时调用，包括所有后代节点，所以能自然覆盖嵌套层级 - 但要注意：如果在
acceptNode中执行复杂查询（如多次querySelector），可能拖慢遍历速度 - 某些老项目禁用
TreeWalker（因 IE9+ 才完全支持），此时才需退回到NodeIterator+ 手动查后代
容易忽略的 DOM 动态性问题
NodeIterator 和 TreeWalker 都基于快照机制——创建时确定可访问范围，之后 DOM 变更（如插入新 <pre class="brush:php;toolbar:false;"></pre>）不会自动纳入迭代范围。
- 如果你在监听
DOMSubtreeModified或使用MutationObserver后重新构建NodeIterator，记得清空旧引用，否则可能持有已移除节点的句柄 - 不要在
acceptNode或循环体中修改正在遍历的 DOM 结构（如node.remove()），会导致迭代器行为异常甚至跳过节点 - 若目标节点可能被 Shadow DOM 封装，
NodeIterator默认不穿透，需显式传入{ mode: 'include' }（仅 Chromium 120+ 支持）
