优化Django多字段匹配查询集：实现排除登录用户的搜索功能

你的原有代码存在多次数据库查询、逻辑冗余的问题，下面是两种更优的实现方式：

基础优化：单次查询完成匹配与排除 #

直接通过Q对象组合多个字段的模糊匹配条件，同时排除当前登录用户，仅需一次数据库查询即可完成需求：

if search_name is not None and len(search_name) >= 3:
    search_obj = User.objects.filter(
        Q(first_name__iexact=search_name) |
        Q(last_name__iexact=search_name) |
        Q(username__iexact=search_name),
        ~Q(id=logged_user_id)
    )

保留优先级排序的优化方案 #

如果你的原逻辑是希望优先展示匹配first_name的用户，其次是last_name，最后是username，可以通过数据库层面的排序实现这一优先级，同时维持QuerySet的特性：

from django.db.models import Case, When, Value, IntegerField

if search_name is not None and len(search_name) >= 3:
    # 定义排序权重：匹配first_name的用户权重最低，排在最前
    priority_sort = Case(
        When(first_name__iexact=search_name, then=Value(1)),
        When(last_name__iexact=search_name, then=Value(2)),
        When(username__iexact=search_name, then=Value(3)),
        output_field=IntegerField(),
    )

    search_obj = User.objects.filter(
        Q(first_name__iexact=search_name) |
        Q(last_name__iexact=search_name) |
        Q(username__iexact=search_name),
        ~Q(id=logged_user_id)
    ).order_by(priority_sort)

优化后的优势 #

• 仅执行一次数据库查询，大幅减少数据库交互开销
• 返回的是QuerySet对象，支持惰性求值、分页、后续过滤等操作，比拼接列表灵活得多
• 代码逻辑清晰，避免了冗余的条件判断和重复查询代码
• 排序逻辑在数据库层面完成，性能远优于Python端拼接列表

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