小王子1024

專注Django實戰案例分享

Django模型開發：模型字段、元數據與繼承全方位講解

本文將全面介紹 Django 模型的關鍵知識點，包括模型字段類型、映射、常用配置選項以及模型繼承等高級特性，幫助開發者快速掌握模型設計與使用技巧。

一、模型字段類型詳解

在 Django 開發中，模型（Model）是連接應用程序與數據庫的核心橋梁。

Django 與 MySQL 字段類型映射

Django 模型的每個字段都是特定 Field 類的實例，它決定了數據庫存儲類型和表單驗證規則。

Django 字段類型	MySQL 數據類型	說明
`CharField`	`VARCHAR`	字符串類型，需指定 max_length
`TextField`	`TEXT`	長文本類型
`IntegerField`	`INT`	整數類型
`BigIntegerField`	`BIGINT`	長整數類型
`BooleanField`	`TINYINT(1)`	布爾類型（0=False，1=True）
`DateTimeField`	`DATETIME`	日期時間類型
`SmallIntegerField`	`SMALLINT`	小整數類型

整數類型深度對比

TINYINT和SMALLINT是兩種常用的整數類型，選擇合適的類型能優化存儲效率

維度	TINYINT	SMALLINT
存儲空間	1 字節（8 位）	2 字節（16 位）
有符號范圍	-128 到 127	-32768 到 32767
無符號范圍	0 到 255	0 到 65535
適用場景	布爾值、狀態標記、年齡、枚舉值等小范圍數值	用戶積分、訂單數量等中等范圍數值
示例	年齡（0-120）、月份（1-12）、星期（1-7）	用戶積分（0-5000）、訂單數量（0-30000）

二、常用字段選項

字段選項用于配置字段的行為特性，以下是開發中最常用的選項

null 與 blank 的區別

# null影響數據庫存儲，blank影響表單驗證
field1 = models.CharField(max_length=100, null=True)  # 數據庫可存NULL
field2 = models.CharField(max_length=100, blank=True)  # 表單可提交空值
field3 = models.CharField(max_length=100, null=True, blank=True)  # 兩者皆可

null=True：允許數據庫存儲 NULL 值（默認 False）
blank=True：允許表單提交空值（默認 False）
注意：前端提交""空字符串時，若blank=False會觸發驗證錯誤

注釋與幫助文本

class Book(models.Model):
    title = models.CharField(
        max_length=100,
        help_text='Enter the book title',  # 表單幫助文本
        db_comment="圖書標題"  # 數據庫字段注釋（Django4.2+）
    )
    
    class Meta:
        db_table_comment = 'This table stores information about books.'  # 數據庫表注釋

help_text：表單幫助文本
db_comment：數據庫字段注釋

默認值設置

# 固定默認值
count = models.IntegerField(default=0)

# 可調用對象作為默認值
from datetime import date
birth_date = models.DateField(default=date.today)

default ：該字段的默認值

日期時間特殊選項

class BaseModel(models.Model):
    # 首次創建時自動設置當前時間
    created_at = models.DateTimeField(auto_now_add=True)
    # 每次save()時自動更新為當前時間
    updated_at = models.DateTimeField(auto_now=True)

注意：

auto_now在QuerySet.update()時不會自動生效，需手動更新或使用save()
auto_now_add、auto_now 和 default 選項相互排斥，這些選項的任何組合都會導致報錯

class Article(models.Model):
    def save(self, *args, **kwargs):
        if not self.pk:  # 僅在首次創建時設置
            self.created_at = timezone.now()
        self.updated_at = timezone.now()
        super().save(*args, **kwargs)

當需要復雜時間邏輯時，覆蓋模型的 save() 方法

選項列表（choices）

使用choices定義字段的可選值范圍

# 直接定義選項
class Person(models.Model):
    SHIRT_SIZES = [
        ("S", "Small"),
        ("M", "Medium"),
        ("L", "Large"),
    ]
    shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES)

# 枚舉類定義選項（推薦）
from enum import Enum
class UserTypeEnum(Enum):
    MEMBER = 1  # 會員
    ADMIN = 2   # 管理員

class User(models.Model):
    user_type = models.SmallIntegerField(
        choices=[(item.value, item.name) for item in UserTypeEnum],
        default=UserTypeEnum.MEMBER.value
    )

三、模型元數據與方法

模型 Meta 類

通過內部Meta類定義模型的元數據，即 "非字段信息"

class User(models.Model):
    username = models.CharField(max_length=50)
    email = models.EmailField()
    
    class Meta:
        db_table = "system_users"  # 數據庫表名
        db_table_comment = "用戶信息表"  # 數據庫表注釋
        ordering = ['-id']  # 默認排序
        verbose_name = "用戶"  # 單數顯示名
        verbose_name_plural = "用戶"  # 復數顯示名

managed=False適用于：

與遺留數據庫集成時
不希望 Django 自動修改表結構的場景

模型管理器（Manager）

Manager 是模型與數據庫交互的接口，默認名為objects。模型管理器只能通過模型類來訪問，一般用于“表級”操作

# 表級操作
all_users = User.objects.all()
active_users = User.objects.filter(is_active=True)
user = User.objects.get(id=1)

自定義模型方法

模型方法用于實現 "行級" 操作，可自定義業務邏輯

重寫 save() 方法：例如實現保存前后的處理
重寫 delete() 方法：例如實現軟刪除
其它自定義方法：例如編寫原生 SQL 語句

class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()
    
    def save(self, *args, **kwargs):
        # 保存前處理
        self.name = self.name.title()
        super().save(*args, **kwargs)  # 調用父類方法
        # 保存后操作
        self.clear_cache()
    
    def clear_cache(self):
        """自定義緩存清理方法"""
        cache.delete(f"blog_{self.id}")

注意：重寫的模型方法不會在批量操作（例如update()）中調用

四、模型繼承

抽象基類

將公共字段提取到抽象基類，避免代碼重復

class CommonInfo(models.Model):
    """抽象基類：包含公共字段"""
    name = models.CharField(max_length=100)
    age = models.PositiveIntegerField()
    created_at = models.DateTimeField(auto_now_add=True)
    
    class Meta:
        abstract = True  # 標記為抽象類，不生成數據表

# 繼承抽象基類
class Student(CommonInfo):
    home_group = models.CharField(max_length=5)
    # 自動擁有name, age, created_at字段

class Teacher(CommonInfo):
    department = models.CharField(max_length=50)
    # 自動擁有name, age, created_at字段

模型繼承實戰

實戰場景：在一個Django+Vue 后臺管理系統中，需要維護多個數據表。這些數據表中，一般需要記錄創建者、創建時間、更新者和更新時間等信息。可將該部分公共字段提取到抽象基類，避免代碼重復。

定義抽象基類BaseModel

from django.db import models


class BaseModel(models.Model):
    creator = models.CharField(
        max_length=64, blank=True, null=True, default="", db_comment="創建者"
    )
    create_time = models.DateTimeField(auto_now_add=True, db_comment="創建時間")
    updater = models.CharField(
        max_length=64, blank=True, null=True, default="", db_comment="更新者"
    )
    update_time = models.DateTimeField(auto_now=True, db_comment="更新時間")

    class Meta:
        abstract = True

繼承抽象基類：點擊查看完整代碼

實現效果

您正在閱讀的是《Django從入門到實戰》專欄！關注不迷路~

posted @ 2025-07-29 10:22 小王子1024 閱讀(320) 評論(0) 收藏舉報

刷新頁面返回頂部