1. 基本概念与需求场景
1.1. 单选按钮在 Django 表单中的作用
在 Django 表单中，单选按钮通常通过 ChoiceField 与 RadioSelect 小部件实现。回显是指在编辑表单时，原有的选项能自动被选中，提升用户体验。
对于复杂场景，初始数据、数据绑定和实例绑定三者的区分决定了回显是否正确。
1.2. 回显的常见问题点
如果未对表单进行正确绑定，已经保存的选项不会被回显，导致用户看到空白的单选按钮。
此外，重复提交时也需要确保表单数据的校验和回显一致，避免因状态未同步而产生错误。
2. 正确实现回显的核心原则
2.1. 选择字段与小部件的搭配
通过 forms.ChoiceField 与 widget=RadioSelect 的组合，可以让单选按钮在模板中按值回显。
在 Django 的渲染阶段，表单字段的当前值会自动映射到相应的 input[type=radio] 的 checked 属性，完成回显效果。
2.2. 绑定现有数据的正确姿势
当编辑模型实例时，应使用 instance 参数将对象数据绑定到 ModelForm，以实现回显。
若使用 Form 而非 ModelForm，也应通过 initial 参数设置默认选项，以确保初始回显正确。
3. 实战教程：创建一个编辑界面的单选回显
3.1. 场景描述与字段设计
场景：一个任务模型需要设定状态，选项包含 待处理、进行中、已完成，需要在编辑时回显当前状态。
字段设计方面，CharField + choices 可以与 RadioSelect 小部件配合实现，确保用户在查看和修改时能直观看到当前选项。
3.2. 示例代码：模型、表单、视图、模板
下面给出一个完整的最小示例，帮助你在实际项目中快速落地。核心点在于使用 ModelForm 的实例绑定来实现回显。
# models.py
from django.db import modelsclass Task(models.Model):STATUS_CHOICES = [('P', '待处理'),('I', '进行中'),('C', '已完成'),]title = models.CharField(max_length=100)status = models.CharField(max_length=1, choices=STATUS_CHOICES, default='P')
# forms.py
from django import forms
from .models import Taskclass TaskForm(forms.ModelForm):class Meta:model = Taskfields = ['title', 'status']
# views.py
from django.shortcuts import render, get_object_or_404, redirect
from .models import Task
from .forms import TaskFormdef edit_task(request, pk):task = get_object_or_404(Task, pk=pk)if request.method == 'POST':form = TaskForm(request.POST, instance=task)if form.is_valid():form.save()return redirect('task_detail', pk=pk)else:form = TaskForm(instance=task)return render(request, 'tasks/edit_task.html', {'form': form})
4. 模板渲染与前端细节
4.1. 确保已选中的实现要点
模板层通过 Django 的自动渲染将 RadioSelect 变成一组 input，并且当前项自动带有 checked 属性，完成回显。
如果需要自定义布局，可以用 for 循环遍历为你手动渲染每一个选项，并确保 checked 状态来自于表单字段当前的值。
4.2. 模板示例：自定义渲染单选项
下面的模板示例展示了如何手动渲染单选按钮，并保持回显逻辑的稳定性，尤其是在自定义表单布局时。
{% for value, label in form.status.field.choices %}
{% endfor %}5. 常见问题与调试方法
5.1. 数据绑定 vs initial 的区别
在 ModelForm 场景中，使用 instance 进行绑定能确保现有数据的回显；initial 主要用于初始值，在未绑定实例时生效。
调试时，检查 form.is_bound、form.errors、以及模板中字段渲染的输出，是排查回显问题的第一步。
