contains()是XPath中用于判断字符串是否包含指定子串的函数，返回布尔值，不区分大小写、不支持正则，常用于模糊定位元素，基本格式为contains(字符串,子串)。
contains() 是 XPath 中最常用的字符串匹配函数之一，用来判断某个字符串是否**包含**指定的子串，返回布尔值（true 或 false）。它不区分大小写，也不支持正则，但简单直接，特别适合模糊定位元素。
基本语法和用法
函数格式是：contains(字符串, 子串)。两个参数都必须是字符串类型，通常第一个参数用节点的文本内容（如 text()）或属性值（如 @class），第二个参数是你要查找的关键词。
htmlppt.skill
下载
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- ✅ 正确写法：
contains(text(), '提交')—— 匹配文本中含“提交”的元素 - ✅ 常见组合：
contains(@class, 'btn-primary')—— 匹配 class 属性包含 "btn-primary" 的元素 - ⚠️ 注意：如果 text() 返回多个文本节点，
contains(text(), ...)可能行为不稳定，建议用contains(string(.), ...)更稳妥
实际定位场景举例
假设网页中有这样一段 HTML：
订单已成功提交
- 找按钮：“提交”在文本里 →
//button[contains(text(), '提交')] - 找 div：“已成功提交”含“提交” →
//div[contains(text(), '提交')] - 按 class 模糊匹配 →
//*[@class and contains(@class, 'btn')]（匹配所有 class 含 “btn” 的元素）
常见坑和注意事项
- ❌
contains()不支持通配符或正则，比如contains(text(), '提*交')会报错 - ❌ 参数不能为节点集（除非自动转为字符串），像
contains(div, 'abc')是错的；应写成contains(div/text(), 'abc')或contains(div, 'abc')（此时 div 被隐式转为字符串） - ✅ 多关键词组合？用
and连接：//a[contains(@href, 'user') and contains(text(), '编辑')] - ✅ 忽略大小写？XPath 1.0 本身不支持，可配合 translate() 函数模拟，但更推荐在支持 XPath 2.0+ 的环境（如 Selenium 4+）中用
matches()
基本上就这些。掌握 contains() 就能解决 80% 的动态/不完整文本匹配需求，不复杂但容易忽略细节。
