Django 如何组合可变数量的过滤参数实现多关键词搜索？

核心逻辑 #

不用提前统计搜索词个数，按步骤拆词、逐次叠加过滤即可，所有过滤条件默认以AND逻辑连接，和需求里的SQL逻辑完全匹配。

• 第一步：把用户输入的原始搜索串按空白拆分，自动得到独立的搜索词列表
• 第二步：循环给查询集叠加对应字段的匹配规则，循环多少次就叠加多少个过滤条件，完全不需要硬编码参数数量。

具体代码实现 #

先导入需要的依赖：

from django.db.models import Q

可直接复用的逻辑代码：

# 从请求里取用户输入的搜索内容，没传的话默认是空串
search_input = request.GET.get('q', '')
# 按空白拆分搜索词：自动忽略首尾空格、连续多空格的分隔问题
search_terms = search_input.split()

# 先拿到全量的模型查询集
queryset = YourTableModel.objects.all()

# 逐词叠加过滤
for term in search_terms:
    # icontains 对应不区分大小写的 LIKE '%关键词%' 匹配
    queryset = queryset.filter(your_col__icontains=term)

实际匹配效果 #

当用户输入的搜索串是"a b c"，拆分后得到的列表是["a", "b", "c"]，循环3次叠加过滤后，最终生成的查询SQL和需求里的示例完全一致，就是三个LIKE条件用AND连接。
不管用户输入1个、5个还是任意多个搜索词，逻辑都会自动适配，不需要写额外的判断分支。

等价写法参考 #

如果习惯先把所有过滤条件拼好再做单次查询，也可以用Q对象逐次做AND连接，和上面的循环filter效果没有区别：

# 初始化空Q对象，不会对查询结果造成干扰
q_filter = Q()
for term in search_terms:
    q_filter &= Q(your_col__icontains=term)

queryset = YourTableModel.objects.filter(q_filter)

实用细节 #

• 要是用户只输入了空格，split()拆分后会得到空列表，循环根本不会执行，会直接返回全量数据，不会出现匹配空字符串的无效查询，不需要额外写空值判断。
• 用icontains而不是contains的原因是，前者对应不区分大小写的匹配，更符合日常搜索的使用习惯，不会因为大小写差异漏匹配结果。
• 如果后续要扩展成同时匹配多个字段（比如同时搜索标题和内容），只要在循环里叠加多个字段的过滤条件就行，整体逻辑不用改。

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