Django项目搭建：环境配置、读写分离与多应用模型创建详解

蓝鲸

发布时间：2026-10-13 | 4人浏览过

原创

本文详细讲解Django项目的初始化配置与数据库设计流程。内容涵盖从项目创建、MySQL驱动导入，到通过自定义数据库路由类实现读写分离的具体配置。同时介绍了利用抽象基类统一模型字段的方法，并演示了如何创建cart、goods、orders及users等多个应用，定义商品、订单及用户认证模型，最后完成数据库迁移。

Django项目初始化与环境配置

本节主要介绍如何搭建Django项目、配置运行环境以及创建数据库表结构。

首先，使用命令行工具创建一个名为ttsx的Django项目。


django-admin startproject ttsx

接着，在项目根目录下的__init__.py文件中导入pymysql模块，以便Django能够使用MySQL数据库。


import pymysql
pymysql.install_as_MySQLdb()

随后，配置MySQL数据库的读写分离策略，确保读写操作能正确路由到对应的数据库实例。


# default:默认的配置的是主数据库
 'default': {
  'ENGINE': 'django.db.backends.mysql',
  'HOST': 'localhost',
  'PORT': 3306,
  'USER': 'root',
  'PASSWORD': "mysql",
  'NAME': "ttsx"
 },
 # 配置的是从数据库
 'slave': {
  'ENGINE': 'django.db.backends.mysql',
  'HOST': 'localhost',
  'PORT': 3306,
  'USER': 'root',
  'PASSWORD': "mysql",
  'NAME': "ttsx"
 },

在项目目录下的utils文件夹中，新建db_router.py文件，具体路径结构可参考下图。

数据库读写分离路由配置

在utils/db_router.py文件中定义一个数据库路由类，通过实现特定策略来控制不同模型对数据库的访问权限。

数据库路由机制说明。

数据库路由是一个Python类，它必须提供以下四个核心方法：

db_for_read(model, **hints)¶

db_for_read：建议Model类型对象的读操作应使用的数据库名称。

如果数据库操作能提供额外信息以辅助选择数据库，这些信息将包含在hints字典中。合法的hints参数详情见下文说明。

若没有特定的读数据库建议，该方法应返回None。

db_for_write(model, **hints)¶

db_for_write：建议Model类型对象的写操作应使用的数据库名称。

同样，如果数据库操作能提供额外信息以辅助选择数据库，这些信息将包含在hints字典中。合法的hints参数详情见下文说明。

若没有特定的写数据库建议，该方法应返回None。

allow_relation(obj1, obj2, **hints)¶

allow_relation：判断obj1和obj2之间是否允许建立关联。若允许返回True，若禁止返回False，若无法判断则返回None。

这是一个纯粹的验证操作，外键和多对多关系创建时会调用此方法来决定两个对象间是否允许关联。


class MasterSlaveDBRouter(object):
 """读写分离路由"""
 
 def db_for_read(self, model, **hints):
  """读数据库"""
  return "slave"
 
 def db_for_write(self, model, **hints):
  """写数据库"""
  return "default"
 
 def allow_relation(self, obj1, obj2, **hints):
  """是否运行关联操作"""
  return True

在Django配置文件中声明读写分离路由类所在的完整路径。


DATABASE_ROUTERS = ["utils.db_router.MasterSlaveDBRouter"]

=========================================================================================================================================================

抽象基类与公共字段定义

为模型类补充公共字段的方法。

在utils目录下创建models.py文件，用于定义一个“为模型类补充字段”的抽象基类。该类被声明为抽象类，不会生成迁移文件，专门供其他模型继承使用。

在Meta元选项中设置abstract=True，以声明这是一个抽象模型类，不参与数据库迁移。


from django.db import models

class BaseModel(models.Model):
 '''为模型类补充字段'''
 create_time=models.DateTimeField(auto_now_add=True,verbose_name='创建时间')
 update_time=models.DateTimeField(auto_now=True,verbose_name='更新时间')
 class Meta:
  abstract=True # 声明是抽象模型类，不迁移,专门给别的表继承用的

==========================================================================================================================================================

多应用创建与模型定义

创建Django应用（App）。

在项目根目录下创建一个app目录，用于集中存储所有的应用模块。

在app目录下分别创建cart、goods、orders和users四个应用。


python ../manage.py startapp cart
 
python ../manage.py startapp goods
 
python ../manage.py startapp orders
 
python ../manage.py startapp users

在goods应用的models.py中定义与商品相关的模型类，具体代码参考如下。


from django.db import models
from utils.models import BaseModel
from tinymce.models import HTMLField
 
# Create your models here.
 
 
class GoodsCategory(BaseModel):
 """商品类别表"""
 name = models.CharField(max_length=20, verbose_name="名称")
 logo = models.CharField(max_length=100, verbose_name="标识")
 image = models.ImageField(upload_to="category", verbose_name="图片")
 
 class Meta:
  db_table = "df_goods_category"
  verbose_name = "商品类别" # admin站点使用
  verbose_name_plural = verbose_name
 
 def __str__(self):
  return self.name
 
 
class Goods(BaseModel):
 """商品SPU表"""
 name = models.CharField(max_length=100, verbose_name="名称")
 # desc = HTMLField(verbose_name="详细介绍", default="", blank=True) 富文本编辑器
 
 class Meta:
  db_table = "df_goods"
  verbose_name = "商品"
  verbose_name_plural = verbose_name
 
 def __str__(self):
  return self.name
 
 
class GoodsSKU(BaseModel):
 """商品SKU表"""
 category = models.ForeignKey(GoodsCategory, verbose_name="类别")
 goods = models.ForeignKey(Goods, verbose_name="商品")
 name = models.CharField(max_length=100, verbose_name="名称")
 title = models.CharField(max_length=200, verbose_name="简介")
 unit = models.CharField(max_length=10, verbose_name="销售单位")
 price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="价格")
 stock = models.IntegerField(default=0, verbose_name="库存")
 sales = models.IntegerField(default=0, verbose_name="销量")
 default_image = models.ImageField(upload_to="goods", verbose_name="图片")
 status = models.BooleanField(default=True, verbose_name="是否上线")
 
 class Meta:
  db_table = "df_goods_sku"
  verbose_name = "商品SKU"
  verbose_name_plural = verbose_name
 
 def __str__(self):
  return self.name
 
 
class GoodsImage(BaseModel):
 """商品图片"""
 sku = models.ForeignKey(GoodsSKU, verbose_name="商品SKU")
 image = models.ImageField(upload_to="goods", verbose_name="图片")
 
 class Meta:
  db_table = "df_goods_image"
  verbose_name = "商品图片"
  verbose_name_plural = verbose_name
 
 def __str__(self):
  return str(self.sku)
 
 
class IndexGoodsBanner(BaseModel):
 """主页轮播商品展示"""
 sku = models.ForeignKey(GoodsSKU, verbose_name="商品SKU")
 image = models.ImageField(upload_to="banner", verbose_name="图片")
 index = models.SmallIntegerField(default=0, verbose_name="顺序")
 
 class Meta:
  db_table = "df_index_goods"
  verbose_name = "主页轮播商品"
  verbose_name_plural = verbose_name
 
 def __str__(self):
  return str(self.sku)
 
 
class IndexCategoryGoodsBanner(BaseModel):
 """主页分类商品展示"""
 DISPLAY_TYPE_CHOICES = (
  (0, "标题"),
  (1, "图片")
 )
 category = models.ForeignKey(GoodsCategory, verbose_name="商品类别")
 sku = models.ForeignKey(GoodsSKU, verbose_name="商品SKU")
 display_type = models.SmallIntegerField(choices=DISPLAY_TYPE_CHOICES, verbose_name="展示类型")
 index = models.SmallIntegerField(default=0, verbose_name="顺序")
 
 class Meta:
  db_table = "df_index_category_goods"
  verbose_name = "主页分类展示商品"
  verbose_name_plural = verbose_name
 
 def __str__(self):
  return str(self.sku)
 
 
class IndexPromotionBanner(BaseModel):
 """主页促销活动展示"""
 name = models.CharField(max_length=50, verbose_name="活动名称")
 url = models.URLField(verbose_name="活动连接")
 image = models.ImageField(upload_to="banner", verbose_name="图片")
 index = models.SmallIntegerField(default=0, verbose_name="顺序")
 
 class Meta:
  db_table = "df_index_promotion"
  verbose_name = "主页促销活动"
  verbose_name_plural = verbose_name
 
 def __str__(self):
  return self.name

在orders应用的models.py中定义与订单相关的模型类，具体代码参考如下。


from django.db import models
from utils.models import BaseModel
from users.models import User, Address
from goods.models import GoodsSKU
 
# Create your models here.
 
 
class OrderInfo(BaseModel):
 """订单信息"""
 PAY_METHOD_CHOICES = (
  (1, "货到付款"),
  (2, "支付宝"),
 )
 
 ORDER_STATUS_CHOICES = (
  (1, "待支付"),
  (2, "待发货"),
  (3, "待收货"),
  (4, "待评价"),
  (5, "已完成"),
 )
 
 order_id = models.CharField(max_length=64, primary_key=True, verbose_name="订单号")
 user = models.ForeignKey(User, verbose_name="下单用户")
 address = models.ForeignKey(Address, verbose_name="收获地址")
 total_count = models.IntegerField(default=1, verbose_name="商品总数")
 total_amount = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="商品总金额")
 trans_cost = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="运费")
 pay_method = models.SmallIntegerField(choices=PAY_METHOD_CHOICES, default=1, verbose_name="支付方式")
 status = models.SmallIntegerField(choices=ORDER_STATUS_CHOICES, default=1, verbose_name="订单状态")
 trade_id = models.CharField(max_length=100, unique=True, null=True, blank=True, verbose_name="支付编号")
 
 class Meta:
  db_table = "df_order_info"
 
 
class OrderGoods(BaseModel):
 """订单商品"""
 order = models.ForeignKey(OrderInfo, verbose_name="订单")
 sku = models.ForeignKey(GoodsSKU, verbose_name="订单商品")
 count = models.IntegerField(default=1, verbose_name="数量")
 price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="单价")
 comment = models.TextField(default="", verbose_name="评价信息")
 
 class Meta:
  db_table = "df_order_goods"

在users应用的models.py中定义与用户相关的模型类，具体代码参考如下。


from django.db import models
from django.contrib.auth.models import AbstractUser
from utils.models import BaseModel
from django.conf import settings
from goods.models import GoodsSKU
 
from itsdangerous import TimedJSONWebSignatureSerializer as Serializer
 
# Create your models here.
 
# django默认的认证机制，在setting installAPPs中的 'django.contrib.auth',
# 所以我们要声明自己的认证路径 去setting配置,AUTH_USER_MODEL = "users.User"
 
class User(AbstractUser, BaseModel):
 """用户"""
 # 我们自己不用指明字段，django的默认字段，都通过继承AbstractUser它就有了
 class Meta:
  db_table = "df_users"
 
 def generate_active_token(self):
  """生成激活令牌"""
  serializer = Serializer(settings.SECRET_KEY, 3600)
  token = serializer.dumps({"confirm": self.id}) # 返回bytes类型
  return token.decode()
 
 
class Address(BaseModel):
 """地址"""
 user = models.ForeignKey(User, verbose_name="所属用户")
 receiver_name = models.CharField(max_length=20, verbose_name="收件人")
 receiver_mobile = models.CharField(max_length=11, verbose_name="联系电话")
 detail_addr = models.CharField(max_length=256, verbose_name="详细地址")
 zip_code = models.CharField(max_length=6, verbose_name="邮政编码")
 
 class Meta:
  db_table = "df_address"

==============================================================================================================================================================================　

用户认证模型与配置

用户认证模型类的定义。

在配置文件中指定自定义认证系统所使用的用户模型路径，即users应用中的User类。注意Django只支持模块名和类名之间用单个点号分隔，格式错误会导致解析失败。

例如，若写成AUTH_USER_MODEL = "apps.users.User"则无法解析，因为多了一个点号。因此需要将其调整为users.User格式，为此需将apps目录添加到Python解析路径中。


import sys
sys.path.insert(1, os.path.join(BASE_DIR, "app"))
 
#认证系统使用的用户模型
AUTH_USER_MODEL = "users.User"

将注册的应用添加到配置文件的INSTALLED_APPS列表中。由于前面已将app目录加入解析路径，因此无需使用apps.users这种完整路径，直接写入应用名称即可。

================================================================================================================================================================================

数据库创建与迁移执行

创建对应的数据库。


create database ttsx charset=utf8;

执行数据库迁移命令以生成表结构。


python manage.py makemigrations
python manage.py migrate

以上即为Django项目搭建、环境配置及表创建的全过程，希望对您的学习有所帮助，欢迎继续支持本站内容。

相关标签: Python Django MySQL 数据库

本站声明

本文内容仅供参考，不代表本站观点。转载或引用请注明出处。如发现内容问题，请通过联系我们页面反馈。

作者最新文章

全部内容

C++ 中函数覆盖与隐藏的区分及多态实现 2026-10-16
C++ cin输入的多种方法详解 2026-10-16
Golang Channel 底层原理与源码深度解析 2026-10-16
攻防世界 Web PHP Include 解题指南：文件包含与命令注入实战 2026-10-16
TypeScript中unknown与any的区别及安全使用指南 2026-10-16

Python 相关产品和应用

全部下载

Python Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

Python 机器学习

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Python 代码质量

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Python 代码质量

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

Python pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

Python FastAPI API

FastAPI

0.146.0 · Windows

高性能 Python API 框架，支持类型提示和自动接口文档。

Python Flask Web开发

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Python Django Web开发

Django

6.1.2 · Windows

成熟的 Python Web 框架，适合构建内容站点和业务系统。

Python Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

Python SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。

Python Pandas 数据分析

pandas

3.0.6 · Windows

Python 数据分析库，提供 DataFrame 与丰富的数据处理能力。

Python NumPy

NumPy

2.5.4 · Windows

Python 科学计算基础库，提供高性能多维数组与数值运算。

网站导航

Django项目搭建：环境配置、读写分离与多应用模型创建详解

Django项目初始化与环境配置

数据库读写分离路由配置

抽象基类与公共字段定义

多应用创建与模型定义

用户认证模型与配置

数据库创建与迁移执行

本站声明

作者最新文章

Python 相关产品和应用

Selenium

scikit-learn

Black

Ruff

pytest

FastAPI

Flask

Django

Spyder

SciPy

pandas

NumPy

文章分类

专题列表

Django项目搭建：环境配置、读写分离与多应用模型创建详解

Django项目初始化与环境配置

数据库读写分离路由配置

抽象基类与公共字段定义

多应用创建与模型定义

用户认证模型与配置

数据库创建与迁移执行

相关文章

本站声明

作者最新文章

Python 相关产品和应用

Selenium

scikit-learn

Black

Ruff

pytest

FastAPI

Flask

Django

Spyder

SciPy

pandas

NumPy

文章分类

专题列表