从零到一：Django Web 开发全流程实战（保姆级图文教程）

本文严格跟随Django 6.0 官方中文文档（https://docs.djangoproject.com/zh-hans/6.0/intro/） 步骤操作，从环境验证到第一个应用落地，全程适配官方规范，零基础也能精准同步，和官方教程无缝衔接。

前置条件：确认 Django 已安装并验证版本

安装

官方教程默认已安装 Python 和 Django，先执行命令验证环境（Windows/macOS/Linux 通用，CMD / 终端执行）：

python -m django --version

• 若输出6.0.x（x 为小版本号），说明环境符合官方要求，可直接开始；
• 若提示 “找不到命令”，需先按官方要求安装 Django：pip install django==6.0（指定 6.0 版，和官方文档一致）；
• 若版本低于 6.0，执行pip install --upgrade django==6.0升级。

第一步：创建 Django 项目（官方标准命令）

官方将这一步定义为 “创建项目骨架”，不要在 Python 安装目录、系统盘根目录创建，选择自己的工作目录（如Desktop/Django_Project），执行以下命令：
django-admin startproject mysite

官方项目结构解读（和文档完全一致）

执行命令后会生成mysite根目录，内部结构如下，官方对每个文件的定义为：

mysite/ ├── manage.py # 项目管理工具，官方所有操作都基于此文件 └── mysite/ # 项目核心配置包 ├── __init__.py # 空文件，标识这是Python包 ├── asgi.py # 适配ASGI协议，用于生产环境异步部署 ├── settings.py # 项目全局配置文件（官方后续重点修改） ├── urls.py # 项目主路由配置（URL调度器） └── wsgi.py # 适配WSGI协议，用于生产环境同步部署

第二步：启动开发服务器（官方默认配置）

这是官方验证项目创建成功的核心步骤，全程按文档指令操作：

1. 进入项目根目录

# 必须进入外层mysite目录（包含manage.py的目录） cd mysite

2. 启动官方默认开发服务器

# 官方标准命令，无额外参数 python manage.py runserver

3. 验证启动结果

执行后终端会输出类似以下内容，说明启动成功：

Watching for file changes with StatReloader Performing system checks... System check identified no issues (0 silenced). June 01, 2024 - 12:00:00 Django version 6.0, using settings 'mysite.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.

打开浏览器访问http://127.0.0.1:8000/，看到 Django 官方默认的 “火箭” 欢迎页，即完成此步骤（和官方文档截图一致）。

第三步：创建第一个应用（官方 polls 示例）

Django 中项目是全局配置集合，应用是具体功能模块（如投票、博客），官方以polls（投票应用）为示例，这是后续所有操作的核心载体。

1. 执行官方创建应用命令

必须在包含 manage.py 的项目根目录执行，命令和官方完全一致：

# 官方标准命令：python manage.py startapp 应用名 python manage.py startapp polls

2. 官方应用结构解读

生成的polls目录结构如下，官方后续会逐步修改这些文件：

polls/ ├── __init__.py ├── admin.py # 后台管理配置（官方后续配置模型后台） ├── apps.py # 应用配置文件 ├── migrations/ # 数据库迁移文件目录（官方后续核心操作） │ └── __init__.py ├── models.py # 数据模型定义（Django核心，官方重点） ├── tests.py # 测试用例编写 ├── urls.py # 应用路由配置（需手动创建，官方后续说明） └── views.py # 视图函数/类（处理请求，官方第一个编写）

第四步：编写第一个视图（官方最小化示例）

按官方文档，先从views.py入手，编写 Django 最基础的视图，严格跟随官方代码：

1. 修改 polls/views.py

写入官方提供的最小化视图代码，实现 “请求 - 响应” 基础逻辑：

# polls/views.py from django.http import HttpResponse # 官方第一个视图函数：index def index(request): return HttpResponse("Hello, world. You're at the polls index.")

2. 为应用配置 URLconf（官方两步法）

Django 通过路由匹配视图，官方要求为应用创建独立的urls.py，再挂载到项目主路由，步骤和代码完全同步：

步骤 1：在 polls 目录下手动创建urls.py（官方提示需手动创建）

写入官方路由配置代码：

# polls/urls.py from django.urls import path from . import views # 导入当前应用的views # 官方URL模式列表，name参数为路由命名（官方后续会用到） urlpatterns = [ path("", views.index, name="index"), ]

步骤 2：将应用路由挂载到项目主路由（mysite/urls.py）

修改项目根目录的mysite/urls.py，按官方要求导入include模块，添加 polls 路由：

# mysite/urls.py from django.contrib import admin from django.urls import include, path # 官方要求导入include # 官方主路由配置，新增polls/路径匹配 urlpatterns = [ path('polls/', include('polls.urls')), # 挂载polls应用路由 path('admin/', admin.site.urls), # 官方默认后台管理路由 ]

3. 验证第一个视图（官方验证方式）

确保开发服务器已启动（若已关闭，重新执行python manage.py runserver），浏览器访问：http://127.0.0.1:8000/polls/页面显示Hello, world. You're at the polls index.，即和官方文档步骤完全同步，完成第一个视图的编写与访问。