Django：字段参数与Meta内部类verbose_name的区别及展示场景

示例模型代码 #

class Product(models.Model):
    name = models.CharField(verbose_name="Product Name", max_length=255)

    class Meta:
        verbose_name = "Product Name"

字段声明中的verbose_name #

这个参数是单个字段的人类可读名称，主要在和字段交互的场景中显示：

• Django Admin后台：
  • 新增/编辑模型实例时，作为对应字段的标签文字展示
  • 模型列表页中，若该字段被设置为列表展示项，会作为表头文字显示
• 表单渲染（含Admin自动生成表单、自定义ModelForm）：
  • 作为表单字段的<label>标签文本，替代默认的字段名（比如默认会显示"Name"，这里会显示"Product Name"）
• 字段验证错误提示：当该字段未通过校验时，错误信息里会引用这个名称（例如"Product Name不能为空"）
• 其他基于模型字段生成UI的场景（如第三方表单工具、数据导出表头）

Meta类中的verbose_name #

这个参数是整个模型的单数人类可读名称，主要在和模型整体相关的场景中显示：

• Django Admin后台：
  • 左侧导航栏里该模型的单入口名称
  • 新增/编辑页面的标题（例如"Add Product Name"）
  • 模型列表页的页面标题（例如"Select Product Name to change"）
  • 面包屑导航中的单数模型名称
• 后台操作提示：批量删除、修改等动作完成后，成功提示里会使用这个名称（例如"Successfully deleted 1 Product Name"）
• Django通用视图：比如DetailView、ListView的页面标题或默认提示文本中，会引用该名称
• 模型相关的工具场景：比如Django REST Framework自动生成的API文档中，作为模型的单数标识名称

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