在SQLite（SQLAlchemy ORM）中如何按含标点关键词检索文本？

核心需求 #

要检索包含独立关键词的语句——不管关键词在句首、句尾，还是前后带标点（比如example.或...continue），同时避免匹配把关键词当子串的无关内容（比如搜example不匹配examples）。

靠谱解决方案：正则表达式匹配 #

SQLite从3.38.0版本开始支持REGEXP操作符（或regexp_match函数），结合SQLAlchemy可以轻松实现独立单词匹配：

步骤1：构造正则表达式 #

先转义关键词里的特殊字符，再加上单词边界规则，同时支持大小写不敏感：

import re

keyword = "example"
# 转义正则特殊字符，避免语法冲突
escaped_keyword = re.escape(keyword)
# 正则规则：匹配独立单词，忽略大小写
regex_pattern = rf'(?i)\b{escaped_keyword}\b'

• (?i)：开启大小写不敏感匹配
• \b：匹配单词边界（字母/数字/下划线和标点/空格/换行的分界处），完美覆盖句首、句尾、标点前后的场景

步骤2：在SQLAlchemy中执行查询 #

用func调用SQLite的正则功能：

from sqlalchemy import func

# 假设你的表模型是Message，message字段存目标语句
results = session.query(Message).filter(
    func.message.op('REGEXP')(regex_pattern)
).all()

如果你的SQLite版本支持regexp_match，也可以这么写：

results = session.query(Message).filter(
    func.regexp_match(Message.message, regex_pattern) is not None
).all()

兼容旧版SQLite的替代方案 #

如果SQLite版本太老不支持正则，用LIKE组合多条件模拟独立单词匹配：

from sqlalchemy import or_

keyword = "example"
# 覆盖四种场景：句首带标点、句尾带标点、中间带标点、字段就是关键词本身
conditions = [
    Message.message.ilike(f'{keyword}[^a-zA-Z0-9]%'),
    Message.message.ilike(f'%[^a-zA-Z0-9]{keyword}'),
    Message.message.ilike(f'%[^a-zA-Z0-9]{keyword}[^a-zA-Z0-9]%'),
    Message.message.ilike(keyword)
]

results = session.query(Message).filter(or_(*conditions)).all()

这种方法虽麻烦，但能覆盖大部分场景，缺点是需要手动定义非单词字符范围，灵活性不如正则。

为什么之前的方法失效？ #

• startswith/endswith：只能匹配关键词在绝对开头或结尾，忽略了前后带标点的情况
• ilike(f' {keyword} ')：只匹配前后是空格的场景，不支持标点
• ilike(f'%{keyword}%')：会匹配关键词作为子串的内容（比如搜cat匹配category）

内容的提问来源于stack exchange，提问作者Mostafa Najmi