Django Model 字段参数完整参考文档

name = models.CharField(
    max_length=100,           # 必需：最大字符长度
    **通用参数
)

slug = models.SlugField(
    max_length=50,            # 必需：最大长度
    allow_unicode=False,      # 是否允许 Unicode 字符
    **通用参数
)

description = models.TextField(
    blank=True,               # 允许为空
    default='',               # 默认空字符串
    **通用参数
)

email = models.EmailField(
    max_length=254,           # 默认最大长度 254
    **通用参数
)

website = models.URLField(
    max_length=200,           # 默认最大长度 200
    **通用参数
)

count = models.IntegerField(
    default=0,                # 默认值
    **通用参数
)

rating = models.FloatField(
    default=0.0,
    **通用参数
)

price = models.DecimalField(
    max_digits=10,            # 必需：总位数（包括小数位）
    decimal_places=2,         # 必需：小数位数
    **通用参数
)

is_active = models.BooleanField(
    default=True,             # 默认值
    null=True,                # 允许 NULL（三态布尔）
    **通用参数
)

created_at = models.DateTimeField(
    auto_now=False,           # 每次保存自动更新为当前时间
    auto_now_add=False,       # 创建时自动设置为当前时间
    **通用参数
)

document = models.FileField(
    upload_to='documents/%Y/%m/',  # 必需：上传路径
    storage=None,                    # 自定义存储后端
    max_length=100,                  # 文件路径最大长度
    **通用参数
)

avatar = models.ImageField(
    upload_to='avatars/',      # 必需：上传路径（继承自 FileField）
    height_field=None,          # 自动填充高度的字段名
    width_field=None,           # 自动填充宽度的字段名
    max_length=100,             # 文件路径最大长度
    **通用参数
)

author = models.ForeignKey(
    to=Author,                # 必需：关联的模型类
    on_delete=models.CASCADE, # 必需：删除关联对象时的行为
    related_name='books',      # 反向查询名称
    related_query_name='book', # 反向查询过滤名称
    limit_choices_to=None,     # 限制可选对象的条件
    parent_link=False,         # 是否作为继承链接
    to_field=None,             # 关联到目标模型的哪个字段
    db_constraint=True,        # 是否创建数据库外键约束
    swappable=True,            # 是否允许模型交换（用于可交换模型）
    **通用参数
)

tags = models.ManyToManyField(
    to=Tag,                   # 必需：关联的模型类
    related_name='articles',    # 反向查询名称
    related_query_name='article', # 反向查询过滤名称
    limit_choices_to=None,     # 限制可选对象的条件
    symmetrical=True,          # 自关联时是否对称
    through='ArticleTag',      # 自定义中间模型
    through_fields=None,       # 指定中间模型字段
    db_table=None,             # 自定义中间表名
    swappable=True,            # 是否允许模型交换
    **通用参数
)

profile = models.OneToOneField(
    to=Profile,               # 必需：关联的模型类
    on_delete=models.CASCADE, # 必需：删除行为
    related_name='user',      # 反向查询名称
    related_query_name='user', # 反向查询过滤名称
    limit_choices_to=None,     # 限制可选对象
    parent_link=False,         # 是否作为继承链接
    to_field=None,             # 关联到目标模型的哪个字段
    db_constraint=True,        # 是否创建数据库外键约束
    swappable=True,            # 是否允许模型交换
    **通用参数
)

data = models.JSONField(
    encoder=None,             # 自定义 JSON 编码器
    decoder=None,             # 自定义 JSON 解码器
    **通用参数
)

id = models.AutoField(
    primary_key=True,         # 通常自动设置
    **通用参数
)

from django.db import models
from django.core.validators import MinValueValidator

class Product(models.Model):
    # CharField 示例
    name = models.CharField(
        '产品名称',
        max_length=200,
        db_index=True,
        unique=True,
        help_text='请输入产品名称',
        error_messages={
            'unique': '该产品名称已存在',
            'blank': '名称不能为空'
        }
    )
    
    # SlugField 示例
    slug = models.SlugField(
        'URL标识',
        max_length=200,
        unique=True,
        allow_unicode=True
    )
    
    # TextField 示例
    description = models.TextField(
        '产品描述',
        blank=True,
        default=''
    )
    
    # DecimalField 示例
    price = models.DecimalField(
        '价格',
        max_digits=10,
        decimal_places=2,
        default=0.00,
        validators=[MinValueValidator(0)]
    )
    
    # 正整数字段示例
    stock = models.PositiveIntegerField(
        '库存',
        default=0,
        db_index=True
    )
    
    # BooleanField 示例
    is_available = models.BooleanField(
        '是否上架',
        default=True,
        editable=True
    )
    
    # 日期时间字段示例
    created_at = models.DateTimeField(
        '创建时间',
        auto_now_add=True,
        db_index=True
    )
    
    updated_at = models.DateTimeField(
        '更新时间',
        auto_now=True
    )
    
    # ImageField 示例
    image = models.ImageField(
        '产品图片',
        upload_to='products/%Y/%m/',
        blank=True,
        null=True,
        height_field='image_height',
        width_field='image_width'
    )
    
    image_height = models.PositiveIntegerField(null=True, blank=True)
    image_width = models.PositiveIntegerField(null=True, blank=True)
    
    # ForeignKey 示例
    category = models.ForeignKey(
        'Category',
        on_delete=models.SET_NULL,
        null=True,
        related_name='products',
        related_query_name='product',
        limit_choices_to={'is_active': True},
        verbose_name='分类'
    )
    
    # ManyToManyField 示例
    tags = models.ManyToManyField(
        'Tag',
        blank=True,
        related_name='products',
        through='ProductTag',
        db_table='product_tags_relation'
    )
    
    # OneToOneField 示例
    supplier = models.OneToOneField(
        'Supplier',
        on_delete=models.CASCADE,
        null=True,
        blank=True,
        related_name='exclusive_product'
    )
    
    # JSONField 示例
    metadata = models.JSONField(
        '元数据',
        default=dict,
        blank=True
    )
    
    class Meta:
        db_table = 'products'
        ordering = ['-created_at']
        verbose_name = '产品'
        verbose_name_plural = '产品管理'
        unique_together = [['name', 'category']]
        index_together = [['category', 'is_available']]
    
    def __str__(self):
        return self.name