Django ORM模型中字段常用的参数总结：-CSDN博客

本文链接：https://blog.csdn.net/python_136/article/details/142553719

在Django框架的ORM模型中，字段（Field）是模型（Model）定义的核心部分，用于描述数据库表中的列。每个字段都可以接受一系列参数来定制其行为和属性。以下是一些Django ORM模型中字段常用的参数总结：

通用参数

verbose_name
- 为字段设置一个人类可读的名称，这个名称在Django admin后台或表单的字段标签中显示。
help_text
- 为字段提供额外的帮助文本，这些文本在Django admin后台或表单字段旁边显示，以指导用户如何填写。
null
- 如果设置为True，Django将允许该字段存储NULL值。默认为False。
- 注意：对于字符串和文本类型，blank=True可能更常用，因为它允许空字符串而不是NULL。
blank
- 如果设置为True，则在表单验证时允许该字段为空。默认为False。
- 这与数据库级别的NULL不同，它仅影响表单验证。
choices
- 一个可迭代对象（如列表或元组），用于给字段提供选项。
- 通常是一个包含二元组的列表，每个二元组表示一个选项（例如，[('male', 'Male'), ('female', 'Female')]）。
- 在Django admin后台或表单中，这将显示为下拉选择框。
db_column
- 字段在数据库中的列名。
- 如果不指定，Django将使用字段的名称作为数据库中的列名。
db_index
- 如果设置为True，Django将为该字段创建数据库索引。
- 这有助于加快基于该字段的查询速度。
default
- 字段的默认值。
- 可以是一个值或一个可调用的对象（如函数或lambda表达式）。
- 注意：对于可调用对象，Django将在每次创建新对象时调用它来获取默认值。
editable
- 如果设置为False，该字段将不会在Django admin后台中显示，并且也不会包含在默认的ModelForm中。
- 这通常用于那些你不希望用户直接编辑的字段，如创建时间戳或自动计算的字段。
primary_key
- 如果设置为True，则该字段将成为模型的主键。
- 在大多数情况下，你会使用AutoField作为主键，并让它自动设置此参数。
- 但你也可以自定义主键字段，比如使用UUIDField。
unique
- 如果设置为True，则该字段的值在表中必须是唯一的。
- 这有助于确保数据的唯一性，如用户名或电子邮件地址。
unique_for_date、unique_for_month、unique_for_year
- 这些参数与DateField和DateTimeField一起使用，以确保字段值在指定的时间单位内是唯一的。
- 例如，unique_for_year=True将确保每年该字段的值都是唯一的。

特殊字段参数

某些字段类型还具有特定于它们的参数。例如：

ForeignKey、OneToOneField 和 ManyToManyField 关系字段：
- on_delete：定义当关联的对象被删除时，应该如何处理当前字段。例如，models.CASCADE表示级联删除，models.SET_NULL表示将字段设置为NULL（前提是null=True）。
- related_name：为反向关系提供一个名称，以便从关联的对象访问当前对象。
ImageField 和 FileField 文件字段：
- upload_to：定义文件上传后应该保存到的目录。它可以是一个字符串或一个可调用的对象（如函数）。

这些参数为Django ORM中的字段提供了极大的灵活性和定制能力，允许你根据应用需求来精确地定义数据模型。

在Django框架的ORM模型中，除了之前提到的常用参数外，确实还存在一些其他参数，这些参数根据字段类型的不同而有所差异。以下是一些额外的常用参数：

通用额外参数

max_length（对于CharField等字符串类型字段）：
- 指定字符串的最大长度。这是CharField必需的参数，因为它底层使用varchar类型来存储数据。
decimal_places 和 max_digits（对于DecimalField）：
- decimal_places：指定小数点后的数字位数。
- max_digits：指定数字的最大总位数（包括小数点前的位数和小数点后的位数）。

时间字段额外参数

对于DateTimeField、DateField和TimeField等时间字段，除了之前提到的auto_now和auto_now_add参数外，还有一些其他的参数，但这两个参数是这些时间字段特有的：

auto_now：每次保存对象时，自动设置为当前时间。这通常用于表示对象的最后修改时间。
auto_now_add：在对象首次创建时自动设置为当前时间。这通常用于表示对象的创建时间。

关系字段额外参数

对于ForeignKey、OneToOneField和ManyToManyField等关系字段，除了on_delete和related_name外，还有一些其他参数，但on_delete和related_name是这些关系字段最常用的：

to_field（ForeignKey和OneToOneField）：指定关联对象的哪个字段作为外键。默认情况下，Django使用关联对象的主键。
related_query_name（ForeignKey、OneToOneField和ManyToManyField）：为反向查询设置连接前缀，用于替换表名。这在执行复杂的查询时非常有用。

其他特定字段参数

binary（BinaryField）：虽然BinaryField没有特定的额外参数（除了通用参数外），但它允许你存储二进制数据。
upload_to（FileField和ImageField）：指定文件上传后应该保存到的目录。这是一个非常重要的参数，因为它决定了文件在服务器上的存储位置。

总结

Django ORM模型中的字段参数非常灵活，可以根据你的需求进行定制。上述参数只是一部分常用的参数，Django还提供了更多的参数来满足不同的应用场景。建议查阅Django的官方文档以获取最全面和最新的信息。官方文档是获取Django相关知识的最权威来源，它提供了详细的参数说明、示例代码以及最佳实践。