Django 模型（Model）定义完全指南

一句话定位：在 Django 中，一个 Python 类 = 一张数据库表，一个类属性 = 一个表字段。我们之前简单了解了 一下Python的orm，今天再来详细看看。

一、模型类骨架

from django.db import models

class BookInfo(models.Model):
    # 系统会自动添加 id = models.AutoField(primary_key=True)
    name        = models.CharField(max_length=20, unique=True)
    pub_date    = models.DateField(null=True, blank=True)
    read_count  = models.IntegerField(default=0)
    comment_cnt = models.IntegerField(default=0)
    is_deleted  = models.BooleanField(default=False)

    class Meta:
        db_table = 'tb_book'      # 真实表名
        verbose_name = '书籍'     # admin 后台显示名

这是Python中一个类的定义，下面我会详细解释一下

系统自动添加id主键

二、字段三要素

常用字段类型对照表

三、常用字段选项

四、Meta 内部类

Meta 内部类写在模型类里面，用来告诉 Django：“这个表在数据库里到底叫什么名字、在后台怎么显示、默认按什么排序……”等等与字段无关的“元信息”。

class BookInfo(models.Model):
    ...
    class Meta:
        db_table = 'tb_book'           # 真实表名
        verbose_name = '书籍'
        verbose_name_plural = verbose_name

• 不写 db_table 时，默认表名：app名_类名 全小写，如 book_bookinfo。

• verbose_name 只影响后台显示，不影响数据库。

也就是说 模型字段管“列长什么样”，Meta 管“表长什么样”。

五、完整迁移流程

1. 建库（仅一次）

CREATE DATABASE book_db CHARACTER SET utf8mb4;

2. 注册 app

INSTALLED_APPS = [
  'book.apps.BookConfig',  # 推荐写法
]

3. 生成 & 执行迁移

python manage.py makemigrations
python manage.py migrate

4. 验证

python manage.py shell
>>> from book.models import BookInfo
>>> BookInfo.objects.create(name='西游记', read_count=10086)

六、常见坑速查