简介基于Django框架的视频点播网站完整源码包主要面向计算机、数学、电子信息等专业的学生适合用作课程设计、期末大作业或毕业设计参考资料。项目实现了视频播放、收藏、后台管理等核心功能页面与后端逻辑均打包在内下载后可直接配置运行便于对照源码理解Django的MTV开发模式和路由分发机制。资源包共178个文件包含49个Python源码文件、47个HTML页面模板、40个pyc编译文件以及JavaScript脚本、CSS样式表、图片和演示视频等压缩包大小约14.56MB。当前已有125人学习下载。这份源码的价值在于结构清晰视频列表、详情播放、后台编辑、个人中心等典型模块都分别对应独立的模板与视图逻辑样式表与脚本文件也展示了前端界面和交互效果的构建过程。对于希望快速掌握Django项目组织方式、并在此基础上二次开发或完成课程作业的学习者来说是一份便于拆解和参考的完整示例。1. 先别急着装播放器Django 做视频点播到底在做什么把这份源码解压后我第一反应是目录里没有 video.js、没有 ckplayer只有 base.html、index.html、detail.html、profile.html、video_edit.html 和 style.css、semantic.custom.css、admin.css、reset.css、dropload.css。这个结构反而让人放心视频点播网站的核心不在播放器外壳而在 Django 的路由分配、ORM 建表、用户收藏关系、后台管理、静态资源托管这一整套 MTV 流程。它适合做课程设计、期末大作业和毕设底子也适合刚学完 Django 想见完整项目的人。下面我按拆这类源码的顺序把它跑通、讲透并指出哪些地方容易被当成“现成功能”而忽略。2. 项目骨架与数据模型URL 路由、Video 表和 Favorite 表怎么联动2.1 从 base.html 看 Django 模板继承与静态资源组织Django 模板和前端模板不太一样它靠{% extends %}和{% block %}完成页面复用。资源里所有 HTML 页面几乎都会继承 base.html打开 base.html 能看到 reset.css、style.css、semantic.custom.css 都被统一引入。常见做法是再把自定义页面里的独有样式放进{% block extra_css %}避免每个页面重复引一堆 link。{% load static %} !DOCTYPE html html langzh-cn head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title{% block title %}视频点播{% endblock %}/title link relstylesheet href{% static css/reset.css %} link relstylesheet href{% static css/style.css %} link relstylesheet href{% static css/semantic.custom.css %} {% block extra_css %}{% endblock %} /head body {% block content %}{% endblock %} /body /html{% static %}标签最终会拼上 settings.py 里的STATIC_URL默认是/static/。所以 index.html、detail.html 里引用的{% static css/xxx.css %}都能被 Django 的开发服务器直接解析。这里有个容易踩的坑如果项目后面接了 NginxDjango 只负责生成页面/static/ 下的文件会交给 Nginx 统一处理否则每次请求都会打回 Python 进程并发一高页面就会卡。2.2 视频与收藏的 ORM 模型设计一个视频点播网站的数据模型不需要设计得特别复杂核心就是视频表、分类表、收藏表。收藏关系必须把登录用户和视频关联起来并且不能让同一用户对同一视频重复收藏。这是 Django 模型层最值得看的部分。from django.conf import settings from django.db import models class Category(models.Model): name models.CharField(max_length30, uniqueTrue) class Video(models.Model): title models.CharField(max_length120) description models.TextField(blankTrue) video_file models.FileField(upload_tovideos/%Y/%m/) cover models.ImageField(upload_tocovers/%Y/%m/, blankTrue) category models.ForeignKey(Category, nullTrue, on_deletemodels.SET_NULL) views_count models.PositiveIntegerField(default0) created_at models.DateTimeField(auto_now_addTrue) def __str__(self): return self.title class Favorite(models.Model): user models.ForeignKey(settings.AUTH_USER_MODEL, on_deletemodels.CASCADE, related_namefavorites) video models.ForeignKey(Video, on_deletemodels.CASCADE, related_namefavorite_set) created_at models.DateTimeField(auto_now_addTrue) class Meta: unique_together (user, video)video_file里的upload_tovideos/%Y/%m/是按年月建子目录避免所有视频堆在一个目录里cover用 ImageField需要安装 pillow否则迁移时会报错。on_deletemodels.CASCADE表示用户或视频删除后收藏记录同步删除不会留下脏数据。unique_together是数据库层面做唯一约束比只在业务代码里判重更可靠。字段类型说明titleCharField视频标题长度 120video_fileFileField视频文件按年月存储coverImageField封面图可留空categoryForeignKey分类分类删了不删视频views_countPositiveIntegerField播放数只增不减Favorite.userForeignKey关联 Django 自带 UserFavorite.videoForeignKey关联视频收藏目标2.3 路由映射与视图分层列表页、播放页、个人中心怎么分拆解这个项目时我最先看的是 urls.py因为页面之间怎么跳转都在这里定死。路由用path()而不是旧式正则匹配参数直接写int:pk比正则清晰很多。from django.urls import path from . import views app_name video urlpatterns [ path(, views.IndexView.as_view(), nameindex), path(video/int:pk/, views.VideoDetailView.as_view(), namedetail), path(profile/, views.ProfileView.as_view(), nameprofile), path(video/edit/int:pk/, views.video_edit, namevideo_edit), ]app_name video是命名空间模板里引用时写{% url video:detail video.id %}。这个项目里 index.html 负责列表展示detail.html 是播放页profile.html 是当前登录用户的收藏列表video_edit.html 承担后台编辑视频的入口。用类视图的好处是ListView自带分页DetailView自带 404 逻辑不用每个视图都手写 try except。3. 视频播放与收藏接口从 HTML5 video 标签到 Ajax 请求3.1 播放页怎么把视频文件安全地交给模板Django 的播放页不需要自己写流媒体服务器只需要在DetailView里把视频对象取出来模板里用 HTML5video标签引地址。播放量统计不要在__str__或者模板里做要在视图层用F()表达式做原子更新不然并发点击时会丢数据。from django.db.models import F from django.views.generic import DetailView from .models import Video class VideoDetailView(DetailView): model Video template_name detail.html context_object_name video def get_object(self, querysetNone): video super().get_object(queryset) Video.objects.filter(pkvideo.pk).update(views_countF(views_count) 1) return video模板中播放器部分video controls preloadmetadata poster{{ video.cover.url }} source src{{ video.video_file.url }} typevideo/mp4 /videovideo.cover.url和video.video_file.url是 FileField 根据 MEDIA_URL 拼出来的完整地址。开发环境必须手动把媒体路由挂到 urls.py 下from django.conf import settings from django.conf.urls.static import static urlpatterns static(settings.MEDIA_URL, document_rootsettings.MEDIA_ROOT)这里有一个需要想清楚的边界static()只适合开发调试生产环境不会由 Django 直接返回视频文件而是由 Nginx 托管 /media/ 目录。如果视频需要登录后才能看还要再加一层权限判断不能直接把文件地址暴露出去。多数毕设项目保留普通播放方式就够用。3.2 收藏与取消收藏Ajax POST、CSRF 与 JSON 响应收藏功能用整页刷新也能做但用户体验差。比较标准的做法是点击按钮后发一个 POST 请求后端返回 JSON前端根据favorited字段切换按钮样式。这个接口需要同时处理“收藏”和“取消收藏”所以用切换逻辑而不是create。import json from django.contrib.auth.decorators import login_required from django.http import JsonResponse from django.views.decorators.http import require_POST from .models import Video, Favorite login_required require_POST def toggle_favorite(request): data json.loads(request.body) video_id data.get(video_id) video Video.objects.filter(pkvideo_id).first() if not video: return JsonResponse({code: 404, message: 视频不存在}, status404) favorite, created Favorite.objects.get_or_create(userrequest.user, videovideo) if not created: favorite.delete() return JsonResponse({code: 0, favorited: False}) return JsonResponse({code: 0, favorited: True})require_POST限制了只能通过 POST 访问避免用户用地址栏直接 GET 误删收藏数据。get_or_create返回一个布尔值createdTrue表示新建成功createdFalse表示之前已经收藏过此时执行删除。前端 fetch 时要带上 CSRF token否则 Django 会返回 403。fetch(/favorite/toggle/, { method: POST, headers: { Content-Type: application/json, X-CSRFToken: getCookie(csrftoken) }, body: JSON.stringify({ video_id: videoId }) })getCookie(csrftoken)是从 cookie 里读取 csrftoken 的通用函数Django 的 CsrfViewMiddleware 校验的就是这个值。你需要确保模板里有{% csrf_token %}或在渲染时写入了这个 cookie。3.3 profile.html 里把收藏列表查出来个人中心页最忌讳的做法是直接在模板里写user.favorite_set.all。这样每渲染一个收藏项Django 都要再查一次关联视频的 title、cover形成 N1 查询。资源里的 profile.html 差不多就是个人中心加收藏清单的组合页正确做法是使用select_related预取外键。from django.contrib.auth.mixins import LoginRequiredMixin from django.views.generic import ListView from .models import Favorite class ProfileView(LoginRequiredMixin, ListView): template_name profile.html context_object_name favorites paginate_by 6 def get_queryset(self): return Favorite.objects.filter(userself.request.user)\ .select_related(video)\ .order_by(-created_at)LoginRequiredMixin会在未登录时跳到登录页。select_related(video)生成的 SQL 会带 JOIN一次性把 Favorite 和 Video 查出来。模板里遍历 favorites 时直接访问favorite.video.title就不会触发额外查询。如果你发现这个页面响应慢先看数据库 query 数量而不是急着上缓存。4. 后台管理实战自定义 Django admin 与视频录入4.1 注册模型与 list_display 快速生成后台Django 自带的 admin 已经能覆盖视频点播网站的后台管理需求关键是怎么把列表页调成能用的状态。默认注册模型后后台只显示一个对象名称完全没法做内容运营。加一张VideoAdmin把常用字段铺开是第一步。from django.contrib import admin from .models import Video, Favorite, Category admin.register(Video) class VideoAdmin(admin.ModelAdmin): list_display (id, title, category, views_count, created_at) list_filter (category, created_at) search_fields (title, description) list_per_page 20 readonly_fields (views_count, created_at)list_display决定后台列表显示哪些列list_filter是右侧筛选器search_fields会生成搜索框list_per_page控制每页数量。readonly_fields把播放统计和创建时间设为只读避免手滑改掉数据。这样视频点播网站的后台管理就已经具备“内容录入、筛选、搜索”能力了。4.2 admin.css 与 video_edit.html两条定制路线资源里同时存在 admin.css 和 video_edit.html这其实是后台管理的两条路线。admin.css 是给 Django admin 换肤的常见做法是在模型 admin 里通过 Media 指定额外样式class VideoAdmin(admin.ModelAdmin): class Media: css { all: (admin/css/admin.css,) }把 admin.css 放进某个 app 的 static/admin/css/ 目录下后台页面就会加载它覆盖默认样式。另一条路线是video_edit.html这种自定义表单页在 Django admin 之外写一个视频编辑视图模板里放自己的表单控件提交后手动保存 Video 记录。它的好处是可以定制字段布局、加前端校验坏处是要重复处理权限、表单验证和错误回显。我一般建议课程设计和大部分内部工具直接用 admin只有对外给运营团队用才考虑自定义表单页。4.3 后台关联收藏数据用 TabularInline 看用户行为收藏记录一般不需要在后台手动新增但管理员可能想看看某个视频被哪些用户收藏了。把 Favorite 作为内联插到 VideoAdmin 里就能实现。class FavoriteInline(admin.TabularInline): model Favorite extra 0 readonly_fields (user, video, created_at) def has_add_permission(self, request, objNone): return FalseTabularInline 以表格形式展示关联记录extra 0表示不额外显示空行。has_add_permission禁用手动新增因为收藏行为只能由用户在前端触发。这种限制也让后台管理更贴近真实业务而不是一个脱离功能的 CRUD 面板。5. 前端整合dropload 下拉加载、index.html 列表渲染与分页5.1 dropload 是什么为什么需要 dropload.css首页视频列表一多直接全量渲染会拖慢首屏。这个资源里出现的 dropload.css 是配合 dropload.js 实现下拉加载的配套样式控制加载提示动画的位置和转圈效果。dropload 和 Django 的分页方式是天然搭配前端滚动到底部时请求下一页 JSON后端返回当前页数据前端拼接 HTML。$(#video-list).dropload({ scrollArea: window, loadDownFn: function (me) { $.ajax({ url: /api/videos/?page nextPage, dataType: json, success: function (data) { if (data.has_next) { appendVideoCards(data.items); nextPage 1; me.resetload(); } else { me.lock(); me.noData(); } }, error: function () { me.resetload(); } }); } });scrollArea指定滚动容器默认是 window。loadDownFn是触底回调me.resetload()必须在下一次请求前调用否则插件会处于加载中状态me.lock()用来在数据全部加载后锁住下拉配合me.noData()显示“没有更多了”。dropload.css 里定义的.dropload-load、.dropload-noData是加载状态和底部状态的样式类自己改布局时优先调整这两个类。5.2 给 dropload 写一个 JSON 分页视图首页第一次渲染可以用 Django 模板但下拉加载必须有一个返回 JSON 的接口。这里不适合直接套ListView因为它默认返回 HTML。写一个独立视图更清晰from django.core.paginator import Paginator from django.http import JsonResponse from django.views.decorators.http import require_GET from .models import Video require_GET def video_api(request): page_num int(request.GET.get(page, 1)) video_list Video.objects.all().order_by(-created_at) paginator Paginator(video_list, 8) page_obj paginator.get_page(page_num) items [] for video in page_obj: items.append({ id: video.id, title: video.title, cover: video.cover.url if video.cover else , views_count: video.views_count, url: reverse(video:detail, args[video.id]) }) return JsonResponse({ page: page_obj.number, has_next: page_obj.has_next(), items: items })get_page即使传入超出范围的页码也不会抛异常会返回最后一页。has_next决定前端是否继续加载。reverse在这里生成详情页链接前端拿到后直接location.href或拼到卡片上。注意这个接口没有做登录限制因为在首页列表播放量展示不需要登录。5.3 style.css 与 semantic.custom.css 的分工拿到这种前后端不分离的 Django 项目CSS 文件命名和职责要分清。reset.css 重置浏览器默认 margin 和 padding保证各浏览器下页面基准一致style.css 是项目主体样式负责布局、间距、卡片和导航栏semantic.custom.css 是对 Semantic UI 风格的定制补丁里面一般放图标、按钮、标签等组件的微调。改界面时我习惯把自定义样式额外放在一个 custom.css 里而不是直接改 semantic.custom.css。因为后者的类名往往关联多个页面一删一改就会牵动 detail.html、profile.html 的显示效果。从这个资源的页面数量看风格统一靠的是这套 CSS 分层而不是内联 style这对后续扩展页面非常重要。6. 从源码到在线本地复现、数据库迁移与 Django 部署排错6.1 必做的 settings 环境配置拿到源码第一件事不是立刻runserver而是先在项目根目录建虚拟环境装依赖。ImageViewField 用到了 pillow视频文件本身不需要额外库但封面如果使用 ImageField 就必须装。python -m venv venv source venv/bin/activate pip install django pillow python manage.py makemigrations python manage.py migrate python manage.py createsuperuser python manage.py runserver如果 zip 里提供了 requirements.txt就改用pip install -r requirements.txt。settings.py 里至少要确认MEDIA_ROOT、MEDIA_URL、STATIC_URL三个配置存在否则视频上传后访问不到文件。6.2 启动前用一条命令检查部署风险Django 自带一个检查部署风险的命令很多人不知道python manage.py check --deploy它会输出一堆安全警告包括 SECRET_KEY 是否硬编码、DEBUG 是否开启、ALLOWED_HOSTS 是否为空。热词里经常能看到的“Python Django 搭建 Web 项目”踩坑大部分都能在这一步暴露出来。生产环境还要执行collectstatic把 admin 和自定义静态文件收集到指定目录python manage.py collectstatic --dry-run--dry-run只显示计划复制的文件不真正复制。确认无误后去掉这个参数执行一次否则关闭 DEBUG 后后台管理页会完全没有样式。6.3 典型报错与排查路径现象优先排查常见原因视频地址 404 无法播放MEDIA_URL 是否挂载到 urls忘记拼接 static() 或 production 未指向媒体目录admin 页面无样式collectstatic 是否执行DEBUGFalse 后未收集静态文件收藏按钮提示 403CSRF token 是否传递fetch 请求没有带 X-CSRFToken 头收藏接口返回 302 而不是 JSON用户是否已登录LoginRequired 拦截 Ajax 请求会被重定向到登录页dropload 一直转圈jQuery 和 dropload 引入顺序dropload.js 必须在 jQuery 之后加载收藏接口返回 302 这个问题最容易忽略。你需要在 Ajax 里判断response.redirected或后端返回 401 而不是自动跳转。我一般会在login_required之外包一层 JSON 判断让未登录用户收到明确提示。最后一个实用技巧开发环境里把媒体和静态路径都交给 Django 处理没问题但一旦把项目切到正式环境不要用 runserver而是用 gunicorn 启动Nginx 单独托管 /static/ 和 /media/。启动前先跑一遍python manage.py check --deploy和collectstatic --dry-run这两个命令能拦下大部分部署上线问题。本文还有配套的精品资源点击获取
