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

liftword4周前 (12-12)技术文章20

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')),
]

启动项目

再次启动开发服务器

python manage.py runserver

访问http://127.0.0.1:8000/,就应该会看到所有博客帖子。

总结

以上就是从零开始搭建一个Django项目的完整流程,可以基于上面的实现为博客添加用户注册、登录功能。通过配置各种的样式文件以及JS文件对页面操作进行进一步的美化,最终可以通过Heroku或PythonAnywhere将项目部署到生产服务器上。

相关文章

推荐15个最受欢迎的Python开源框架

以下是伯乐在线从GitHub中整理出的15个最受欢迎的Python开源框架。这些框架包括事件I/O,OLAP,Web开发,高性能网络通信,测试,爬虫等。Django: Python Web应用开发框架...

Python Flask 大型应用的架构

这里推荐了一个Python Flask的应用架构,root路径是老乡鸡文件夹,里面一个app文件夹,加上一个go.py启动文件,虽然这个例子里面,我写的很挫,但是大概意思到位了,实际上业务代码都要写到...

[python] 基于diagrams库绘制系统架构图

Python的Diagrams库允许通过简单的Python代码绘制云系统架构,实现对新的系统架构进行原型设计。Diagrams的官方仓库地址见:?diagrams???。Diagrams的官方文档和使...

产品经理要理解的架构图(结构图)

产品经理在工作过程中会遇到各种结构图(结构图),这些名词很容易混淆。一般情况下,3-5年经验,善于总结归纳的产品经理才能逐步理解这些概念的含义,并且相对灵活的运用到工作中。下面针对这些概念来系统地梳理...

Python中Web开发框架有哪些?

Python 为 Web 开发提供了许多优秀的框架。以下是一些流行的 Python Web 框架:1. Django:一个高级的 Web 框架,旨在快速开发干净、实用的 Web 应用。Django 遵...