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
- 在 blog 目录中创建一个名为
urls.py
的文件:
python
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
]
- 在项目的
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/
查看您创建的视图。
参考资料
- Django官方文档
- Django Girls教程
- Django REST framework