首页
/ 正文

Django 视图（手把手讲解）

更新时间: 2025-04-16 08:41:53

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

前言

在 Django 开发中，"视图（View）" 是连接用户请求、业务逻辑与数据展示的核心组件。它如同一座桥梁，将前端页面的请求转化为后端的处理逻辑，再将处理结果返回给用户。对于编程初学者而言，理解视图的工作原理和实现方式，是掌握 Django 框架的关键一步；而对中级开发者来说，深入视图的高级用法（如类视图、API 视图）则能显著提升开发效率与代码质量。本文将通过循序渐进的方式，结合实例代码，系统解析 Django 视图的实现原理与应用场景。

一、视图的基本概念与核心作用

1.1 视图的定义与功能

视图是 Django 中用于处理 HTTP 请求（如 GET、POST）并返回 HTTP 响应的 Python 函数或类。其核心职责包括：

接收请求：捕获用户发起的 URL 请求
处理逻辑：执行数据库查询、数据验证、业务计算等操作
返回响应：生成 HTML 页面、JSON 数据或其他格式的响应内容

形象比喻：
可以将视图想象为快递分拣中心。用户请求如同包裹，视图根据包裹上的地址标签（URL 路由）判断如何处理：有的需要直接派送（渲染模板），有的需要拆包检查（验证数据），有的需要与其他包裹合并（调用多个模型方法）。最终，视图将处理好的包裹（响应内容）送回给用户。

1.2 视图与 URL 的协作关系

视图需要通过 URL 配置文件（urls.py）与前端页面关联。Django 使用 URL路由系统 将用户访问的路径映射到对应的视图函数/类。这种设计遵循了 MVC（Model-View-Controller）模式中的控制器（Controller）思想。

代码示例：

from django.urls import path
from .views import home_view, article_detail

urlpatterns = [
    path('', home_view, name='home'),          # 函数视图
    path('articles/<int:id>/', article_detail, name='article-detail'),  # 带参数的 URL
]

二、函数视图（Function-Based Views）的实现与优化

2.1 函数视图的语法结构

函数视图是最基础的实现方式，其典型结构如下：

from django.http import HttpResponse

def home_view(request):
    # 处理逻辑（如查询数据库）
    articles = Article.objects.all()
    
    # 返回响应
    return HttpResponse("欢迎访问首页！")

2.1.1 请求对象（request）的解析

request 对象封装了用户的 HTTP 请求信息，包含以下常用属性：
| 属性名 | 作用说明 |
|-----------------|------------------------------|
| request.method | 获取请求方法（如 GET/POST） |
| request.GET | 获取 GET 请求的查询参数 |
| request.POST | 获取 POST 请求的表单数据 |
| request.FILES | 处理文件上传的文件对象列表 |

实践技巧：

def contact_view(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        message = request.POST.get('message')
        # 执行发送邮件逻辑...
        return HttpResponse("感谢您的留言！")
    else:
        return HttpResponse("请使用 POST 方法提交表单")

2.2 模板渲染与上下文传递

通过 render 函数可以将数据传递给 HTML 模板：

from django.shortcuts import render

def article_list(request):
    articles = Article.objects.order_by('-created_at')
    return render(request, 'articles/list.html', {
        'article_list': articles,
        'current_user': request.user
    })

模板文件（list.html）片段示例：

<ul>
    {% for article in article_list %}
    <li>{{ article.title }} - {{ article.author }}</li>
    {% endfor %}
</ul>

2.3 函数视图的局限性

代码复用性差：相同逻辑需在多个视图中重复编写
状态管理困难：难以通过类属性保存中间状态
可维护性低：复杂逻辑可能导致函数体积膨胀

三、类视图（Class-Based Views）的进阶用法

3.1 类视图的核心优势

Django 的类视图（CBV）通过继承基类（如 View）实现功能扩展，具有以下优点：

代码复用：通过方法覆盖（Override）和多重继承实现功能扩展
职责分离：将 HTTP 方法（GET/POST）与业务逻辑分离
生命周期管理：提供 setup()、dispatch() 等钩子方法

3.2 基础类视图的使用

from django.views import View
from django.http import HttpResponse

class ArticleListView(View):
    def get(self, request):
        articles = Article.objects.all()
        return HttpResponse("文章列表页")
    
    def post(self, request):
        return HttpResponse("不支持 POST 请求", status=405)

3.2.1 常用基类与应用场景

基类名称	主要用途
`View`	基础类，提供通用功能
`TemplateView`	渲染预定义模板（无需编写 get 方法）
`ListView`	分页展示模型列表
`DetailView`	显示单个模型实例的详细信息
`FormView`	处理表单提交流程

实践案例：

from django.views.generic import TemplateView

class AboutView(TemplateView):
    template_name = 'about.html'  # 直接指定模板路径

3.3 通用视图（Generic Views）的高级技巧

3.3.1 列表视图（ListView）

from django.views.generic import ListView
from .models import Article

class ArticleListView(ListView):
    model = Article          # 指定数据模型
    template_name = 'articles/list.html'
    context_object_name = 'articles'  # 自定义上下文变量名
    paginate_by = 10         # 启用分页，每页10条

3.3.2 细节视图（DetailView）

from django.views.generic import DetailView

class ArticleDetailView(DetailView):
    model = Article
    template_name = 'articles/detail.html'
    pk_url_kwarg = 'article_id'  # 指定 URL 参数名

四、API 视图与 RESTful 接口开发

4.1 API 视图的核心概念

当需要构建 RESTful API 时，Django 的 APIView 类（来自 rest_framework.views）提供了以下特性：

自动处理内容协商（Content Negotiation）
集成认证、权限和节流控制
支持序列化（Serialization）数据格式

类视图结构示例：

from rest_framework.views import APIView
from rest_framework.response import Response

class ArticleListAPIView(APIView):
    def get(self, request):
        articles = Article.objects.all()
        serializer = ArticleSerializer(articles, many=True)
        return Response(serializer.data)
    
    def post(self, request):
        serializer = ArticleSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data, status=201)
        return Response(serializer.errors, status=400)

4.2 基于 Mixins 的组合式开发

Django REST Framework 提供了 ListModelMixin、CreateModelMixin 等混合类，通过多重继承快速构建 API：

from rest_framework import generics
from .models import Article
from .serializers import ArticleSerializer

class ArticleList(generics.GenericAPIView,
                  mixins.ListModelMixin,
                  mixins.CreateModelMixin):
    queryset = Article.objects.all()
    serializer_class = ArticleSerializer
    
    def get(self, request, *args, **kwargs):
        return self.list(request, *args, **kwargs)
    
    def post(self, request, *args, **kwargs):
        return self.create(request, *args, **kwargs)

五、实战案例：博客系统的视图开发

5.1 项目结构与模型设计

from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    author = models.ForeignKey('auth.User', on_delete=models.CASCADE)

5.2 视图实现（类视图 + 模板渲染）

from django.views.generic import ListView, DetailView
from .models import Article

class ArticleList(ListView):
    model = Article
    template_name = 'blog/article_list.html'
    ordering = ['-created_at']
    
    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context['recent_articles'] = Article.objects.order_by('-created_at')[:5]
        return context

class ArticleDetail(DetailView):
    model = Article
    template_name = 'blog/article_detail.html'
    
    def get_object(self):
        obj = super().get_object()
        obj.view_count += 1
        obj.save()
        return obj

5.3 URL 配置与模板集成

from django.urls import path
from .views import ArticleList, ArticleDetail

urlpatterns = [
    path('articles/', ArticleList.as_view(), name='article-list'),
    path('articles/<int:pk>/', ArticleDetail.as_view(), name='article-detail'),
]

六、视图开发的优化与常见陷阱

6.1 性能优化技巧

数据库查询优化：使用 select_related() 和 prefetch_related() 减少 N+1 查询
缓存策略：对高频访问页面使用 Django 缓存中间件
异步处理：对耗时操作（如发送邮件）使用 Celery 异步任务

6.2 常见错误与解决方案

错误类型	产生原因与解决方法
`NoReverseMatch`	URL 名称拼写错误，需检查 `name` 参数
`AttributeError`	模型字段未定义或视图未正确导入
`TemplateDoesNotExist`	模板路径配置错误，需检查文件位置

结论

Django 视图作为 Web 应用的逻辑中枢，其设计与实现直接影响系统的可维护性和扩展性。从基础的函数视图到高级的类视图与 API 开发，开发者需要根据项目需求选择最合适的实现方式。通过本文的案例解析与代码示例，读者应能掌握视图的核心原理，并在实际开发中灵活运用。建议在后续学习中深入探索 Django REST Framework 的进阶功能，并结合项目实践持续优化代码结构。

Django 视图（手把手讲解）

前言

一、视图的基本概念与核心作用

1.1 视图的定义与功能

1.2 视图与 URL 的协作关系

二、函数视图（Function-Based Views）的实现与优化

2.1 函数视图的语法结构

2.1.1 请求对象（request）的解析

2.2 模板渲染与上下文传递

2.3 函数视图的局限性

三、类视图（Class-Based Views）的进阶用法

3.1 类视图的核心优势

3.2 基础类视图的使用

3.2.1 常用基类与应用场景

3.3 通用视图（Generic Views）的高级技巧

四、API 视图与 RESTful 接口开发

4.1 API 视图的核心概念

4.2 基于 Mixins 的组合式开发

五、实战案例：博客系统的视图开发

5.1 项目结构与模型设计

5.2 视图实现（类视图 + 模板渲染）

5.3 URL 配置与模板集成

六、视图开发的优化与常见陷阱

6.1 性能优化技巧

6.2 常见错误与解决方案

结论

最新发布

Python Set symmetric_difference_update() 方法（千字长文）

Python Set union() 方法（一文讲透）

Python Set update() 方法（一文讲透）

Python3 input() 函数（长文讲解）

Linux updatedb 命令（手把手讲解）

HTML DOM nextElementSibling 属性（建议收藏）

HTML DOM previousElementSibling 属性（一文讲透）

HTML DOM children 属性（建议收藏）

NumPy 教程（一文讲透）

NumPy 安装（超详细）