当HTML元素内含多个文本节点（如空白符+标签+文字）时，text()仅返回首个纯文本节点，导致contains(text(), 'xxx')匹配失败；应改用.或normalize-space()精准定位目标文本。
当html元素内含多个文本节点（如空白符+标签+文字）时，`text()`仅返回首个纯文本节点，导致`contains(text(), 'xxx')`匹配失败；应改用`.`或`normalize-space()`精准定位目标文本。
在处理类似以下HTML结构时：
<code class="html"><td><a href="#" class=""> <i class="far fa-times mr-1"></i>Cancel</a></td></code>
你写的 XPath //a[contains(text(), 'Cancel')] 无法匹配，根本原因在于：<a> 元素实际包含两个文本节点（text node）：
- 第一个文本节点是
<a>开始标签后、<i>标签前的空白字符（空格、换行、制表符等），即" "； - 第二个文本节点是
</i>闭合后、</a>前的"Cancel"。
而 text() 函数返回的是所有直接子文本节点组成的节点集（node-set），但 contains() 的第一个参数要求是单个字符串（string）。当传入多节点集合时，XPath 会隐式取第一个节点并转为字符串——也就是 " "。因此 contains(" ", "Cancel") 恒为 false，匹配必然失败。
✅ 正确解法一：使用 .（当前节点的字符串值）. 表示“当前节点的合并文本内容”，它会自动将所有后代文本节点（包括嵌套标签内的文本）拼接为一个去标签、保留空白的字符串（即 " Cancel"）。此时：
<code class="xpath">//a[contains(., 'Cancel')]</code>
✔️ 成功匹配：因为 " Cancel" 包含子串 "Cancel"。
✅ 正确解法二：精准筛选非空文本节点
若需更严格地只匹配含有效字符的文本节点，可结合 normalize-space() 过滤空白节点：
<code class="xpath">//a[contains(text()[normalize-space()], 'Cancel')]</code>
其中 text()[normalize-space()] 是一个谓语（predicate）：normalize-space() 会移除首尾空白并压缩内部连续空白，对纯空白字符串返回空字符串 ""，而空字符串在布尔上下文中为 false，因此该表达式仅保留内容非空的文本节点（即 "Cancel" 节点），再对其执行 contains()。
⚠️ 注意事项：
- 避免依赖
text()匹配含 HTML 子元素的文本，这是常见陷阱； -
.更简洁通用，适合大多数“元素内含某文字”的场景； -
normalize-space(text())写法错误（normalize-space()作用于字符串，不能直接包裹text()节点集），必须用text()[normalize-space()]形式； - 若需完全忽略空白（如匹配
"Cancel"时容忍前后空格），可进一步写成//a[normalize-space(.) = 'Cancel']。
总结：XPath 中 text() 是节点集，. 是字符串值——理解二者差异，是写出健壮定位表达式的关键。
