从零开始，搭建一个基于 Django 的 Web 项目

news2025/6/7 18:42:15

🎯 主要步骤概述

1️⃣ 安装 Python 和 pip
2️⃣ 创建虚拟环境
3️⃣ 安装 Django
4️⃣ 创建 Django 项目
5️⃣ 运行开发服务器
6️⃣ 创建一个简单的应用（app）
7️⃣ 配置数据库并迁移
8️⃣ 创建超级用户（admin）
9️⃣ 访问后台管理界面
🔟 编写一个简单的视图和路由，验证页面可访问

1️⃣ 安装 Python 和 pip

Django 是基于 Python 的，你需要先安装好 Python（自带 pip）。

Windows/macOS/Linux 都可以去 Python 官网下载最新版 Python 并安装。
安装时勾选 “Add Python to PATH” 选项（重要！）。

验证是否安装成功：

python --version
pip --version

2️⃣ 创建虚拟环境（推荐）

虚拟环境能帮你隔离不同项目依赖，避免冲突。

# 在项目根目录创建虚拟环境（venv 是名字，可以随便起）
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate

# macOS/Linux:
source venv/bin/activate

激活后，命令行前面会出现 (venv)，表示虚拟环境成功启用。

3️⃣ 安装 Django

在虚拟环境中安装 Django：

pip install django

检查版本确认安装成功：

django-admin --version

4️⃣ 创建 Django 项目

Django 项目是个整体容器，包含设置、数据库配置、路由等。

django-admin startproject mysite

这样会在当前目录下创建一个 mysite 文件夹。

5️⃣ 启动开发服务器

进入项目目录：

cd mysite

运行：

python manage.py runserver

在浏览器打开 http://127.0.0.1:8000/，你会看到 Django 的欢迎页面，表示项目运行成功！

6️⃣ 创建应用（app）

Django 项目由一个或多个 app 组成。比如博客功能是一个 app，商城功能是另一个 app。

创建 app：

python manage.py startapp myapp

然后你会看到多了一个 myapp 文件夹，里面有很多文件（views.py、models.py 等）。

7️⃣ 配置数据库并迁移

默认情况下，Django 使用 SQLite 数据库。

先迁移数据库（初始化数据库结构）：

python manage.py migrate

8️⃣ 创建超级用户（后台管理）

Django 自带后台管理界面，非常方便。

python manage.py createsuperuser

按提示输入用户名、邮箱和密码。

运行：

python manage.py runserver

浏览器访问：http://127.0.0.1:8000/admin/
用刚才的超级用户账号登录，即可进入 Django 的后台管理界面。

9️⃣ 简单视图和路由

修改 myapp/views.py 文件：

from django.http import HttpResponse

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

再修改项目的路由配置（mysite/urls.py）：

from django.contrib import admin
from django.urls import path
from myapp.views import home  # 导入刚刚的视图

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', home),  # 根路径访问 home
]

再次访问 http://127.0.0.1:8000/，你会看到 “Hello, Django!”！