自定义Django Manager无法在模板中调用生效，该如何解决？

问题原因 #

你的写法存在三个核心问题：

1. ListView默认传递给模板的tasks是已经执行完成的任务实例集合（可迭代对象），既不是TaskManager管理器实例，也不是未计算的QuerySet，本身不存在available方法。
2. Django模板语法不支持直接调用带括号的方法，就算上下文里传入了管理器对象，tasks.available只会把方法本身作为属性判断是否存在，不会执行方法返回筛选结果。
3. 你自定义的available是管理器的实例方法，只能从模型类的objects入口调用（比如Task.objects.available()），不能在查询结果集、模型实例上直接调用。

解决方法 #

方案1：视图层调用自定义管理器（推荐，符合Django分层规范） #

不需要把筛选逻辑放到模板，直接重写ListView的get_queryset方法，调用你写好的管理器方法即可，同时保留自带的分页功能：

class TaskList(ListView):
    model = models.Task
    context_object_name="tasks"
    template_name = "home/list.html"
    paginate_by=5  

    def get_queryset(self):
        # 调用自定义管理器的available方法获取已筛选的查询集
        return models.Task.objects.available()

方案2：模板层调用（不推荐，业务逻辑不建议放在视图/模型外） #

如果一定要在模板中完成筛选，需要先把模型管理器传入模板上下文，再直接遍历筛选结果：
首先修改视图新增上下文变量：

class TaskList(ListView):
    model = models.Task
    context_object_name="tasks"
    template_name = "home/list.html"
    paginate_by=5  

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        # 把模型管理器传入模板
        context["task_manager"] = models.Task.objects
        return context

然后修改模板代码，直接遍历筛选后的结果：

{% for task in task_manager.available %}
  <!-- 单个任务渲染逻辑 -->
{% endfor %}

注意：该方案会覆盖ListView自带的分页功能，不建议生产环境使用。

拓展优化（可选） #

如果你需要在链式查询的任意环节调用available筛选（比如Task.objects.filter(create_time__gt=xxx).available()），可以改为自定义QuerySet实现更灵活的调用：

class TaskQuerySet(models.QuerySet):
    def available(self):
        return self.filter(is_deleted=False)

class Task(models.Model):
    # 你的原有字段
    is_deleted = models.BooleanField(default=False)
    # 把自定义QuerySet注册为管理器
    objects = TaskQuerySet.as_manager()

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