TypeScript类转Django模型语法疑问及Python实战学习资源咨询

完整Django模型实现 #

from django.db import models
from typing import Optional, List

# 若CustomFields为固定结构的关联模型，单独定义即可；如果是动态键值对可省略，直接在Category中用JSONField存储
class CustomFields(models.Model):
    # 可根据实际业务需求补充对应的字段
    ext_info = models.TextField(blank=True, null=True)
    config = models.JSONField(default=dict)

    def __str__(self):
        return f"自定义字段组{self.id}"

class Category(models.Model):
    # 对应TS的 'shop'|'blog' 联合类型，用Django字段的choices实现
    CATEGORY_TYPE = (
        ('shop', '店铺分类'),
        ('blog', '博客分类'),
    )

    # Django默认会自动生成自增id主键，手动写AutoField也可按需保留
    id = models.AutoField(primary_key=True)
    type = models.CharField(max_length=10, choices=CATEGORY_TYPE)
    name = models.CharField(max_length=100)
    slug = models.CharField(max_length=100, unique=True) # slug通常要求全局唯一，可按需调整
    path = models.CharField(max_length=250)
    # 可空图片字段，也可替换为ImageField自动处理图片上传逻辑
    image = models.CharField(max_length=250, blank=True, null=True)
    items = models.IntegerField(default=0) # 分类下关联的条目数默认设为0更合理
    # 一对一关联CustomFields，若要动态存储自定义字段可替换为models.JSONField(blank=True, null=True)
    customFields = models.OneToOneField(CustomFields, on_delete=models.CASCADE, related_name="category")
    # 自关联多对多实现父子分类，symmetrical=False关闭对称关联，blank+null实现可空效果
    parents = models.ManyToManyField('self', symmetrical=False, related_name="children", blank=True, null=True)

    def __str__(self):
        return self.name

你之前编写的代码中type: 'shop'|'blog'是Python类型提示的写法，需要替换为上述带choices的CharField才能正常映射为数据库字段。

核心疑问解答 #

• TS可选标记?的对应实现
  Django模型层面要实现字段可选可空，给字段加两个参数即可：blank=True表示前端/表单提交时允许该字段为空，null=True表示数据库层面允许存储空值。如果仅需要类型提示层面的可选，直接用typing.Optional标记类型即可。
• 关联类属性customFields: CustomFields的实现方式
  分两种场景选择：
  • 自定义字段结构固定：像上述代码一样单独定义CustomFields模型，用OneToOneField一对一关联即可，数据结构更规范，方便做关联查询
  • 自定义字段结构不固定、经常要新增字段：直接把customFields字段定义为models.JSONField(blank=True, null=True)，用JSON格式存储所有自定义键值对，不需要单独建表，灵活度更高
• 可空自关联类数组children?: Category[]|null的实现方案
  Django的多对多字段ManyToManyField传入'self'即可实现自关联，设置symmetrical=False表示非对称关系（符合父子分类的逻辑：A是B的父分类，不代表B是A的父分类），加blank=True, null=True即可实现可空。代码中不需要单独定义children字段，设置related_name="children"之后，直接通过分类实例.children就能拿到对应的子分类列表。

Python/Django实战学习推荐 #

• 入门阶段先过一遍Python官方中文文档的基础教程，把语法基础打牢之后直接跟着Django官方文档的入门教程写一遍投票应用案例，就能快速摸清楚Django的核心逻辑
• 入门后可以从实现个人博客、小型商品管理系统这类小项目练手，逐步熟悉ORM操作、路由配置、视图编写、后台管理这些常用功能
• 有一定基础之后可以参考成熟的Django开源项目的源码，学习规范的项目结构和最佳实践。

内容的提问来源于stack exchange，提问作者Rémi Duplan