本文介绍如何用单条xpath表达式实现“优先匹配某条件，若不存在则回退到另一条件”的逻辑，并确保只返回文档中第一个匹配项。
在XPath中，要实现类似编程语言中“短路优先匹配”的行为（即先尝试 //*[@selected]/@value，仅当其无结果时才取 //text() 的首个匹配），关键在于理解节点集的合并与排序规则。
XPath 1.0 虽不支持原生的条件判断或序列短路，但可利用节点集的并集运算符 | 结合 位置谓词 [1] 实现等效效果：
(//*[@selected]/@value | //text())[1]
✅ 原理说明：
- | 运算符将两个路径的结果合并为一个按文档顺序排序的节点集（去重且自动排序）；
- 因此，只要 //*[@selected]/@value 在文档中存在任意匹配节点，它一定排在 //text() 的任何节点之前（因其是元素属性，而 //text() 匹配的是文本节点，而属性节点在XPath数据模型中不参与同级排序——但实际浏览器/引擎中，//@attr 和 //text() 属于不同节点类型，其合并后顺序依实现而定）；
⚠️ 注意：严格来说，XPath 1.0 规范中 //@value | //text() 的合并结果不保证跨节点类型的文档顺序一致性（如属性节点 vs 文本节点），因此更健壮、语义明确的方式是使用 XPath 2.0+ 或支持序列的引擎。
✅ 推荐方案（现代环境）：
若使用 SaxonJS（支持 XPath 3.1），可直接用逗号分隔的序列构造器，天然支持“首非空”逻辑：
(//*[@selected]/@value, //text())[1]
该表达式生成一个序列：先尝试所有 @value 属性节点，再追加所有文本节点；[1] 取序列中第一个有效项——完全符合“优先匹配、失败则回退”的语义，且无需担心节点类型排序问题。
jm-jsjkxyjs02-zlm-405
下载
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
? 使用示例（JavaScript + SaxonJS）：
const result = SaxonJS.XPath.evaluate(
'(//*[@selected]/@value, //text())[1]',
document,
{ namespaceContext: {} }
);
console.log(result?.stringValue ?? null); // 安全获取字符串值? 注意事项：
- 浏览器原生 document.evaluate() 仅支持 XPath 1.0，不识别 , 序列语法，此时 (//*[@selected]/@value | //text())[1] 是最简兼容写法，但在复杂 DOM 中建议配合 JavaScript 二次校验；
- 若需支持多级回退（如 A → B → C），XPath 3.1 序列表达式可自然扩展为 (A, B, C)[1]；
- 始终注意 //text() 可能匹配大量空白文本节点，生产环境建议限定上下文（如 //div//text()[normalize-space()]）以提升准确性和性能。
综上，单条XPath实现条件优先匹配的核心在于：用序列（XPath 2.0+）替代并集，用 [1] 提取首有效项——简洁、可读、可扩展。
