XPath中选择注释节点用comment()，它专用于匹配XML/HTML中的注释节点，不带参数、只匹配comment类型节点，支持路径定位、内容筛选及上下文组合，但需注意解析器对注释的支持差异。

XPath 中选择注释节点用 comment()，它是一个节点测试（node test），专门匹配 XML 或 HTML 文档中的注释节点（即 <!-- ... --> 内容）。

comment() 基本语法和匹配逻辑

comment() 本身不带参数，必须放在谓语中或作为节点测试使用。它只匹配类型为“comment”的节点，不匹配文本、元素或属性节点。

• //comment()：选取文档中所有注释节点（无论嵌套多深）
• /html/head/comment()：仅匹配 元素直接子节点中的注释
• //div/comment()[1]：选取每个 <div> 下第一个注释子节点<li> <code>//comment()[contains(., 'TODO')]：选取内容包含 "TODO" 的注释节点（注意：comment() 节点的字符串值就是其内部文本）

实际使用注意事项

HTML 解析器（如浏览器 DOM 或 lxml）对注释节点的支持程度不同。原生浏览器 XPath 引擎（如 Chrome/Firefox 的 document.evaluate）支持 comment()，但部分 HTML 解析库（如旧版 BeautifulSoup）默认不保留注释节点，需显式启用。


DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
下载
• 在 lxml 中需确保解析时传入 parser=etree.HTMLParser(remove_comments=False)，否则注释会被丢弃
• 注释节点没有标签名、属性或子节点，name() 返回空字符串，local-name() 和 namespace-uri() 同样无效
• string(comment()) 等价于 string(.)，返回注释内容（不含 <!-- 和 -->）

常见组合用法示例

结合位置、内容或上下文筛选注释，能精准定位开发标记或遗留说明：

• //comment()[preceding-sibling::h2][1]：选取每个 <h2></h2> 后面紧跟的第一个注释
• //*[comment()][1]：选取第一个包含注释子节点的元素
• //comment()[not(following::comment())]：选取最后一个注释节点（文档末尾的注释）

验证是否生效的小技巧

在浏览器控制台中可快速测试：

• 打开含注释的网页（如源码里有 <!-- version: 2.1 -->）
• 执行：document.evaluate('//comment()', document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null)
• 调用 .snapshotLength 查数量，或循环用 .snapshotItem(i).textContent 查内容