如何搭建一个Python Django项目:从零开始的详细指南

off999 2024-12-20 17:58 60 浏览 0 评论

Django是一个功能强大的Python Web开发框架，适合于各种Web应用开发，小到博客系统大到复杂的企业级应用都可以使用Django进行开发。在本篇博客中，我们将展示如何从零开始构建一个完整的Django项目，来详细介绍一下如何创建Django项目。

准备工作

Django开发依赖于Python的开发环境，所以首先需要保证你的系统中安装了Python开发环境，推荐使用3.8 及以上版本，然后通过如下的命令来检查是否安装成功。

python --version

创建虚拟环境

通过创建虚拟环境可以实现项目依赖的隔离，避免出现包冲突，下面我们就来介绍一下如何创建并且激活虚拟环境。

# 在项目目录下创建虚拟环境
python -m venv env

# 激活虚拟环境（Windows）
env\Scripts\activate

# 激活虚拟环境（Mac/Linux）
source env/bin/activate

激活了虚拟机环境之后，在命令行前面的提示符就会变成env，这就表示虚拟环境已经启动了。

安装Django

Python环境安装完成之后，接下来需要做的事情就是安装最新版本的Django，可以通过如下的命令来进行安装。

pip install django

安装完成之后，通过如下的命令来检查是否安装成功。

django-admin --version

创建Django项目

Django环境安装成功之后，接下来就是通过django-admin命令来创建一个Django的项目，如下所示。

django-admin startproject myproject

命令执行完成之后，就会在当前目录下创建一个名为myproject的文件夹，结构如下所示。

myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

manage.py: 项目管理工具，用于运行服务器、迁移数据库等。
settings.py: 项目配置文件。
urls.py: URL 路由配置。
wsgi.py/asgi.py: 部署相关配置。

运行开发服务器

进入到项目的根路径下，通过如下的命令来启动开发服务器。

cd myproject
python manage.py runserver

启动之后，会看到如下的输出内容，

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

这个时候，就可以在浏览器中访问http://127.0.0.1:8000/，如果看到 Django 欢迎页面，说明项目搭建成功。

创建应用 (App)

Django项目是由多个应用组成的项目，每个应用都可以实现特定的功能，下面我们就来尝试创建一个blog的应用程序，如下所示。

python manage.py startapp blog

这个命令会在项目路径下生成一个如下结构的目录文件。

blog/
    __init__.py
    admin.py
    apps.py
    models.py
    tests.py
    views.py

注册应用

这个时候，我们需要将应用进行注册，打开项目的settings.py文件，然后在INSTALLED_APPS中注册新的应用，如下所示。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',  # 注册 blog 应用
]

创建模型 (Model)

模型的作用是用来定义应用程序中使用到的数据结构，对标数据库的结构，可以在blog/models.py中添加以下代码来定义对应的数据模型结构，如下所示。

from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

创建迁移并同步数据库

创建完成之后，可以通过如下的命令来创建数据库迁移。

python manage.py makemigrations
python manage.py migrate

注册模型到管理后台

接下来在blog/admin.py中将模型进行注册，如下所示。

from django.contrib import admin
from .models import Post

admin.site.register(Post)

启动服务器后，访问 http://127.0.0.1:8000/admin/。就会看到Post模型已出现在管理后台。

创建视图和模板

数据模型创建完成之后，接下来就是在blog文件夹下新建一个templates/blog目录，创建post_list.html文件，如下所示。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Blog</title>
</head>
<body>
    <h1>Blog Posts</h1>
    <ul>
        {% for post in posts %}
            <li>{{ post.title }} - {{ post.created_at }}</li>
        {% endfor %}
    </ul>
</body>
</html>

接下来就是在blog/views.py中定义简单视图，用于展示所有的帖子，如下所示。

from django.shortcuts import render
from .models import Post

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

在blog目录下创建urls.py文件，并配置路由，进行帖子展示。

from django.urls import path
from . import views

urlpatterns = [
    path('', views.post_list, name='post_list'),
]

然后在主项目的urls.py文件中包含该应用的路由，进行后续的访问操作。

from django.contrib import admin
from django.urls import path, include

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