Django 是一个开源的 Python Web 框架,它可以帮助开发者快速构建高性能、安全的 Web 应用。以下是 Django 的基本使用方法:

1. 安装 Django

在使用 Django 之前,需要先安装它。可以通过 pip 命令安装:

1
pip install django

2. 创建项目

使用 Django 提供的 django-admin 命令创建一个新的项目。在终端中运行以下命令:

1
django-admin startproject myproject

这会创建一个名为 myproject 的文件夹,其中包含项目的初始结构。

3. 项目结构

一个典型的 Django 项目结构如下:

1
2
3
4
5
6
7
8
9
10
11
myproject/

├── myproject/ # 项目配置文件夹
│ ├── __init__.py
│ ├── settings.py # 项目配置文件
│ ├── urls.py # 项目的 URL 配置
│ ├── asgi.py
│ └── wsgi.py

├── manage.py # 用于管理项目的命令行工具
└── db.sqlite3 # 默认数据库文件

4. 创建应用

在 Django 中,一个应用是一个独立的模块,用于实现特定的功能。可以通过以下命令创建应用:

1
python manage.py startapp myapp

这会在项目目录下创建一个名为 myapp 的文件夹,其中包含应用的初始结构。

5. 应用结构

一个典型的 Django 应用结构如下:

1
2
3
4
5
6
7
8
9
10
myapp/

├── __init__.py
├── admin.py # 管理后台配置
├── apps.py # 应用配置
├── migrations/ # 数据库迁移文件
│ └── __init__.py
├── models.py # 数据模型定义
├── tests.py # 测试用例
└── views.py # 视图函数

6. 定义模型

models.py 文件中定义数据模型。例如,定义一个用户模型:

1
2
3
4
5
6
7
8
9
from django.db import models

class User(models.Model):
username = models.CharField(max_length=100)
email = models.EmailField()
password = models.CharField(max_length=100)

def __str__(self):
return self.username

7. 数据库迁移

定义好模型后,需要将模型映射到数据库中。运行以下命令生成迁移文件并应用迁移:

1
2
python manage.py makemigrations
python manage.py migrate

8. 创建视图

views.py 文件中定义视图函数。例如,创建一个简单的视图:

1
2
3
4
from django.http import HttpResponse

def home(request):
return HttpResponse("Hello, Django!")

9. 配置 URL

在应用的 urls.py 文件中定义 URL 路由。例如:

1
2
3
4
5
6
from django.urls import path
from . import views

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

然后在项目的 urls.py 文件中包含应用的 URL 配置:

1
2
3
4
5
6
7
from django.contrib import admin
from django.urls import path, include

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

10. 启动开发服务器

运行以下命令启动 Django 开发服务器:

1
python manage.py runserver

访问浏览器中的 http://127.0.0.1:8000/,即可看到应用的页面。

11. 其他功能

  • 模板:使用 Django 的模板系统渲染 HTML 页面。
  • 表单:使用 Django 的表单类处理用户输入。
  • 用户认证:使用 Django 内置的用户认证系统实现登录、注册等功能。
  • 静态文件:管理静态文件(如 CSS、JavaScript、图片)。

示例代码

以下是一个完整的示例代码,展示如何创建一个简单的 Django 应用:

项目结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
myproject/

├── myproject/
│ ├── __init__.py
│ ├── settings.py
│ ├── urls.py
│ ├── asgi.py
│ └── wsgi.py

├── myapp/
│ ├── __init__.py
│ ├── admin.py
│ ├── apps.py
│ ├── migrations/
│ │ └── __init__.py
│ ├── models.py
│ ├── tests.py
│ ├── views.py
│ └── urls.py

├── manage.py
└── db.sqlite3

myapp/models.py

1
2
3
4
5
6
7
8
9
from django.db import models

class User(models.Model):
username = models.CharField(max_length=100)
email = models.EmailField()
password = models.CharField(max_length=100)

def __str__(self):
return self.username

myapp/views.py

1
2
3
4
from django.http import HttpResponse

def home(request):
return HttpResponse("Hello, Django!")

myapp/urls.py

1
2
3
4
5
6
from django.urls import path
from . import views

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

myproject/urls.py

1
2
3
4
5
6
7
from django.contrib import admin
from django.urls import path, include

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

通过以上步骤,你可以快速搭建一个简单的 Django 应用。随着学习的深入,你可以探索更多高级功能,如中间件、信号、自定义管理命令等。