节点自身并无直接文本子节点（text() 返回空），而 descendant::text() 在某些浏览器驱动实现中可能因解析差异或惰性求值未被可靠支持，致使原 XPath 始终返回空列表。
✅
推荐解决方案：改用 normalize-space() + contains() 组合，真正实现不区分大小写的文本匹配
立即学习
“
前端免费学习笔记（深入）
”；
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
def find_elements_containing_products(driver, timeout=10):
"""
查找页面中任意层级、文本内容包含 'products'（不区分大小写）的所有元素
使用 normalize-space() 清理空白并转小写，确保稳定匹配
"""
xpath = "//*[contains(translate(normalize-space(text()), 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz'), 'products')]"
# 等待至少一个匹配元素出现（避免因加载延迟导致空结果）
WebDriverWait(driver, timeout).until(
EC.presence_of_element_located((By.XPATH, xpath))
)
return driver.find_elements(By.XPATH, xpath)
?
关键改进说明：
normalize-space(text())：先提取当前元素的
直接文本子节点
（即 Products 中的 "Products"），再去除首尾空白及内部多余换行/制表符；
translate(...)：将清洗后的文本统一转为小写，再与 'products' 比较；
显式 WebDriverWait：规避因 DOM 未就绪导致的“查无此元素”假阴性；
不依赖 descendant::text()：避免跨层级文本拼接不可靠的问题，聚焦语义明确的“元素自身显示文本”。
⚠️
注意事项：
若目标文本可能分布在多个相邻文本节点（例如 Products），则 text() 仅捕获第一个节点，此时需改用 .get_attribute("textContent") 配合 Python 端过滤（但性能略低）；
display: none 或 visibility: hidden 的元素，其 text() 返回空字符串，即使 HTML 中存在文本也不会被匹配——请确保目标元素已渲染且可见；
对于国际化站点，若需支持变体（如 "Products" / "products" / "PRODUCTS"），上述 translate 方案已天然覆盖所有大小写组合，无需冗余 | 合并表达式。
?
进阶建议（按需选用）：
若追求极致可读性与调试友好性，也可采用两阶段策略：先获取所有含非空文本的元素，再在 Python 中过滤：
elements = driver.find_elements(By.XPATH, "//*[@* or text()]")
filtered = [el for el in elements
if el.text.strip() and 'products' in el.text.strip().lower()]
但该方式在大型页面中性能较差，
生产环境仍首选优化后的 XPath + 显式等待
。
综上，修正核心在于：
放弃不可靠的 descendant::text()，转向 normalize-space(text()) 提取有效文本，并辅以显式等待与可见性保障
——这既是 XPath 最佳实践，也是 Selenium 稳定定位的基石。
