为何给Django表单Widget批量添加字段会触发KeyError？

你遇到的KeyError是因为self.fields是字典结构，无法直接用元组作为键来批量访问字段。直接给每个字段单独写一行确实冗余，完全可以用更简洁的批量方式实现，符合DRY原则。

错误原因 #

self.fields['category_name','sub_category',...]这种写法是错误的——字典的键只能是单个值，你传入的元组会被当作一个整体键去查找，而表单字段里根本不存在这个键，所以抛出KeyError。

解决方案 #

1. 循环指定字段列表

如果只想给特定字段添加Bootstrap类，定义字段列表后循环处理：

class CategoryForm(ModelForm):
    class Meta:
        model = Category
        fields = '__all__'
        labels = {
            "sub_category":"Sub category (if any):"
        }

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        target_fields = ['category_name', 'sub_category', 'category_info', 'category_video']
        for field_name in target_fields:
            self.fields[field_name].widget.attrs.update({'class': 'form-control'})

2. 给所有字段批量添加类

如果表单里的所有字段都需要加form-control类，直接遍历self.fields.values()即可：

class CategoryForm(ModelForm):
    class Meta:
        model = Category
        fields = '__all__'
        labels = {
            "sub_category":"Sub category (if any):"
        }

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        for field in self.fields.values():
            field.widget.attrs.update({'class': 'form-control'})

3. 封装基类实现全局复用（最优DRY方案）

如果多个表单都需要加Bootstrap类，最好封装一个基类，其他表单直接继承：

from django import forms

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

# 你的CategoryForm继承基类即可
class CategoryForm(BootstrapModelForm):
    class Meta:
        model = Category
        fields = '__all__'
        labels = {
            "sub_category":"Sub category (if any):"
        }

如果需要给不同表单指定不同字段，可以给基类加个配置属性：

class BootstrapModelForm(forms.ModelForm):
    # 可配置需要添加类的字段，默认所有字段
    bootstrap_fields = '__all__'

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        target_fields = self.bootstrap_fields
        if target_fields == '__all__':
            target_fields = self.fields.keys()
        for field_name in target_fields:
            self.fields[field_name].widget.attrs.update({'class': 'form-control'})

# 使用时指定字段
class CategoryForm(BootstrapModelForm):
    bootstrap_fields = ['category_name', 'sub_category', 'category_info', 'category_video']
    class Meta:
        model = Category
        fields = '__all__'
        labels = {
            "sub_category":"Sub category (if any):"
        }

内容的提问来源于stack exchange，提问作者Thomas Doll-Datema