百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

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

itomcoil 2025-03-01 14:17 10 浏览

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文件,如下所示。




    
    Blog


    

Blog Posts

    {% for post in posts %}
  • {{ post.title }} - {{ post.created_at }}
  • {% endfor %}

接下来就是在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将项目部署到生产服务器上。

相关推荐

Python Qt GUI设计:将UI文件转换Python文件三种妙招(基础篇—2)

在开始本文之前提醒各位朋友,Python记得安装PyQt5库文件,Python语言功能很强,但是Python自带的GUI开发库Tkinter功能很弱,难以开发出专业的GUI。好在Python语言的开放...

Connect 2.0来了,还有Nuke和Maya新集成

ftrackConnect2.0现在可以下载了--重新设计的桌面应用程序,使用户能够将ftrackStudio与创意应用程序集成,发布资产等。这个新版本的发布中还有两个Nuke和Maya新集成,...

Magicgui:不会GUI编程也能轻松构建Python GUI应用

什么是MagicguiMagicgui是一个Python库,它允许开发者仅凭简单的类型注解就能快速构建图形用户界面(GUI)应用程序。这个库基于Napari项目,利用了Python的强大类型系统,使得...

Python入坑系列:桌面GUI开发之Pyside6

阅读本章之后,你可以掌握这些内容:Pyside6的SignalsandSlots、Envents的作用,如何使用?PySide6的Window、DialogsandAlerts、Widgets...

Python入坑系列-一起认识Pyside6 designer可拖拽桌面GUI

通过本文章,你可以了解一下内容:如何安装和使用Pyside6designerdesigner有哪些的特性通过designer如何转成python代码以前以为Pyside6designer需要在下载...

pyside2的基础界面(pyside2显示图片)

今天我们来学习pyside2的基础界面没有安装过pyside2的小伙伴可以看主页代码效果...

Python GUI开发:打包PySide2应用(python 打包pyc)

之前的文章我们介绍了怎么使用PySide2来开发一个简单PythonGUI应用。这次我们来将上次完成的代码打包。我们使用pyinstaller。注意,pyinstaller默认会将所有安装的pack...

使用PySide2做窗体,到底是怎么个事?看这个能不能搞懂

PySide2是Qt框架的Python绑定,允许你使用Python创建功能强大的跨平台GUI应用程序。PySide2的基本使用方法:安装PySide2pipinstallPy...

pycharm中conda解释器无法配置(pycharm安装的解释器不能用)

之前用的好好的pycharm正常配置解释器突然不能用了?可以显示有这个环境然后确认后可以conda正在配置解释器,但是进度条结束后还是不成功!!试过了pycharm重启,pycharm重装,anaco...

Conda使用指南:从基础操作到Llama-Factory大模型微调环境搭建

Conda虚拟环境在Linux下的全面使用指南:从基础操作到Llama-Factory大模型微调环境搭建在当今的AI开发与数据分析领域,conda虚拟环境已成为Linux系统下管理项目依赖的标配工具。...

Python操作系统资源管理与监控(python调用资源管理器)

在现代计算环境中,对操作系统资源的有效管理和监控是确保应用程序性能和系统稳定性的关键。Python凭借其丰富的标准库和第三方扩展,提供了强大的工具来实现这一目标。本文将探讨Python在操作系统资源管...

本地部署开源版Manus+DeepSeek创建自己的AI智能体

1、下载安装Anaconda,设置conda环境变量,并使用conda创建python3.12虚拟环境。2、从OpenManus仓库下载代码,并安装需要的依赖。3、使用Ollama加载本地DeepSe...

一文教会你,搭建AI模型训练与微调环境,包学会的!

一、硬件要求显卡配置:需要Nvidia显卡,至少配备8G显存,且专用显存与共享显存之和需大于20G。二、环境搭建步骤1.设置文件存储路径非系统盘存储:建议将非安装版的环境文件均存放在非系统盘(如E盘...

使用scikit-learn为PyTorch 模型进行超参数网格搜索

scikit-learn是Python中最好的机器学习库,而PyTorch又为我们构建模型提供了方便的操作,能否将它们的优点整合起来呢?在本文中,我们将介绍如何使用scikit-learn中的网格搜...

如何Keras自动编码器给极端罕见事件分类

全文共7940字,预计学习时长30分钟或更长本文将以一家造纸厂的生产为例,介绍如何使用自动编码器构建罕见事件分类器。现实生活中罕见事件的数据集:背景1.什么是极端罕见事件?在罕见事件问题中,数据集是...