Django项目创建全流程思维导图

从虚拟环境到books应用的完整创建过程

本思维导图详细展示了从创建虚拟环境开始，到建立完整的Django books应用的每一个步骤。每个阶段都有详细的说明、代码示例和结构图，帮助您完全掌握Django项目的创建流程。

环境准备

安装Django

创建项目

创建应用

配置模型

运行测试

第一阶段：环境准备（虚拟环境）

创建项目文件夹

首先，为你的Django项目创建一个专门的文件夹，这样可以更好地组织你的代码。

mkdir django_books_project

cd django_books_project

创建虚拟环境

虚拟环境可以隔离项目的Python包依赖，避免不同项目之间的包版本冲突。

# Windows/Linux/Mac通用命令

python -m venv venv

# 如果上面命令无效，尝试使用python3

python3 -m venv venv

激活虚拟环境

激活虚拟环境后，你安装的所有Python包都将只安装在这个环境中，不会影响系统全局环境。

# Windows系统

venv\Scripts\activate.ps1

# Linux/Mac系统

source venv/bin/activate

# 激活成功后，命令行开头会出现 (venv) 标志

检查点：虚拟环境激活成功

命令行开头显示 (venv) 标记

执行 pip list 显示干净的包列表（只包含pip和setuptools）

当前工作目录中有 venv 文件夹

第二阶段：安装Django

安装Django包

在激活的虚拟环境中，使用pip安装Django框架。

pip install django

# 如果需要安装特定版本

pip install django==5.0

# 如果下载速度慢，可以使用国内镜像源

pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple

验证安装

验证Django是否成功安装，并查看安装的版本。

django-admin --version

# 或使用Python验证

python -m django --version

创建依赖文件（可选但推荐）

将当前环境的所有依赖包记录到requirements.txt文件中，方便在其他环境中重现相同的环境。

pip freeze > requirements.txt

# 查看生成的文件内容

cat requirements.txt

# 在其他环境中恢复依赖

pip install -r requirements.txt

检查点：Django安装成功

django-admin --version 命令显示Django版本号

pip list 命令显示Django在已安装包列表中

可以正常执行 django-admin 命令

第三阶段：创建Django项目

创建Django项目

使用django-admin命令创建一个新的Django项目，项目名称为"bookstore"。

django-admin startproject bookstore

# 这将在当前目录下创建一个名为bookstore的文件夹

进入项目目录

进入刚刚创建的Django项目目录，这是后续所有操作的根目录。

cd bookstore

查看项目结构

理解Django项目的标准结构，这是后续开发的基础。

django_books_project/
├── venv/
└── bookstore/
│ manage.py
└───bookstore/
│ __init__.py
│ settings.py
│ urls.py
│ asgi.py
│ wsgi.py

关键文件说明：

manage.py: 项目管理脚本，用于运行各种命令
settings.py: 项目配置文件，包含所有重要设置
urls.py: URL路由配置文件
asgi.py/wsgi.py: 服务器接口文件

检查点：项目创建成功

manage.py 文件存在于项目根目录

执行 python manage.py runserver 无错误

访问 http://127.0.0.1:8000 能看到Django欢迎页面

第四阶段：创建books应用

创建books应用

一个Django项目可以包含多个应用，每个应用负责一个特定的功能模块。现在我们创建一个名为"books"的应用。

python manage.py startapp books

查看应用结构

了解Django应用的标准结构，每个文件都有特定的用途。

books/
│ __init__.py
│ admin.py
│ apps.py
│ models.py
│ tests.py
│ views.py
└───migrations/
│ __init__.py

应用文件说明：

models.py: 定义数据模型（数据库表结构）
views.py: 定义视图函数（处理业务逻辑）
admin.py: 配置Django管理后台
migrations/: 存储数据库迁移文件

注册应用到项目

创建应用后，需要在项目的settings.py文件中注册该应用，Django才能识别和使用它。

# 编辑 bookstore/settings.py 文件

# 找到 INSTALLED_APPS 列表，添加 'books'

INSTALLED_APPS = [

    'django.contrib.admin',

    'django.contrib.auth',

    'django.contrib.contenttypes',

    'django.contrib.sessions',

    'django.contrib.messages',

    'django.contrib.staticfiles',

    'books',  # 添加这一行

]

检查点：应用创建成功

books 文件夹存在于项目根目录

books 应用已在 settings.py 的 INSTALLED_APPS 中注册

所有必要的应用文件都存在

第五阶段：配置books数据模型

编辑books/models.py

在models.py中定义Book模型，这将对应数据库中的一张表。

# books/models.py

from django.db import models

class Book(models.Model):

    title = models.CharField(max_length=200, verbose_name="书名")

    author = models.CharField(max_length=100, verbose_name="作者")

    publish_date = models.DateField(verbose_name="出版日期")

    isbn = models.CharField(max_length=13, unique=True, verbose_name="ISBN")

    price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="价格")

    def __str__(self):

        return self.title

    class Meta:

        verbose_name = "图书"

        verbose_name_plural = "图书管理"

注册模型到admin.py

将Book模型注册到Django管理后台，这样就可以在后台管理图书数据。

# books/admin.py

from django.contrib import admin

from .models import Book

@admin.register(Book)

class BookAdmin(admin.ModelAdmin):

    list_display = ('title', 'author', 'publish_date', 'price')

    list_filter = ('author', 'publish_date')

    search_fields = ('title', 'author', 'isbn')

    ordering = ('-publish_date',)

生成数据库迁移文件

迁移文件记录了数据模型的变化，可以追踪数据库结构的变更历史。

# 在项目根目录（有manage.py的目录）执行

python manage.py makemigrations books

# 如果成功，会看到类似输出：

# Migrations for 'books':

#   books/migrations/0001_initial.py

#     - Create model Book

执行数据库迁移

将迁移文件应用到数据库，实际创建或修改数据库表结构。

python manage.py migrate

# 如果成功，会看到类似输出：

# Operations to perform:

#   Apply all migrations: admin, auth, books, contenttypes, sessions

# Running migrations:

#   Applying books.0001_initial... OK

创建超级用户

创建管理员账户，用于登录Django管理后台。

python manage.py createsuperuser

# 按照提示输入用户名、邮箱和密码：

# Username: admin

# Email address: admin@example.com

# Password: ********

# Password (again): ********

# Superuser created successfully.

检查点：数据模型配置成功

makemigrations 成功生成迁移文件

migrate 成功执行无错误

在管理后台能看到 Books 模型

第六阶段：运行与测试

启动开发服务器

启动Django内置的开发服务器，测试项目是否正常运行。

python manage.py runserver

# 如果默认端口8000被占用，可以指定其他端口

python manage.py runserver 8080

# 成功启动后，会看到类似输出：

# Starting development server at http://127.0.0.1:8000/

# Quit the server with CTRL-BREAK.

访问网站

在浏览器中访问Django项目，测试各个功能。

# 1. 访问Django欢迎页面

http://127.0.0.1:8000/

# 2. 访问Django管理后台

http://127.0.0.1:8000/admin

# 3. 使用之前创建的超级用户登录

# 4. 在管理后台添加一些图书数据

# 5. 查看并验证数据是否正确保存

停止服务器

完成测试后，停止开发服务器。

# 在命令行窗口中按 Ctrl+C

# 或直接关闭命令行窗口

完整项目结构图

现在，你的项目应该具有以下完整结构：

django_books_project/
├── venv/
└── bookstore/
│ manage.py
│ db.sqlite3
├───bookstore/
│ │ __init__.py
│ │ settings.py
│ │ urls.py
│ │ asgi.py
│ │ wsgi.py
└───books/
│ __init__.py
│ admin.py
│ apps.py
│ models.py
│ tests.py
│ views.py
└───migrations/
│ __init__.py
│ 0001_initial.py

检查点：项目运行成功

开发服务器正常启动，无错误信息

可以访问 http://127.0.0.1:8000/admin 并成功登录

能在管理后台添加、编辑和删除图书数据

练习：Django项目创建流程填空题

根据上述流程，填写以下空白：

创建虚拟环境的命令是：python -m ______ venv
激活虚拟环境后，命令行开头会出现 ______ 标记
安装Django的命令是：______ install django
创建Django项目的命令是：django-admin ______ bookstore
创建应用books的命令是：python manage.py ______ books
注册应用需要在 ______ 文件的 ______ 列表中添加 'books'
数据模型定义在 ______ 文件中
生成数据库迁移文件的命令是：python manage.py ______
执行数据库迁移的命令是：python manage.py ______
创建超级用户的命令是：python manage.py ______
启动开发服务器的命令是：python manage.py ______
管理后台的默认访问地址是：http://______:______/admin

填写答案

10.

11.

12.