Skip to content

创建Django项目

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

环境准备

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

bash
python --version

创建虚拟环境

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

bash
# 创建名为venv的虚拟环境
python -m venv venv

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

安装Django

激活虚拟环境后,安装Django:

bash
pip install django

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

bash
python -m django --version

创建项目

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

bash
django-admin startproject myproject

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

plaintext
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 的应用:

bash
cd myproject
python manage.py startapp blog

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

plaintext
blog/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

注册应用

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

python
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',  # 添加这一行
]

创建视图

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

python
from django.http import HttpResponse

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

配置URL

  1. 在 blog 目录中创建一个名为 urls.py 的文件:
python
from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='index'),
]
  1. 在项目的 urls.py 中包含应用的URLs:
python
from django.contrib import admin
from django.urls import include, path

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

测试

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

bash
python manage.py runserver

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

参考资料

  1. Django官方文档
  2. Django Girls教程
  3. Django REST framework