如何搭建一个Python Django项目:从零开始的详细指南
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将项目部署到生产服务器上。