Django表单未显示全部字段问题排查求助

问题背景 #

已定义Model并编写ModelForm，但将表单引入HTML模板后仅显示部分字段，相关代码如下：

models.py #

class Post(models.Model):
    full_name = models.CharField(max_length=60, verbose_name='Full name'),
    name_scheme = models.CharField(max_length=40, verbose_name='Name of scheme')
    job = models.CharField(max_length=100, verbose_name='Job'),
    email = models.EmailField(verbose_name='Email'),
    domain_name = models.CharField(max_length=100, verbose_name='Domain'),
    phone_number = PhoneNumberField,
    company_name = models.CharField(max_length=30, verbose_name='Company name'),
    text = models.TextField(max_length=255, verbose_name='Text'),
    age = models.IntegerField(validators=[MinValueValidator(18), MaxValueValidator(65)])
    address = models.CharField(max_length=255, verbose_name='Address'),
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.full_name

forms.py #

class AddSchemeForm(forms.ModelForm):
    class Meta:
        model = Post
        fields = '__all__'

views.py #

def add_scheme(request):
    if request.method == 'POST':
        form = AddSchemeForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()
            return redirect('home')
    else:
        form = AddSchemeForm()
        return render(request, 'add_scheme.html', {'form': form})

模板（add_scheme.html） #

<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    <div>
      {{ form.full_name.label_tag }}
      {{ form.full_name }}
    </div>
    <div>
      {{ form.name_scheme.label_tag }}
      {{ form.name_scheme }}
    </div>
    <div>
      {{ form.job.label_tag }}
      {{ form.job }}
    </div>
</form>

核心原因与解决方法 #

1. Model字段定义语法错误（导致表单无法识别部分字段） #

• 问题点：多个字段末尾多了逗号（比如full_name = models.CharField(...),），这会让字段变成元组而非Model字段实例；phone_number = PhoneNumberField,未加括号实例化，同样无法被识别为有效字段。
• 解决方法：
  • 去掉所有字段末尾多余的逗号；
  • 把phone_number = PhoneNumberField,改为phone_number = PhoneNumberField(verbose_name='Phone number')（可根据需求补充其他参数）。
    修正后的关键字段示例：

  full_name = models.CharField(max_length=60, verbose_name='Full name')
  job = models.CharField(max_length=100, verbose_name='Job')
  phone_number = PhoneNumberField(verbose_name='Phone number')
  

2. 模板仅渲染了部分字段 #

• 问题点：当前模板只手动渲染了full_name、name_scheme、job三个字段，其他字段即使表单已生成，也不会自动显示。
• 解决方法：
  • 若要快速显示所有字段，可替换手动渲染代码为{{ form.as_p }}（或form.as_table/form.as_ul，对应不同布局）；
  • 若需自定义布局，补充其他字段的渲染代码，比如：

    <div>
      {{ form.email.label_tag }}
      {{ form.email }}
    </div>
    <div>
      {{ form.phone_number.label_tag }}
      {{ form.phone_number }}
    </div>
    <!-- 其他字段按相同格式补充 -->
    

3. 额外检查点 #

• created_at字段设置了auto_now_add=True，ModelForm会自动将其设为隐藏字段，不会在表单中显示（属于正常逻辑）；
• 运行python manage.py makemigrations和python manage.py migrate，确保Model的修改同步到数据库。

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