《Python实战进阶》专栏 No.3：Django 项目结构解析与入门DEMO

带娃的IT创业者2025-02-23 18:45

《Python实战进阶》专栏 第3集：Django 项目结构解析与入门DEMO

在本集中，我们将深入探讨 Django 的项目结构，并实际配置并运行一个入门DEMO博客网站，帮助你在 Web 开发中更高效地使用 Django。Django 是一个功能强大的 Python Web 框架，它提供了开箱即用的工具和清晰的项目结构，但要真正掌握它，需要理解其内部机制并遵循良好的开发习惯。

本文将涵盖以下内容：

  1. Django 项目结构解析
  2. 项目结构的最佳实践
  3. 实际代码示例：构建一个简单的博客系统
  4. 总结与建议

一、Django 项目结构解析

当你运行 django-admin startproject myproject 创建一个新的 Django 项目时，Django 会生成一个默认的项目结构。以下是典型的 Django 项目结构：

复制代码 
myproject/
├── manage.py
├── myproject/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── app1/
    ├── migrations/
    │   └── __init__.py
    ├── admin.py
    ├── apps.py
    ├── models.py
    ├── tests.py
    ├── views.py
    └── __init__.py

1. 核心文件说明

  • manage.py: 项目的命令行工具，用于运行服务器、迁移数据库等。
  • settings.py: 项目的配置文件，包含数据库设置、应用注册、中间件等。
  • urls.py: 定义项目的 URL 路由规则。
  • wsgi.py: 用于部署 WSGI 应用的入口文件。
  • app1/: 这是一个应用目录，Django 鼓励将功能模块化为多个应用。

2. 应用结构说明

每个 Django 应用通常包含以下文件：

  • models.py: 定义数据模型。
  • views.py: 处理请求并返回响应。
  • admin.py: 配置 Django 管理后台。
  • tests.py: 编写单元测试。
  • migrations/: 数据库迁移文件。

二、项目结构的最佳实践

项目最终总体结构图如下：

1. 模块化设计

Django 提倡"可插拔的应用"理念。每个应用应该专注于一个特定的功能模块，例如用户管理、博客文章、评论系统等。这样可以提高代码的复用性和可维护性。

建议：

  • 将通用功能（如用户认证、日志记录）封装成独立的应用。
  • 使用 INSTALLED_APPS 注册所有应用。

2. 配置分离

在实际项目中，开发环境和生产环境的配置可能不同。可以通过以下方式实现配置分离：

  • 创建 settings/ 目录，分为 base.py, dev.py, prod.py。
  • 在 manage.py 和 wsgi.py 中动态加载配置。
python 复制代码 
# manage.py
import os
import sys

def main():
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings.dev')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed?"
        ) from exc
    execute_from_command_line(sys.argv)

if __name__ == '__main__':
    main()

3. 遵循 MVC 模式

虽然 Django 更像是 MTV（Model-Template-View），但核心思想是一致的：

  • Model: 数据层，负责与数据库交互。
  • Template: 视图层，负责渲染 HTML。
  • View: 控制层，处理业务逻辑。

4. 使用 Django REST Framework (DRF)

如果你需要构建 API，推荐使用 DRF。它可以快速创建 RESTful 接口，并支持序列化、权限控制等功能。

三、实际代码示例：构建一个简单的博客系统

我们将通过一个简单的博客系统来演示 Django 的项目结构和最佳实践。

1. 创建项目和应用

bash 复制代码 
pip install django
# 等待安装完成
pip show django
# 显示Django版本信息，我使用的是最新的 5.1.6版本
Name: Django
Version: 5.1.6
Summary: A high-level Python web framework that encourages rapid development and clean, pragmatic design.
Home-page:
Author:
Author-email: Django Software Foundation <foundation@djangoproject.com>
License: BSD-3-Clause
Location: D:\python_projects\django_demo\Lib\site-packages
Requires: asgiref, sqlparse, tzdata
Required-by:
# 新建一个Django项目，名字为 blog_project
django-admin startproject blog_project
cd blog_project
python manage.py startapp blog

2. 定义数据模型

在 blog/models.py 中定义博客文章模型：

python 复制代码 
from django.db import models
from django.utils import timezone

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    created_at = models.DateTimeField(default=timezone.now)
    updated_at = models.DateTimeField(auto_now=True)

    def __str__(self):
        return self.title

运行迁移命令以创建数据库表：

bash 复制代码 
python manage.py makemigrations
python manage.py migrate

命令执行结果：

bash 复制代码 
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying auth.0012_alter_user_first_name_max_length... OK
  Applying sessions.0001_initial... OK

3. 创建视图和模板

在 blog/views.py 中定义视图函数：

python 复制代码 
from django.shortcuts import render, get_object_or_404
from .models import Post

def post_list(request):
    posts = Post.objects.all().order_by('-created_at')
    return render(request, 'blog/post_list.html', {'posts': posts})

def post_detail(request, pk):
    post = get_object_or_404(Post, pk=pk)
    return render(request, 'blog/post_detail.html', {'post': post})

# 示例数据，创建一条博客
Post.objects.create(title='新文章标题', content='这是文章的内容')

# 示例数据，创建一条博客
Post.objects.create(title='今日日记', content='今天我创建了第一个django项目。')

在 blog_project/blog/templates/blog/ 目录下创建模板文件 post_list.html 和 post_detail.html：

html 复制代码 
<!-- post_list.html -->
<h1>Blog Posts</h1>
<ul>
    {% for post in posts %}
        <li><a href="{% url 'post_detail' post.pk %}">{{ post.title }}</a></li>
    {% endfor %}
</ul>

<!-- post_detail.html -->
<h1>{{ post.title }}</h1>
<p>{{ post.content }}</p>
<p>Created at: {{ post.created_at }}</p>

4. 配置 URL 路由

在 blog/urls.py 中定义路由：

python 复制代码 
from django.urls import path
from . import views

urlpatterns = [
    path('', views.post_list, name='post_list'),
    path('<int:pk>/', views.post_detail, name='post_detail'),
]

在主项目的 urls.py 中包含应用的路由：

python 复制代码 
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('blog/', include('blog.urls')),
]

在主项目文件夹 blog_project 下面的 settings.py 配置文件中注册APP和路由：

  • 注册一行 'blog',
bash 复制代码 
# Application definition

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    'blog',
]
  • 配置 templates 地址
bash 复制代码 
TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [BASE_DIR / 'templates'],# 如果使用项目根目录的 templates 文件夹
        "APP_DIRS": True,
        "OPTIONS": {
            "context_processors": [
                "django.template.context_processors.debug",
                "django.template.context_processors.request",
                "django.contrib.auth.context_processors.auth",
                "django.contrib.messages.context_processors.messages",
            ],
        },
    },
]

再次运行迁移命令以更新数据库表：

bash 复制代码 
python manage.py makemigrations
python manage.py migrate

5. 启动服务器

运行开发服务器并访问博客系统：

bash 复制代码 
python manage.py runserver

打开浏览器访问 http://127.0.0.1:8000/blog/，即可看到博客列表。

要增加博客内容，您可以通过以下几种方式来丰富您的博客：

如果您使用的是 Django 的模型来存储博客文章，您可以通过 Django 管理后台添加更多内容。

  • 使用 Django 管理后台
  • 创建超级用户：
    如果您还没有创建超级用户，可以在项目根目录下运行以下命令：
bash 复制代码 
   python manage.py createsuperuser

按照提示输入用户名、电子邮件和密码。

bash 复制代码 
# blog/admin.py
from django.contrib import admin
from .models import Post

# 注册 Post 模型
admin.site.register(Post)
  • 添加博客文章：
    在管理后台中，您应该能看到 Blog 应用下的 Posts（或您定义的模型名称）。点击进入后，您可以添加新的博客文章，输入标题、内容等信息。

四、总结与建议

通过本集的学习，你应该对 Django 的项目结构有了更深入的理解，可以发现，由于出色的封装，Django成为一个非常容易上手而且功能强大的CMS，是开发个人博客和网站的利器。 以下是一些额外的建议：

  1. 学习 Django REST Framework：如果需要构建 API，请务必掌握 DRF。
  2. 编写单元测试：确保代码的可靠性。
  3. 使用 Docker 部署：简化开发和部署流程。
  4. 关注性能优化：例如缓存、数据库索引等。

希望这篇文章对你有所帮助！如果你有任何问题或想法，欢迎在评论区留言讨论。

下集预告：第4集将聚焦于 GraphQL 与 RESTful API 对比与实现 。敬请期待！

相关推荐
明日清晨25 分钟前
python扫码登录dy
开发语言·python
阿里小阿希29 分钟前
CentOS7 PostgreSQL 9.2 升级到 15 完整教程
数据库·postgresql
荒川之神34 分钟前
Oracle 数据仓库雪花模型设计（完整实战方案）
数据库·数据仓库·oracle
bazhange39 分钟前
python如何像matlab一样使用向量化替代for循环
开发语言·python·matlab
做个文艺程序员1 小时前
MySQL安全加固十大硬核操作
数据库·mysql·安全
人工干智能1 小时前
科普：python中你写的模块找不到了——`ModuleNotFoundError`
服务器·python
不吃香菜学java1 小时前
Redis简单应用
数据库·spring boot·tomcat·maven
unicrom_深圳市由你创科技1 小时前
做虚拟示波器这种实时波形显示的上位机，用什么语言？
c++·python·c#
小敬爱吃饭1 小时前
Ragflow Docker部署及问题解决方案(界面为Welcome to nginx，ragflow上传文件失败，Docker中的ragflow-cpu-1一直重启)
人工智能·python·nginx·docker·语言模型·容器·数据挖掘
一个天蝎座 白勺 程序猿1 小时前
Apache IoTDB（15）：IoTDB查询写回（INTO子句）深度解析——从语法到实战的ETL全链路指南
数据库·apache·etl·iotdb
热门推荐
01GitHub 镜像站点02一周AI热点速览（2026.03.31-04.06）：GPT-6曝光、谷歌开源Gemma 4、资本狂飙与模型军备竞赛03OpenClaw 请求超时 llm request timed out 怎么解决？3 种方案实测，附完整排查流程04AI 编程效率翻倍：Superpowers Skills 上手清单 + 完整指南05MySQL表约束详解：8大核心约束实战指南06Oh My Codex 快速使用指南07CodeBuddy与WorkBuddy深度对比：腾讯两款AI工具差异及实操指南08VMware Workstation Pro 17 虚拟机完整安装教程（2026最新）09UV安装并设置国内源10实测！Gemma 4 成功跑在安卓手机上：离线 AI 助手终于来了