如何修改Django Crispy Form中所有<div>行的css_class

使用Django Crispy Forms渲染ModelForm时整体运行正常，但无法批量修改表单行的CSS类。当前每个表单行的HTML输出为：

<div id="div_id_voornaam" class="form-group row"> </div>

期望修改为：

<div id="div_id_voornaam" class="row mb-3"> </div>

现有表单初始化代码：

def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    self.helper = FormHelper()
    self.helper.form_class = 'form-horizontal'
    self.helper.label_class = 'col-lg-2'
    self.helper.field_class = 'col-lg-8'

模板代码：

<div class="card-body">
    <form method="post">
        {% load crispy_forms_tags %}

        {% csrf_token %}
        {% crispy form %}

        <button type="submit" value="Submit" class="btn btn-primary">Submit</button>
    </form>
</div>

方法1：自定义表单行模板（推荐） #

通过覆盖Crispy Forms的模板，批量修改所有表单行的渲染逻辑，无需逐个字段调整：

1. 在项目templates目录下创建crispy_forms/bootstrap4（根据你实际使用的Bootstrap版本调整路径）文件夹；
2. 复制Crispy Forms源码中的field.html模板到该文件夹；
3. 修改模板中的容器类定义：
   找到原代码：

   <div id="div_id_{{ field.name }}" class="form-group row{% if form_show_errors and field.errors %} has-danger{% endif %}{% if field.css_classes %} {{ field.css_classes }}{% endif %}">
   

   修改为：

   <div id="div_id_{{ field.name }}" class="row mb-3{% if form_show_errors and field.errors %} has-danger{% endif %}{% if field.css_classes %} {{ field.css_classes }}{% endif %}">
   

   保存后，所有Crispy渲染的表单行都会自动应用新类。

方法2：通过FormHelper批量更新字段布局 #

如果不想修改模板，可在表单初始化时遍历所有字段，批量设置wrapper类：

def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    self.helper = FormHelper()
    self.helper.form_class = 'form-horizontal'
    self.helper.label_class = 'col-lg-2'
    self.helper.field_class = 'col-lg-8'
    
    # 批量修改所有字段的外层容器类
    for field_name in self.fields:
        self.fields[field_name].wrapper_class = 'row mb-3'

若上述方法不生效，可结合Layout对象实现：

from crispy_forms.layout import Layout, Field

def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    self.helper = FormHelper()
    self.helper.form_class = 'form-horizontal'
    self.helper.label_class = 'col-lg-2'
    self.helper.field_class = 'col-lg-8'
    
    # 构建自定义布局批量设置字段wrapper类
    layout_fields = [Field(field_name, wrapper_class='row mb-3') for field_name in self.fields]
    self.helper.layout = Layout(*layout_fields)

方法3：CSS覆盖（临时快速方案） #

若无需修改HTML结构，仅需调整样式，可通过CSS覆盖原类：

.form-group.row {
    margin-bottom: 1rem !important;
    /* 移除form-group的默认样式，按需添加 */
    border: none;
    padding: 0;
}

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