Django objects.filter实现单/多关键词排他性搜索问题求解

核心逻辑：单关键词时匹配所有含该关键词的条目，多关键词时要求条目必须命中所有拆分后的关键词（关键词可匹配不同字段），仅返回同时满足所有关键词匹配要求的结果。

原有方案问题说明 #

• 方案1：直接将完整带空格的查询串作为匹配值，仅当某个字段连续包含完整查询串时才会命中，无法匹配跨字段的关键词组合（比如John存于first_name、Smith存于last_name的场景）
• 方案2：循环中每次重置查询结果，最终仅保留最后一个关键词的匹配条目；且逻辑上未做关键词的AND约束，无法实现多关键词同时匹配的排他要求

正确实现代码 #

from django.db.models import Q

if query:
    # 拆分查询词，自动过滤空字符串、多余空白
    keywords = [word.strip() for word in query.split() if word.strip()]
    base_filter = Q()
    for word in keywords:
        # 单个关键词的匹配规则：命中任意一个可搜索字段即可
        single_word_match = (
            Q(first_name__icontains=word) |
            Q(last_name__icontains=word) |
            Q(username__username__icontains=word) |
            Q(email__icontains=word) |
            Q(telephone__icontains=word) |
            Q(mobile__icontains=word) |
            Q(job_title__icontains=word) |
            Q(department__icontains=word) |
            Q(address__address__icontains=word)
        )
        # 关键：用逻辑与叠加约束，要求条目必须匹配当前关键词
        base_filter &= single_word_match
    data = Profile.objects.filter(base_filter).distinct()

效果验证 #

• 搜索John：仅叠加1个关键词约束，返回所有任意可搜索字段包含John的条目，符合单关键词搜索预期
• 搜索Smith：同上，返回所有匹配Smith的条目
• 搜索John Smith：叠加两个关键词的AND约束，仅返回同时命中John、Smith两个词的条目（两个词可分布在不同字段），实现组合搜索的排他效果

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