从零创建一个 Django 项目

打印 上一主题 下一主题

主题 758|帖子 758|积分 2284

1. 准备环境

在开始之前,确保你的开发环境满足以下要求:


  • 安装了 Python (推荐 3.8 或更高版本)。
  • 安装 pip 包管理工具。
  • 如果要使用 MySQL 或 PostgreSQL,确保对应的数据库已安装。
创建虚拟环境

在项目目录中创建并激活虚拟环境,包管项目依靠隔离:
  1. # 创建虚拟环境
  2. python -m venv env
  3. # 激活虚拟环境
  4. # Windows
  5. env\Scripts\activate
  6. # Linux/Mac
  7. source env/bin/activate
复制代码

2. 安装 Django 和数据库驱动

在激活的虚拟环境中安装 Django:
  1. pip install django
复制代码
如果使用 MySQL 或 PostgreSQL,还需要安装相应的驱动:


  • MySQL: 安装 mysqlclient:
    1. pip install mysqlclient
    复制代码
  • PostgreSQL: 安装 psycopg2:
    1. pip install psycopg2-binary
    复制代码
如果只是使用 SQLite,Django 默认支持,无需额外安装。

3. 创建 Django 项目

使用 django-admin 创建一个新的项目:
  1. django-admin startproject myproject
复制代码
项目结构

创建后,项目的基本结构如下:
  1. myproject/
  2.     manage.py         # 项目管理脚本
  3.     myproject/
  4.         __init__.py   # 包标识
  5.         settings.py   # 项目设置
  6.         urls.py       # URL 配置
  7.         asgi.py       # ASGI 配置
  8.         wsgi.py       # WSGI 配置
复制代码

4. 配置数据库

打开 myproject/myproject/settings.py,找到 DATABASES 配置项,根据数据库范例修改配置:
默认的 SQLite 配置

  1. DATABASES = {
  2.     'default': {
  3.         'ENGINE': 'django.db.backends.sqlite3',
  4.         'NAME': BASE_DIR / 'db.sqlite3',
  5.     }
  6. }
复制代码
使用 MySQL

如果你使用 MySQL,修改为:
  1. DATABASES = {
  2.     'default': {
  3.         'ENGINE': 'django.db.backends.mysql',
  4.         'NAME': 'your_database_name',
  5.         'USER': 'your_database_user',
  6.         'PASSWORD': 'your_database_password',
  7.         'HOST': 'localhost',  # 数据库主机地址,通常是 localhost
  8.         'PORT': '3306',       # MySQL 默认端口
  9.     }
  10. }
复制代码
使用 PostgreSQL

如果你使用 PostgreSQL,修改为:
  1. DATABASES = {
  2.     'default': {
  3.         'ENGINE': 'django.db.backends.postgresql',
  4.         'NAME': 'your_database_name',
  5.         'USER': 'your_database_user',
  6.         'PASSWORD': 'your_database_password',
  7.         'HOST': 'localhost',  # 数据库主机地址,通常是 localhost
  8.         'PORT': '5432',       # PostgreSQL 默认端口
  9.     }
  10. }
复制代码

5. 创建 Django 应用

在项目目录中创建一个新的 Django 应用:
  1. python manage.py startapp myapp
复制代码
应用结构

创建后,应用的结构如下:
  1. myapp/
  2.     migrations/         # 数据库迁移文件目录
  3.         __init__.py
  4.     __init__.py         # 包标识
  5.     admin.py            # 管理后台配置
  6.     apps.py             # 应用配置
  7.     models.py           # 数据模型定义
  8.     tests.py            # 单元测试
  9.     views.py            # 视图函数
复制代码

6. 配置应用

打开 myproject/myproject/settings.py,在 INSTALLED_APPS 中添加你的新应用:
  1. INSTALLED_APPS = [
  2.     # Django 自带的应用
  3.     'django.contrib.admin',
  4.     'django.contrib.auth',
  5.     'django.contrib.contenttypes',
  6.     'django.contrib.sessions',
  7.     'django.contrib.messages',
  8.     'django.contrib.staticfiles',
  9.     # 你的应用
  10.     'myapp',
  11. ]
复制代码

7. 创建模型并天生数据库表

在 myapp/models.py 中定义数据模型。例如:
  1. from django.db import models
  2. class Lesson(models.Model):
  3.     id = models.CharField(max_length=20, primary_key=True)
  4.     name = models.CharField(max_length=50)
  5.     def __str__(self):
  6.         return self.name
复制代码
天生迁移文件

运行以下命令天生迁移文件:
  1. python manage.py makemigrations
复制代码
Django 会检测到模型更改并天生迁移文件,例如:
  1. Migrations for 'myapp':
  2.   myapp/migrations/0001_initial.py
  3.     - Create model Lesson
复制代码
应用迁移文件

运行以下命令将迁移文件应用到数据库,天生表结构:
  1. python manage.py migrate
复制代码

8. 运行开发服务器

使用以下命令启动 Django 开发服务器:
  1. python manage.py runserver
复制代码
打开浏览器访问 http://127.0.0.1:8000/ 以查看项目是否正常运行。

9. 添加管理后台支持

如果需要通过 Django 的管理后台管理数据库,可以为模型添加管理支持。
注册模型

打开 myapp/admin.py,注册模型:
  1. from django.contrib import admin
  2. from .models import Lesson
  3. admin.site.register(Lesson)
复制代码
创建超级用户

运行以下命令创建管理员账户:
  1. python manage.py createsuperuser
复制代码
按照提示输入用户名、邮箱和密码。
访问管理后台

启动开发服务器后,访问 http://127.0.0.1:8000/admin,使用管理员账户登录即可管理数据库中的数据。

10. 测试操纵数据库

可以通过 manage.py shell 交互式操纵数据库:
  1. python manage.py shell
复制代码
在交互环境中:
  1. from myapp.models import Lesson
  2. # 创建记录
  3. lesson = Lesson.objects.create(id='1', name='Django Basics')
  4. # 查询记录
  5. lesson = Lesson.objects.get(id='1')
  6. print(lesson.name)
  7. # 更新记录
  8. lesson.name = 'Advanced Django'
  9. lesson.save()
  10. # 删除记录
  11. lesson.delete()
复制代码

总结

通过以上步调,你可以从零创建一个 Django 项目,并设置数据库支持。核心流程包括:

  • 安装 Django 和数据库驱动。
  • 配置数据库连接。
  • 创建应用和模型。
  • 天生并应用迁移文件。
  • 运行开发服务器并使用 Django 提供的管理后台。
项目结构解读


env文件夹



  • 概念;env 文件夹是一个 虚拟环境 的文件夹。
  • 什么是虚拟环境?【虚拟环境是 Python 提供的一种工具,用于隔离项目的依靠。它允许你在每个项目中独立安装 Python 包,而不会干扰全局 Python 环境或其他项目的依靠。】
  • 为什么需要虚拟环境?

    • 依靠隔离:每个项目大概需要不同版本的库,如果不使用虚拟环境,大概会导致版本辩说。
    • 防止污染全局环境:全局环境中的库安装大概会影响其他项目的正常运行。

  • env文件夹的作用

    • 环境隔离:当你激活虚拟环境时,所有安装的依靠包(如 Django)都被存储在 env 文件夹中。
    • 存储依靠包:例如,你安装的 Django 和 MySQL 驱动等依靠,都会存储在 env/Lib/site-packages 下。

  • 激活虚拟环境(window)
  1. env\Scripts\activate
复制代码


  • 激活虚拟环境(Linux/Mac)
  1. source env/bin/activate
复制代码


  • 关闭虚拟环境
  1. deactivate
复制代码
项目目录结构以及Django项目开发注意点

  1. myproject/
  2.     manage.py
  3.     myproject/
  4.         __init__.py
  5.         settings.py
  6.         urls.py
  7.         asgi.py
  8.         wsgi.py
  9.     myapp/
  10.         migrations/
  11.         __init__.py
  12.         admin.py
  13.         apps.py
  14.         models.py
  15.         tests.py
  16.         views.py
复制代码
manage.py



  • 概念;manage.py 是 Django 项目的入口点。它是一个命令行工具,允许你管理项目(如运行开发服务器、数据库迁移等)。常见的命令包括:
  • 启动开发服务器
  1. python manage.py runserver
复制代码


  • 创建数据库迁移
  1. python manage.py makemigrations
  2. python manage.py migrate
复制代码


  • 创建超级用户
  1. python manage.py createsuperuser
复制代码
myproject/(同名的文件夹)



  • 概念;这个文件夹是Django项目的配置文件夹,它的名字和项目名一致
  • settings.py:项目的核心配置文件,包括数据库配置、已安装的应用、静态文件路径等。
  • urls.py:项目的 URL 路由配置文件,用于将 URL 路径映射到对应的视图函数。
  • asgi.py:ASGI(异步服务器网关接口)配置,用于支持异步哀求处理。
  • wsgi.py:WSGI(Web服务器网关接口)配置,用于部署 Django 项目到生产环境。
myapp(创建的应用目录)



  • myapp/ 是你创建的应用目录。Django 项目可以包含多个应用,每个应用负责不同的功能模块。
  • 各文件的作用

    • models.py:定义数据模型(数据库表结构)。
    • views.py:处理用户的哀求,并返回响应。
    • admin.py:配置管理后台(Django admin)。
    • apps.py:管理应用的配置信息。
    • migrations/:存储数据库迁移文件,用于跟踪模型的变化。
    • tests.py:定义测试用例,用于自动化测试。
    • init: 标识这是一个Python包; (文件夹可以被 Python 识别为模块)

为什么 myproject 文件夹下有一个和项目同名的文件夹?



  • 这是Django项目默认的目录结构

    • 最外层的 myproject/ 是项目的根目录,存放项目入口点 manage.py 和其他项目相关的文件。
    • 内层的 myproject/ 是项目的 配置文件夹,存放项目的配置(如 settings.py、urls.py 等)。

  • 如许设计的目的

    • Django 如许设计的原因是为了方便管理项目的全局文件和应用文件。分开这两层结构,可以更清楚地域分项目的配置文件和其他文件。

修改项目名称会影响哪些地方?



  • 如果你需要修改项目名称,内层文件夹(myproject)中的配置文件需要同步更新。例如:

    • asgi.py 和 wsgi.py 中引用的模块路径需要修改。
    • 项目运行时的模块路径也需要更新。

如何添加更多的应用到项目中?



  • Django 支持模块化的开发,可以为项目添加多个应用,每个应用负责不同的功能。
  • 创建新的应用;使用startapp命令创建新应用;例如
  1. python manage.py startapp blog
复制代码



    • 注册应用;将新应用注册到项目的 INSTALLED_APPS 中:

  1. # settings.py
  2. INSTALLED_APPS = [
  3.     # 默认应用
  4.     'django.contrib.admin',
  5.     'django.contrib.auth',
  6.     'django.contrib.contenttypes',
  7.     'django.contrib.sessions',
  8.     'django.contrib.messages',
  9.     'django.contrib.staticfiles',
  10.     # 你的自定义应用
  11.     'myapp',
  12.     'blog',
  13. ]
复制代码



    • 添加URL路由;为新应用配置URL,例如,在新应用blog中创建urls.py

  1. # blog/urls.py
  2. from django.urls import path
  3. from . import views
  4. urlpatterns = [
  5.     path('', views.index, name='index'),  # 主页
  6. ]
复制代码



    • 在项目的urls.py中包含这个应用的URL;

  1. # myproject/urls.py
  2. from django.contrib import admin
  3. from django.urls import path, include
  4. urlpatterns = [
  5.     path('admin/', admin.site.urls),
  6.     path('blog/', include('blog.urls')),  # 包含 blog 的路由
  7. ]
复制代码
项目结构总结



  • env 文件夹:是虚拟环境的文件夹,用于隔离项目依靠。
  • 项目结构:

    • 外层 myproject/ 是根目录,存放入口文件(如 manage.py)。
    • 内层 myproject/ 是项目的配置文件夹,存放 settings.py 等配置。
    • myapp/ 是一个应用目录,你可以创建多个应用,每个应用负责不同的功能模块。

  • 模块化开发:

    • Django 项目可以包含多个应用,通过 startapp 命令创建新应用,并通过 INSTALLED_APPS 注册到项目中。


免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

泉缘泉

金牌会员
这个人很懒什么都没写!

标签云

快速回复 返回顶部 返回列表