目录

  1. 项目简介
  2. 安装 Django
  3. 创建 Django 项目
  4. 创建第一个视图
  5. 配置 URL 路由
  6. 运行开发服务器
  7. 总结与下一步
  8. 参考资料

1. 项目简介

在本教程中,我们将创建一个简单的 Django 项目,该项目将在网页中显示一条消息,并展示 Django 的基本功能。通过这个项目,你将学到如何创建 Django 项目、视图、URL 路由以及运行开发服务器。


2. 安装 Django

首先,需要在你的计算机上安装 Django。以下是安装步骤:

2.1 创建虚拟环境(推荐)

虚拟环境有助于隔离项目的依赖关系。使用以下命令创建一个虚拟环境:

  • Windowspython -m venv venv
  • macOS / Linuxpython3 -m venv venv

2.2 激活虚拟环境

  • Windowsvenv\Scripts\activate
  • macOS / Linuxsource venv/bin/activate

2.3 安装 Django

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

pip install django


3. 创建 Django 项目

安装完 Django 后,我们可以使用 django-admin 命令创建一个新的 Django 项目。

3.1 创建项目

在命令行中,运行以下命令来创建一个名为 myproject 的新 Django 项目:

django-admin startproject myproject

这将创建一个名为 myproject 的目录,并在其中生成以下文件结构:

myproject/
│── manage.py          # 项目管理文件
│── myproject/         # 主项目目录
│   ├── __init__.py
│   ├── settings.py    # 项目配置
│   ├── urls.py        # 路由配置
│   ├── asgi.py
│   └── wsgi.py

3.2 进入项目目录

进入 myproject 目录:

cd myproject


4. 创建第一个视图

视图是处理请求并返回响应的地方。在 Django 中,视图通常返回一个 HTML 页面或其他类型的数据。

4.1 创建视图文件

在项目的 myproject/views.py 文件中,定义一个简单的视图函数,该函数返回一条文本信息。

# myproject/views.py

from django.http import HttpResponse

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

该视图函数将返回一个包含 “Hello, Django!” 的 HTTP 响应。


5. 配置 URL 路由

Django 使用 URL 路由将请求与视图关联起来。你需要在项目的 urls.py 文件中配置 URL 路由。

5.1 编辑 URL 路由

打开 myproject/urls.py 文件,将 hello 视图添加到 URL 路由中:

# myproject/urls.py

from django.contrib import admin
from django.urls import path
from .views import hello  # 导入视图函数

urlpatterns = [
    path('admin/', admin.site.urls),
    path('hello/', hello),  # 配置路由
]

这将把访问 http://127.0.0.1:8000/hello/ 的请求转发到 hello 视图。


6. 运行开发服务器

一切准备好后,你可以启动 Django 的开发服务器,以便在本地浏览器中查看应用程序。

6.1 运行服务器

在命令行中运行以下命令启动服务器:

python manage.py runserver

或者,如果你使用的是 macOS/Linux 系统,可以使用:

python3 manage.py runserver

6.2 访问应用

在浏览器中访问 http://127.0.0.1:8000/hello/,你应该看到页面显示 “Hello, Django!”。


7. 总结与下一步

通过本教程,你已经成功创建了一个简单的 Django 项目,并学会了如何:

  • 创建 Django 项目
  • 创建视图和 URL 路由
  • 运行开发服务器

下一步

  • 学习 Django ORM 和数据库操作,了解如何使用模型和数据库交互。
  • 学习 Django 模板系统,如何渲染动态 HTML 页面。
  • 深入学习 Django 表单和用户认证功能。

8. 参考资料

出站链接

站内链接