Django表单self.fields类型问题：无cast的queryset赋值最佳实践

问题场景 #

我编写了如下Django表单代码：

class MerchantBrandsForm(forms.Form):
    brands = forms.ModelChoiceField(required=True, queryset=None)

    def __init__(self, merchant: Merchant, *args: Any, **kwargs: Any):
        super().__init__(*args, **kwargs)
        self.fields['brands'].queryset = merchant.brands.all()

注：原代码__init__方法的参数写法存在语法错误，已修正为正确的参数顺序。

使用mypy进行类型检查时，出现报错“"Field" has no attribute "queryset"”，原因是self.fields的类型被推断为Dict[str, Field]，而基类Field并没有queryset属性。不想使用cast强制转换类型或忽略检查，需要更简洁的正确写法。

解决方案 #

直接通过类实例的字段属性self.brands赋值，而非通过self.fields字典访问。因为类中已明确定义brands是ModelChoiceField类型，mypy可以正确识别它的属性：

from django import forms
from typing import Any
from yourapp.models import Merchant

class MerchantBrandsForm(forms.Form):
    brands = forms.ModelChoiceField(required=True, queryset=None)

    def __init__(self, merchant: Merchant, *args: Any, **kwargs: Any):
        super().__init__(*args, **kwargs)
        self.brands.queryset = merchant.brands.all()

原理说明 #

• Django会将表单类中直接定义的字段实例自动添加到self.fields字典，但mypy无法精准推断字典中每个值的具体子类类型。
• 直接访问self.brands时，mypy能直接获取类定义时标注的ModelChoiceField类型，自然可识别queryset属性，无需额外类型转换。

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