在Django类视图中如何正确调用django-filter过滤器？

错误原因 #

原调用方式不正确，核心问题出在视图层的逻辑错误，具体如下：

1. 直接将WorkFilter实例化为类属性，没有传入GET请求参数和待过滤的数据集，过滤器无法生成对应表单、也无法执行过滤逻辑
2. 未将过滤器实例传递到模板上下文，模板中的{{myFilter.form}}无法获取到值，自然不会显示过滤表单
3. 未替换ListView默认返回的数据集，即使表单正常渲染，也不会展示过滤后的结果
4. 模板的过滤表单缺少提交按钮，无法触发过滤请求

改进方案 #

1. 修正views.py逻辑

from .filters import WorkFilter
from .models import work_allocation
from django.views.generic import ListView

class get_task_list(ListView):
    model = work_allocation
    # 若你自定义的模板名称不是默认的<app名>/work_allocation_list.html，需要手动指定
    template_name = "work.html"
    # 给模板中的数据集定义别名，方便渲染
    context_object_name = "task_list"

    def get_queryset(self):
        # 获取原始数据集
        original_qs = super().get_queryset()
        # 传入请求参数和原始数据集初始化过滤器
        self.filter_obj = WorkFilter(self.request.GET, queryset=original_qs)
        # 返回过滤后的数据集
        return self.filter_obj.qs

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        # 将过滤器实例传入模板上下文
        context["myFilter"] = self.filter_obj
        return context

2. 完善work.html模板

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>任务列表</title>
</head>
<body>
<h2>List of Tasks</h2>

<form method="GET">
    {{ myFilter.form }}
    <!-- 新增提交按钮触发过滤请求 -->
    <button type="submit">过滤</button>
</form>

<!-- 渲染过滤后的任务列表，可根据你的模型实际字段调整展示内容 -->
<ul>
{% for task in task_list %}
    <li>任务名称：{{task.task_name}} | 负责人：{{task.assign_user}}</li>
{% empty %}
    <li>未查询到符合条件的任务</li>
{% endfor %}
</ul>
</body>
</html>

3. 额外检查项

• 确认settings.py的INSTALLED_APPS列表中已添加django_filters
• 若不需要全字段过滤，可将WorkFilter中的fields = '__all__'替换为指定字段列表，比如fields = ['status', 'project', 'create_time']，避免暴露敏感字段
• 模型名work_allocation建议遵循Django命名规范调整为大驼峰格式WorkAllocation，不影响功能但更符合开发惯例

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