Django 表单未渲染？正确使用 Form 字段与 Widget 是关键

django 表单未显示，通常是因为误将 widget（如 `forms.textarea`）直接当作字段类型使用；正确做法是用 `forms.charfield` 等字段类，并通过 `widget` 参数指定渲染方式。

在 Django 中，表单字段（Field）和表单控件（Widget）职责分明：Field 负责数据验证与逻辑处理，Widget 负责 HTML 渲染。你当前的 forms.py 代码中：

class BulkModulImport(forms.Form):
    text = forms.Textarea(attrs={'class': 'form-control', 'rows': '4'})  # ❌ 错误：Textarea 是 Widget，不是 Field

这行代码实际将 forms.Textarea（一个 Widget 类）赋值给了字段名 text，而 Django 表单系统无法识别它为合法字段，因此 {{ form2 }} 渲染时被静默忽略——导致页面只显示硬编码 HTML，表单区域为空。

✅ 正确写法是：使用 forms.CharField（或其他合适字段类型），并通过 widget 参数传入 Textarea 实例：

# forms.py
from django import forms

class BulkModulImport(forms.Form):
    text = forms.CharField(
        widget=forms.Textarea(attrs={
            'class': 'form-control',
            'rows': 4,
            'placeholder': '每行输入一个模块名称，例如：Mathematik I'
        })
    )

这样，Django 才能正确实例化字段、执行验证（如非空检查）、并在模板中通过 {{ form2.text }} 或 {{ form2 }} 自动渲染为 标签。

⚠️ 同时注意 views.py 中的两个关键问题需一并修正：

1. 变量名不一致：视图中创建的是 form = BulkModulImport(...)，但传递给模板的是 {'form2': form2} —— 而 form2 在 POST 分支中未定义，仅在 else 分支中存在。这会导致 POST 请求时 form2 未定义，引发 NameError。应统一使用 form 变量，并确保所有分支都返回 form：

# views.py（修正后）
def bulk_modul_import(request):
    if request.method == "POST":
        form = BulkModulImport(request.POST)
        if form.is_valid():
            # 处理逻辑（注意：cleaned_data['text'] 是字符串，非对象）
            def remove_dots_and_numbers(text):
                lines = text.split('\n')
                for line in lines:
                    cleaned_line = re.sub(r'\s*\d*$', '', line.replace(' .', ''))
                    if "Module der Lehreinheit" not in cleaned_line and cleaned_line.strip():
                        Modul.objects.create(
                            title=cleaned_line.strip(),
                            proposer=request.user,
                            dozent=None,
                            created_date=timezone.now(),
                            description=""
                        )
            remove_dots_and_numbers(form.cleaned_data['text'])

            messages.success(request, 'Du hast erfolgreich einen Bulk-Import der Module durchgeführt!')
            return HttpResponseRedirect(reverse('modul_list'))
    else:
        form = BulkModulImport()  # ✅ 统一变量名

    return render(request, 'score/bulk_import.html', {'form2': form})  # ✅ 所有路径均返回 form

2. 安全与健壮性建议：
   • 使用 Modul.objects.create(...) 替代 .save() 链式调用，更清晰；
   • 对 cleaned_line.strip() 做空值检查，避免保存空白模块；
   • 可为 text 字段添加 required=True（默认即为 True）或自定义 error_messages 提升用户体验。

总结：Django 表单渲染失败，90% 源于字段定义错误——牢记 “Field 定义逻辑，Widget 控制外观”。始终用 forms.XXXField(widget=...) 的结构，而非 forms.XXXWidget 直接赋值。