本文介绍如何使用 beautifulsoup 的 css 选择器伪类 :-soup-contains-own() 实现跨子节点的全文本匹配，解决 find_all(string=...) 无法匹配被 html 标签分隔的连续文本的问题。
在 BeautifulSoup 中，find_all(string='xxx') 仅能匹配直接子节点为纯文本（NavigableString）且内容完全一致的元素，无法处理文本被 <br>、<span>、<em> 等标签打断的场景。例如以下 HTML：
<body>
<div>
Python
<br>
BeautifulSoup
</div>
</body>其中 "Python BeautifulSoup" 在视觉上是连续的，但在 DOM 结构中被 <br> 拆分为两个独立的文本节点。此时 find_all(string=re.compile(r'Python.*BeautifulSoup')) 将返回空列表，因为没有任何单个 NavigableString 同时包含这两个词。
✅ 正确方案：使用 CSS 选择器 + :-soup-contains-own() 伪类（BeautifulSoup 4.12.0+ 支持）
该伪类会调用目标元素的 .get_text(strip=True) 方法（默认以空格连接子文本），并执行子字符串匹配（非正则、不区分大小写），从而天然支持跨节点文本搜索。
✅ 基础用法示例
from bs4 import BeautifulSoup
html = '''
<body>
<div>
Python
<br>
BeautifulSoup
</div>
<p>Learn <strong>Python</strong> and <em>BeautifulSoup</em> together.</p>
</body>
'''
soup = BeautifulSoup(html, 'html.parser')
# 查找所有「自身文本内容」包含 "Python BeautifulSoup" 的标签（支持空格归一化）
results = soup.select(':-soup-contains-own("Python BeautifulSoup")')
for tag in results:
print(f"匹配标签: {tag.name}")
print(f"归一化文本: '{tag.get_text(' ', strip=True)}'")
print("---")输出：
匹配标签: div 归一化文本: 'Python BeautifulSoup' --- 匹配标签: body 归一化文本: 'Python BeautifulSoup Learn Python and BeautifulSoup together.' ---
? 注意：:-soup-contains-own() 匹配的是 元素自身的直接文本内容（即 tag.get_text() 的结果），不递归包含子元素的嵌套文本；若需包含全部后代文本，请改用 :-soup-contains()（但可能误匹配无关深层内容）。
⚠️ 重要注意事项
- ✅ 必须使用 select() / select_one()：find_all() 不支持伪类，不可写作 find_all(':-soup-contains-own(...)')。
- ✅ 自动空格标准化：get_text(' ', strip=True) 会将换行、制表符、多空格统一为单空格，因此搜索 "Python BeautifulSoup" 可匹配 Python\n<br>\nBeautifulSoup。
- ❌ 不支持正则表达式：该伪类仅做子串匹配（类似 in 操作），如需正则，请结合 Python 过滤：
import re candidates = soup.select(':-soup-contains-own("Python")') matched = [t for t in candidates if re.search(r'Python\s+BeautifulSoup', t.get_text(' ', strip=True))] - ? 兼容性要求：需 BeautifulSoup ≥ 4.12.0，且解析器推荐使用 'html.parser' 或 'lxml'。
✅ 替代方案（旧版本兼容）
若无法升级 BS4，可手动实现跨节点文本搜索：
def find_by_full_text(soup, text, tag=None):
"""查找自身 get_text() 包含指定文本的所有标签"""
targets = soup.find_all(tag) if tag else soup.find_all(True)
return [t for t in targets if text in t.get_text(' ', strip=True)]
# 使用
results = find_by_full_text(soup, "Python BeautifulSoup")但此方法性能较低（遍历全部标签），且不支持 CSS 选择器语法，推荐优先使用 :-soup-contains-own()。
总之，:-soup-contains-own("...") 是 BeautifulSoup 中精准、高效、语义清晰的跨节点文本搜索标准方案，应作为处理此类需求的首选。
