Django 表单未渲染输入字段，通常是因为视图未将表单实例作为上下文传入模板；即使表单类定义正确，若 render() 调用时遗漏 {"form": form}，模板中 {{ form.email }} 等变量将为空。
django 表单字段不显示？检查视图中是否正确传递了表单实例
在 Django 中，表单字段（如 {{ form.email }} 或 {{ form.as_p }}）只有在模板接收到已实例化的表单对象（即 form = SignupForm() 或 form = SignupForm(request.POST)）并作为上下文传入时，才能正确渲染 HTML 输入控件。你提供的代码中，表单类 SignupForm 定义规范，模板语法也基本正确，但问题根源在于：视图函数中 render() 的调用逻辑存在隐性缺陷。
首先，关键错误并非“没写 context”，而是——POST 分支中表单验证失败时，未返回包含表单的响应。当前代码如下：
if request.method == "POST":
form = SignupForm(request.POST)
if form.is_valid(): # ✅ 验证通过 → 返回成功响应
# ... 处理注册逻辑
return Response({'account': account}, template_name="index.html")
# ❌ 验证失败时：无任何 return，流程继续执行下方 render()
else:
form = SignupForm()
return render(request, "signup.html", {"form": form}) # ← 此处 form 可能是未绑定的空表单（POST 失败时）
这意味着：当用户提交数据但表单验证失败（例如邮箱格式错误、必填项为空），form.is_valid() 返回 False，代码跳过 if 块，直接执行末尾的 render() —— 但此时 form 变量在 POST 分支中已被重新赋值为带数据的表单（含错误信息），而该 form 实例确实被传入了模板。因此，“没传 context”这一说法并不准确；真正的问题是：开发者误以为 POST 失败时表单未传入，实则传入了，但模板未正确使用它展示错误和原始输入值。
✅ 正确做法是：确保所有分支（包括验证失败路径）都显式返回渲染响应，并始终传入当前 form 实例。修正后的视图如下：
@api_view(('GET', 'POST',))
@renderer_classes((TemplateHTMLRenderer, JSONRenderer))
def signup(request):
if request.method == "POST":
form = SignupForm(request.POST) # 绑定用户提交的数据
if form.is_valid():
# 注意：字段名需与表单定义一致（firstname → firstname，非 firstName）
account = accountService.signup(
form.cleaned_data['email'],
form.cleaned_data['password'],
form.cleaned_data['firstname'],
form.cleaned_data['lastname'],
form.cleaned_data['isOwner']
)
if account:
return Response({'account': account}, template_name="index.html")
# ✅ 验证失败时，仍使用带错误信息的 form 渲染页面
# （这样 {{ form.email }} 会显示原输入值 + 错误提示）
else:
form = SignupForm() # GET 请求：空表单
return render(request, "signup.html", {"form": form}) # ✅ 所有路径统一返回
⚠️ 同时注意以下关键细节：
字段名一致性：表单中定义的是 firstname 和 lastname（小驼峰），但你在 request.POST["firstName"] 中用了 firstName（大驼峰），这会导致 KeyError 或取值为空。务必使用 form.cleaned_data（推荐）或严格匹配字段名：request.POST.get("firstname")。
-
模板中应优先使用 {{ form.email }} 而非手动拼接标签：你模板中混合了 {{ form.as_p }} 和手动 {{ form.email.label_tag }} {{ form.email }}，易导致重复渲染或样式错乱。建议统一方式，例如：
启用 Django 表单错误渲染：确保 settings.py 中 DEBUG = True，并在模板中加入 {{ form.email.errors }} 或 {{ form.non_field_errors }}，以便直观看到验证失败原因。
总结：表单不显示的根本原因，往往不是“没传 context”，而是验证失败路径未被妥善处理，导致开发者误判表单状态。始终保证 form 实例在 render() 前已正确定义，并利用 form.cleaned_data 安全取值，即可稳定渲染字段与错误信息。
