Django如何实现支持多关键词大小写模糊匹配的自定义搜索过滤器

1. 视图逻辑编写 #

首先在处理该请求的Django视图中，引入Q对象用于构造多条件或查询，再按如下逻辑处理搜索请求：

from django.db.models import Q
from .models import Book

def book_list(request):
    # 获取搜索框传入的内容，空默认值避免异常
    search_content = request.GET.get("search_box", "").strip()
    # 初始查询集为所有书籍，可按自己的需求提前加其他筛选条件
    book_queryset = Book.objects.all()

    if search_content:
        # 拆分输入为单个词汇列表
        word_list = search_content.split()
        # 初始化查询条件容器
        search_condition = Q()

        # 添加单个词汇的匹配规则（大小写不敏感）
        for word in word_list:
            search_condition |= Q(title__icontains=word)

        # 添加所有连续短语的匹配规则，短语长度从2个词到整个输入长度
        for phrase_len in range(2, len(word_list) + 1):
            # 滑动取连续的词拼接成短语
            for start_idx in range(len(word_list) - phrase_len + 1):
                current_phrase = " ".join(word_list[start_idx: start_idx + phrase_len])
                search_condition |= Q(title__icontains=current_phrase)

        # 应用查询条件，去重避免同一本书匹配多个条件返回多次
        book_queryset = book_queryset.filter(search_condition).distinct()

    # 将查询结果传入模板渲染即可
    return render(request, "你的模板文件路径.html", {"books": book_queryset})

2. 逻辑说明 #

• title__icontains是Django ORM原生提供的大小写不敏感包含查询，不需要自己额外处理大小写转换
• 所有条件用|（或逻辑）拼接，只要书名满足任意单个词汇或者任意连续短语的匹配规则，就会被查询到
• 末尾加distinct()是为了避免同一本书同时匹配多个条件时出现重复结果

可选优化 #

如果你的书籍数据量超过万级，上面的模糊查询性能会有下降，可以选择对接全文检索组件（比如Whoosh、Elasticsearch）来提升搜索效率。

内容的提问来源于stack exchange，提问作者Стопчак Олег