如何为Django中Manager.from_queryset()的返回值做类型注解？

针对你遇到的Pylance无法识别from_queryset生成的动态类方法的问题，这里有几种可行的解决方案：

方案一：使用Protocol定义合并接口（推荐） #

通过typing.Protocol定义一个包含CustomManager和CustomQuerySet所有公开方法的协议，让类型检查器明确知道objects实例具备的方法：

from typing import Protocol
from django.db import models

class CustomQuerySet(models.QuerySet):
    def live(self):
        return self.filter(is_draft=False)

class CustomManager(models.Manager):
    def publish(self, instance: "MyModel"):
        instance.is_draft = False
        instance.save()

# 定义协议，涵盖两个类的方法
class CombinedManagerProtocol(Protocol):
    def publish(self, instance: "MyModel") -> None: ...
    def live(self) -> CustomQuerySet: ...

class MyModel(models.Model):
    objects: CombinedManagerProtocol = CustomManager().from_queryset(CustomQuerySet)()

    is_draft = models.BooleanField(blank=True, default=True)

这种方式不需要修改原有的Manager和QuerySet实现，只是给类型检查器提供明确的接口定义，不会影响运行时逻辑。

方案二：显式创建合并类 #

绕过动态生成的方式，直接创建一个继承CustomManager并集成CustomQuerySet方法的类，让类型注解完全清晰：

from django.db import models

class CustomQuerySet(models.QuerySet):
    def live(self):
        return self.filter(is_draft=False)

class CustomManager(models.Manager):
    def publish(self, instance: "MyModel"):
        instance.is_draft = False
        instance.save()

# 显式创建合并类
class CombinedManager(CustomManager):
    def get_queryset(self):
        return CustomQuerySet(self.model, using=self._db)
    
    # 将QuerySet的方法绑定到Manager
    live = CustomQuerySet.live

class MyModel(models.Model):
    objects: CombinedManager = CombinedManager()

    is_draft = models.BooleanField(blank=True, default=True)

优点是类型检查完全准确，不需要额外的类型提示；缺点是如果QuerySet有多个方法，需要手动逐个绑定。

方案三：使用类型强制转换（Python 3.10+） #

利用Python 3.10引入的交集类型&，通过typing.cast告诉类型检查器objects同时具备CustomManager和CustomQuerySet的方法：

from typing import cast
from django.db import models

class CustomQuerySet(models.QuerySet):
    def live(self):
        return self.filter(is_draft=False)

class CustomManager(models.Manager):
    def publish(self, instance: "MyModel"):
        instance.is_draft = False
        instance.save()

class MyModel(models.Model):
    objects = cast(CustomManager & CustomQuerySet, CustomManager().from_queryset(CustomQuerySet)())

    is_draft = models.BooleanField(blank=True, default=True)

这种方式最简洁，但依赖Python版本，且属于"告诉类型检查器忽略实际类型"的做法，适合快速解决问题的场景。

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