创建Django项目

2023-11-18 后端开发后端开发 Web开发项目创建

Django是一个强大的Python Web框架，它鼓励快速开发和简洁实用的设计。本文将指导您从零开始创建一个Django项目。

环境准备

在开始之前，确保您已经安装了Python（推荐3.8或更高版本）。您可以通过以下命令检查Python版本：

1
python --version

创建虚拟环境

为了避免依赖冲突，建议为每个Django项目创建独立的虚拟环境：

1
2
3
4
5
6
7
8
# 创建名为venv的虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows
venv\Scripts\activate
# Linux/Mac
# source venv/bin/activate

安装Django

激活虚拟环境后，安装Django：

1
pip install django

您可以通过以下命令验证Django是否安装成功：

1
python -m django --version

创建项目

使用Django的 startproject 命令创建一个新项目：

1
django-admin startproject myproject

这将创建一个名为 myproject 的目录，其结构如下：

1
2
3
4
5
6
7
8
myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

目录结构说明

manage.py : 一个命令行工具，可以让您以各种方式与Django项目交互
myproject/ : 项目的实际Python包
- __init__.py : 空文件，告诉Python这个目录应该被视为一个Python包
- settings.py : 项目的配置文件
- urls.py : 项目的URL声明
- asgi.py : ASGI兼容的Web服务器入口
- wsgi.py : WSGI兼容的Web服务器入口

创建应用

Django项目由一个或多个应用组成。例如创建一个名为 blog 的应用：

1
2
cd myproject
python manage.py startapp blog

这将创建一个名为 blog 的目录，其结构如下：

1
2
3
4
5
6
7
8
9
blog/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

注册应用

在 settings.py 中注册新创建的应用：

1
2
3
4
5
6
7
8
9
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',  # 添加这一行
]

创建视图

在 blog/views.py 中创建一个简单的视图：

1
2
3
4
from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, world. You're at the blog index.")

配置URL

在 blog 目录中创建一个名为 urls.py 的文件：

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

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

在项目的 urls.py 中包含应用的URLs：

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

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

测试

在终端中运行以下命令来启动开发服务器：

1
python manage.py runserver

现在，您可以访问 http://127.0.0.1:8000/blog/ 查看您创建的视图。

参考资料

Django官方文档
Django Girls教程
Django REST framework