FilterSet不生效的根本原因是视图未将filter().qs结果传给模板；需确认使用.qs、字段名匹配、正确编码URL、CharFilter加icontains或method自定义空值处理、表单method为get、ListView中重写get_queryset并返回self.filterset.qs。
django-filter安装后为什么FilterSet不生效
常见现象是页面能正常渲染，但URL参数传入后QuerySet完全没变化。根本原因通常是视图中没把过滤后的QuerySet传给模板——filter()返回新QuerySet，不会原地修改。
实操建议：
- 确认视图中使用了
qs = MyFilterSet(request.GET, queryset=MyModel.objects.all()).qs，而不是只调用MyFilterSet(request.GET, ...)却不取.qs - 检查
request.GET是否真有参数：比如访问/list/?name=abc，但FilterSet里定义的是title = CharFilter(...)，字段名不匹配就静默忽略 - Django 4.2+ 默认CSRF中间件会拦截GET请求中的某些特殊字符，若参数含
%或+，需确保URL已正确编码
如何让CharFilter支持模糊搜索和空值忽略
CharFilter默认是精确匹配，且当输入为空字符串时仍会生成field__exact=''查询，常导致意外结果。
实操建议：
- 加
lookup_expr='icontains'启用模糊搜索：name = CharFilter(field_name='name', lookup_expr='icontains') - 用
method参数自定义逻辑，跳过空值：def filter_name(self, queryset, name, value): if not value: return queryset return queryset.filter(name__icontains=value) name = CharFilter(method='filter_name') - 避免在
FilterSet.Meta.fields里直接声明'name': ['icontains']，这种写法只对ModelMultipleChoiceFilter等少数类型有效，对CharFilter无效
前端表单提交后URL参数重复叠加怎么办
典型表现：点两次筛选按钮，URL变成?name=a&name=b&name=c，后端收到request.GET.getlist('name')却只取第一个值，造成漏数据。
实操建议：
- 模板中用
{{ filterset.form.name.value|default:'' }}显式回填当前值，防止用户手动改URL后丢失上下文 - 表单
的method必须为get，且不要用JavaScript重复submit；Django FilterSet本身不处理多值合并逻辑 - 如需支持多选，改用
MultipleChoiceFilter并配合request.GET.getlist()，而非多个同名CharFilter
FilterSet和ListView结合时分页失效的根源
错误写法：queryset = MyModel.objects.all()写死在ListView类属性里，导致get_queryset()没被调用，FilterSet完全没机会介入。
实操建议：
- 必须重写
get_queryset()方法：def get_queryset(self): qs = MyModel.objects.all() self.filterset = MyFilterSet(self.request.GET, queryset=qs) return self.filterset.qs - 把
self.filterset挂到实例上，方便模板里渲染表单：{{ view.filterset.form }} - 分页器（
Paginator）作用于self.filterset.qs，不是原始qs；否则分页数按未过滤总数计算，翻页后数据错乱
过滤逻辑嵌套越深，越容易在get_queryset和.qs之间漏掉一次赋值。只要URL参数出现、但数据库查询SQL里没对应WHERE条件，第一反应就该查这两处。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
