本文详解如何使用XPath精确匹配包含多个类名的HTML元素，重点解决@class属性中多类名匹配失效的问题，并提供可靠路径写法与实用技巧。
本文详解如何使用xpath精确匹配包含多个类名的html元素，重点解决`@class`属性中多类名匹配失效的问题，并提供可靠路径写法与实用技巧。
在使用 PHP 的 Advanced Parser（如基于 DOMDocument + DOMXPath 的解析器）时，许多开发者会误以为 //*[@class='product-price text-brand'] 能直接匹配同时拥有 product-price 和 text-brand 两个类名的元素。但这是错误的——因为 @class 属性值是完整字符串（如 "product-price text-brand"），而 XPath 的 = 是全等匹配，不是“包含某个类”的语义匹配。
✅ 正确做法是使用 contains() 函数配合空格边界处理，或更推荐——按实际 HTML 结构层级精准定位。
例如，若目标 HTML 结构如下：
<div class="product-price">
<ins>
<span class="text-brand">$29.99</span>
</ins>
</div>
则应使用结构化 XPath 路径：
$xpath = "//div[@class='product-price']/ins/span[@class='text-brand']"; $value = $this->xpathScalar($xpath);
该路径明确表达了层级关系：先找 class="product-price" 的 <div>，再在其子 <code><ins></ins> 中查找 class="text-brand" 的 <span></span>。不仅语义清晰、性能更优，也避免了 contains(@class, 'text-brand') 可能引发的误匹配（如匹配到 text-branding 或 my-text-brand）。
⚠️ 注意事项：
- 不要依赖
@class='xxx yyy'进行多类全等匹配——类名顺序不确定，且可能含多余空格或动态添加的类； - 若必须按类名“包含”逻辑匹配（如不确定父容器结构），可使用：
//span[contains(concat(' ', @class, ' '), ' text-brand ')]——通过前后加空格规避子串误判； - 始终优先依据 HTML 实际嵌套结构编写 XPath，而非仅靠类名堆砌；
- 使用
$this->xpathScalar()时，请确保传入的 XPath 返回唯一节点，否则可能返回空或首个匹配项，建议配合count()调试验证路径准确性。
总结：XPath 的力量在于结构感知，而非字符串模糊搜索。从 DOM 树出发，逐层定位，才是稳定、可维护的解析之道。
