搜索菜单
当前位置: 首页 > python编程入门自学 > Python Django新手指南：怎么快速构建动态网站

Python Django新手指南：怎么快速构建动态网站

落日邮差
落日邮差
发布时间：2026-11-13 | 4人浏览过
原创

本指南面向初学者，系统拆解如何使用Python Django框架快速构建一个动态网站。从开发环境初始化、MTV核心架构解析、模型与数据库交互，到动态视图编写与模板渲染，提供完整步骤、代码示例及常见报错排查方案。

一、环境准备与项目工程初始化

快速搭建动态网站的第一原则是保持依赖隔离。在全局 Python 环境中直接安装包容易导致版本冲突，因此规范的做法是为每个 Django 项目单独建立虚拟环境。

创建虚拟环境后，通过包管理器安装 Django，并使用 Django 提供的管理命令生成骨架代码。整个初始化过程分为三个明确的终端命令： 

# 1. 创建并激活虚拟环境（macOS/Linux示例）
python3 -m venv venv
source venv/bin/activate

# Windows 激活命令为：venv\Scriptsctivate

# 2. 安装 Django
pip install django

# 3. 创建项目容器与业务应用
django-admin startproject mywebsite .
python manage.py startapp myapp
示例终端命令：创建虚拟环境、项目与业务应用

执行完毕后，目录中会出现两组核心文件夹：mywebsite/ 是主配置目录，存放全站通用的 settings.py 与主路由 urls.py；myapp/ 则是承载具体业务功能的应用目录，包含数据模型 models.py 与逻辑视图 views.py。

关键操作检查点
新创建的应用必须在主配置文件中声明。打开 mywebsite/settings.py，在 INSTALLED_APPS 列表末尾添加 'myapp',。如果遗漏这一步，后续编写的数据模型将无法被 Django 识别并迁移进数据库。
Python Django新手指南：怎么快速构建动态网站
图 1：Django 项目从环境创建到服务启动的4步操作流程与产物对照

二、透彻理解 Django 的 MTV 模式与请求流转

传统桌面程序或简易脚本通常把逻辑和界面混在一起，而动态网站必须拆分职责。许多框架使用 MVC（Model-View-Controller），而在 Django 中，这一架构被命名为 MTV 模式：

  • Model（模型）：业务数据的结构定义者。你不需要手动编写 SQL 建表语句，只需要在 models.py 中用 Python 类描述字段类型，Django ORM 会自动将其翻译为底层数据库操作。
  • Template（模板）：呈现给用户的 HTML 页面骨架。模板包含静态的 HTML 标签，以及用于填充变量或执行循环的 DTL（Django Template Language）插值语法。
  • View（视图）：承上启下的调度枢纽。视图接收用户的 HTTP 请求，根据需要调用 Model 查取或保存数据，然后把数据打包装入上下文（Context），交给 Template 进行渲染，并最终生成 HttpResponse 返回给浏览器。
Python Django新手指南：怎么快速构建动态网站
图 2：Django 从 URL 路由、视图调度、ORM 取数到模板渲染输出的完整流转流程

三、实战：四步跑通一个最小动态应用

理论清晰后，我们以构建一个“文章动态列表与详情”为例，演示如何通过四个紧密衔接的步骤，实现真正的动态网页渲染。

步骤 1：在 models.py 中定义数据模型并迁移

打开 myapp/models.py，编写代表文章的类。该类继承自 models.Model： 

from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=100, verbose_name="文章标题")
    content = models.TextField(verbose_name="正文内容")
    created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")

    def __str__(self):
        return self.title
代码文件：myapp/models.py

定义完数据模型后，必须在终端执行迁移命令，把 Python 代码同步到底层 SQLite 数据库： 

python manage.py makemigrations myapp
python manage.py migrate

步骤 2：在 views.py 中编写业务逻辑与数据查询

打开 myapp/views.py，引入刚才建立的 Article 模型。我们查询所有文章，并传递给 HTML 模板： 

from django.shortcuts import render
from .models import Article

def article_list(request):
    # 1. 通过 ORM 提取所有按时间倒序排列的数据
    articles = Article.objects.all().order_by('-created_at')
    
    # 2. 将数据装入 context 字典
    context = {
        'article_list': articles,
        'page_title': '最新动态文章'
    }
    
    # 3. 渲染指定模板并返回响应
    return render(request, 'myapp/article_list.html', context)
代码文件：myapp/views.py

步骤 3：在 templates 中编写动态 HTML 页面

在 myapp/ 目录下新建目录结构 templates/myapp/，并在其中创建 article_list.html。 这里使用双大括号 {{ 变量 }} 输出具体值，使用 {% 标签 %} 进行流程控制： 

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>{{ page_title }}</title>
    <style>
        body { font-family: sans-serif; padding: 20px; }
        .card { border-bottom: 1px solid #ccc; margin-bottom: 15px; padding-bottom: 10px; }
    </style>
</head>
<body>
    <h1>{{ page_title }}</h1>

    {% if article_list %}
        {% for article in article_list %}
            <div class="card">
                <h2>{{ article.title }}</h2>
                <p>{{ article.content }}</p>
                <small>发布于：{{ article.created_at|date:"Y-m-d H:i" }}</small>
            </div>
        {% endfor %}
    {% else %}
        <p>暂无文章内容，请在后台添加。</p>
    {% endif %}
</body>
</html>
代码文件：myapp/templates/myapp/article_list.html

步骤 4：配置 URLconf 路由规则

有了视图和模板，还需要告诉 Django 用户访问什么网址时调用该视图。首先在 myapp/ 中创建 urls.py： 

from django.urls import path
from . import views

urlpatterns = [
    path('articles/', views.article_list, name='article_list'),
]
代码文件：myapp/urls.py

随后打开根路由文件 mywebsite/urls.py，使用 include 将应用路由引入主路由树： 

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('myapp.urls')),  # 将根路径分发到应用路由
]
代码文件：mywebsite/urls.py
Python Django新手指南：怎么快速构建动态网站
图 3：数据模型实例从 QuerySet 装入 Context，最终由 DTL 引擎编译为纯 HTML 节点的绑定全过程

四、处理用户输入与表单安全交互

单纯展示数据只是动态网站的一半功能，另一半是安全接收用户提交的数据并更新存储。

在 Web 开发中，提交数据通常使用 HTTP POST 方法。Django 提供了内置的跨站请求伪造（CSRF）防护机制。任何向服务器提交 POST 请求的表单，都必须嵌入 {% csrf_token %} 标签。 

# 接收表单并保存文章的视图示例 (myapp/views.py)
from django.shortcuts import render, redirect
from .models import Article

def create_article(request):
    if request.method == 'POST':
        # 提取 POST 表单字段数据
        title = request.POST.get('title')
        content = request.POST.get('content')
        
        # 简单校验并保存到数据库
        if title and content:
            Article.objects.create(title=title, content=content)
            return redirect('article_list')  # 创建成功后重定向到列表页
            
    return render(request, 'myapp/article_form.html')
代码文件：myapp/views.py (POST 请求处理)

与之对应的前端表单结构如下： 

<!-- 表单模板 myapp/templates/myapp/article_form.html -->
<form method="POST" action="">
    {% csrf_token %}
    <div>
        <label for="title">标题：</label>
        <input type="text" id="title" name="title" required>
    </div>
    <div>
        <label for="content">内容：</label>
        <textarea id="content" name="content" required></textarea>
    </div>
    <button type="submit">立即提交</button>
</form>
代码文件：myapp/templates/myapp/article_form.html
安全提示：CSRF Token 的作用机制
当页面渲染时，{% csrf_token %} 会生成一个隐藏的 <input type="hidden" name="csrfmiddlewaretoken" value="...">。当表单提交时，Django 中间件会自动验证该令牌是否与用户会话匹配，从而杜绝第三方恶意站点伪造用户请求进行恶意数据注入。

五、新手高频报错排查与全景自查矩阵

初学者在构建 Django 应用时，往往会遇到几个非常典型的阻碍。理清这些报错的原因能够帮助你快速定位问题：

  1. TemplateDoesNotExist 错误： 这是最常见的报错之一。出现该提示意味着 Django 在各个应用的 templates/ 目录下未能搜索到指定的模板文件。排查步骤：首先确认 myapp/templates/myapp/filename.html 路径拼写是否完全一致；其次确认 myapp 是否已经在 settings.py 的 INSTALLED_APPS 中注册。
  2. 模型修改后未生效或报错 no such table： 定义了新模型或修改了已有字段后，如果直接启动服务查询，底层数据库并未生成对应表结构。必须先后运行 python manage.py makemigrations（生成迁移描述脚本）和 python manage.py migrate（真正执行 DDL 语句更改数据库结构）。
  3. NoReverseMatch 错误： 在模板中使用 {% url 'name' %} 或在视图中使用 reverse('name') 时，如果提供的别名在任何 urls.py 的 path(..., name='...') 中不存在，或者遗漏了必要的路径参数（例如动态 ID），Django 会直接终止渲染并抛出此异常。
Python Django新手指南：怎么快速构建动态网站
图 4：Django 快速构建动态网站核心全貌：职权、命令、排错与演进矩阵

相关文章

相关专题: python编程入门自学 Django教程

本站声明

本文内容仅供参考，不代表本站观点。转载或引用请注明出处。如发现内容问题，请通过联系我们页面反馈。

作者最新文章

全部内容

Python 相关产品和应用

全部下载
python编程入门自学
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。
python编程入门自学
scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。
python编程入门自学
Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。
python编程入门自学
Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。
python编程入门自学
pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。
python编程入门自学 FastAPI教程 API接口是什么意思
FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架，支持类型提示和自动接口文档。
python编程入门自学 Python Flask
Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。
python编程入门自学 Django教程
Django

Django

6.1.2 · Windows

成熟的 Python Web 框架，适合构建内容站点和业务系统。
python编程入门自学
Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。
python编程入门自学
SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。
python编程入门自学 python爬虫教程
pandas

pandas

3.0.6 · Windows

Python 数据分析库，提供 DataFrame 与丰富的数据处理能力。
python编程入门自学
NumPy

NumPy

2.5.4 · Windows

Python 科学计算基础库，提供高性能多维数组与数值运算。

文章分类

专题列表

ipython.cn 学习网
人工智能 Java AI行业服务