Django视图中搜索结果为空时返回默认QuerySet并通知模板

这问题我之前做项目时也碰到过，给你一套清晰的实现方案：

1. 改造get_queryset处理空筛选结果 #

我们可以在方法里先执行搜索筛选，判断结果是否为空。如果有搜索参数但没找到匹配项，就返回默认的QuerySet，同时用一个实例变量标记这个状态：

def get_queryset(self, *args, **kwargs):
    self.search_no_results = False  # 初始化状态标记
    qs = super().get_queryset()
    search_query = self.request.GET.get('q')
    
    if search_query:
        filtered_qs = qs.search_by_keyword(search_query)
        # 用exists()判断是否为空，比直接if not filtered_qs更高效
        if not filtered_qs.exists():
            self.search_no_results = True
            return qs  # 返回默认的全部结果
        return filtered_qs
    return qs

2. 把状态传递到模板 #

重写get_context_data方法，把刚才的状态标记加到上下文里，方便模板使用：

def get_context_data(self, **kwargs):
    context = super().get_context_data(**kwargs)
    # 只有当用户确实做了搜索且无结果时，才让模板显示提示
    context['show_empty_search_message'] = self.search_no_results and self.request.GET.get('q') is not None
    return context

3. 在模板中展示提示信息 #

现在你可以在模板里根据show_empty_search_message变量来显示对应的提示：

{% if show_empty_search_message %}
    <div class="notice">
        未找到您搜索的内容，为您展示全部结果。
    </div>
{% endif %}

<!-- 渲染结果列表 -->
{% for item in object_list %}
    <!-- 你的列表项内容 -->
{% endfor %}

额外说明： #

• 用exists()判断QuerySet是否为空是最佳实践，它只会执行一条轻量的SELECT EXISTS SQL语句，不会加载所有数据到内存，性能更好。
• 我们特意在上下文变量里加上了self.request.GET.get('q') is not None的判断，这样就不会在用户没有发起搜索时误显示提示信息。

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