如何一次性为Django Forms的所有字段添加CSS类？

下面是几种通用的实现方式，可避免重复代码：

1. 自定义基础表单类（推荐，灵活通用） #

创建一个基础表单类，在其__init__方法中统一遍历所有字段添加属性，后续所有模型表单都继承这个基础类即可：

from django import forms

class BaseStyledForm(forms.ModelForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 为所有字段的widget添加统一类名
        for field in self.fields.values():
            field.widget.attrs.update({'class': 'form-control-sm'})

# 示例：你的模型表单继承基础类
class UserProfileForm(BaseStyledForm):
    class Meta:
        model = UserProfile
        fields = ['username', 'email', 'bio']

这种方式不仅能统一添加类名，还能根据字段类型做差异化处理（比如给复选框加不同的类），是Django社区常用的最佳实践，并非"权宜之计"。

2. 使用formfield_callback内置回调 #

利用Django表单的formfield_callback属性，自定义模型字段转表单字段的逻辑，批量注入属性：

from django import forms

def add_widget_class(model_field, **kwargs):
    # 先调用默认的字段转换逻辑
    form_field = forms.ModelForm.formfield_callback(model_field, **kwargs)
    # 添加统一类名
    form_field.widget.attrs.update({'class': 'form-control-sm'})
    return form_field

class UserProfileForm(forms.ModelForm):
    # 指定自定义的回调函数
    formfield_callback = add_widget_class

    class Meta:
        model = UserProfile
        fields = '__all__'

这是Django内置的扩展点，完全符合"通用内置实现"的需求，适合不需要额外差异化处理的场景。

3. 自定义Widget子类（针对特定控件类型） #

如果只需要给某一类控件添加类名，可以自定义Widget子类，然后在表单的Meta中批量指定：

from django import forms

class BootstrapTextInput(forms.TextInput):
    def __init__(self, attrs=None):
        # 默认添加类名，支持传入额外属性覆盖
        default_attrs = {'class': 'form-control-sm'}
        if attrs:
            default_attrs.update(attrs)
        super().__init__(default_attrs)

class UserProfileForm(forms.ModelForm):
    class Meta:
        model = UserProfile
        widgets = {
            'username': BootstrapTextInput(),
            'bio': BootstrapTextInput(),
            # 其他需要该样式的字段...
        }

这种方式适合需要精准控制特定控件的场景，但需要手动指定每个字段的Widget，不如前两种高效。

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