简介：面向高校计算机专业毕业设计及课程设计的Python+Django视频点播平台完整项目包，包含整套项目源代码、数据库备份与部署说明，下载解压后即可直接运行使用。系统采用清晰模块化设计，涵盖视频展示、分类检索、后台管理、评论互动等典型功能，适合需要快速搭建Web应用并深入理解Django后端架构的学习者。压缩包共156个文件，大小约3.89MB，其中Python文件实现主要后端业务逻辑，HTML模板负责页面结构渲染，CSS与JavaScript完成前端样式和交互，zbak备份文件用于还原数据库，另配有图片、静态资源、配置文件与说明文档，目录清晰便于查阅。目前已有82人学习下载。借助配套教程，可系统化完成环境搭建、数据初始化、功能测试与基础定制，将课堂理论转化为可演示的工程项目，对毕业设计答辩与课程综合评审有直接帮助。
1. 视频点播网站适合当毕设，但九成项目卡在“视频”这两个字上
“基于Python与Django的视频点播网站系统”听起来是一道标准的毕业设计题，但很多同学拿到下载的“完整源码”后才发现：难点根本不在“网站”上，而在“视频”两个字上。用 Django 写列表页、详情页、后台管理，教程一搜一大把；真正让系统显得“能落地”的三件事——视频文件怎么存、在线播放怎么播、播放进度怎么记住——反而很少有人讲透。
这篇笔记按做一个视频点播网站的真实顺序展开：先做技术选型，再搭最小可运行骨架，接一个合法可复现的数据集，最后给出一份答辩前必须过一遍的避坑自检清单。所有代码以最小规模给出，可以当开发教程直接照着敲，也能作为核心模块塞进你手头的源码包里去改。适合有 Python 基础、准备把毕设做到“能演示、能解释、能改参数”的同学。
2. 先选型再动手：Django版本、数据库、媒体目录与在线播放方案怎么定
2.1 版本组合别追新：Python 3.10 + Django 4.2 LTS 最省心
选型顺序是反着来的：先看本机 Python 解释器版本，再选 Django 版本。不要拿到一个源码包就执行 pip install -r requirements.txt，先把环境跑起来再看跑不跑得动。
python --version pip --version在多数课程设计和毕业设计场景里，最稳的组合是 Python 3.10 加 Django 4.2 LTS。Django 4.2 是当前公认的长期支持版本，安全更新周期长，第三方库兼容性也经过大量验证。不要追最新版：新版本特性确实吸引人，但部分第三方库（比如富文本编辑器、文件处理组件）还没完全跟上，答辩现场因为“装不上依赖”而翻车是很不划算的事。
反过来也要提醒：如果你的机器上已经是 Python 3.12，装 Django 4.2 也能跑，但个别依赖可能需要 pip 编译安装，比如 mysqlclient 的 Python 绑定。这时要么升级到 Django 5.x，要么提前装好编译工具链。选型的关键不是“谁的版本最新”，而是“源码包里的 requirements.txt 能否一行装完”，这是源码能不能交到别人手里直接复现的前提。
2.2 数据库用 SQLite 起步，但要提前留好 MySQL 的台阶
本地开发直接用默认的 SQLite 完全够用。几百部电影的元数据、评论和播放记录，SQLite 不会成为瓶颈。但答辩老师大概率会问：“上线怎么办？” 所以模型层要避开 SQLite 特有写法，用 ORM 的标准字段，未来切 MySQL 时只需要改一处配置，而不是重写业务代码。
# settings.py 中默认的数据库配置 DATABASES = { "default": { "ENGINE": "django.db.backends.sqlite3", "NAME": BASE_DIR / "db.sqlite3", } }切到 MySQL 时，至少需要改三处：ENGINE 换成 django.db.backends.mysql，NAME、USER、PASSWORD 换成真实实例信息，同时在 requirements.txt 里增加 mysqlclient 或 pymysql。我习惯把数据库配置抽到环境变量里，比如用 os.getenv("DB_NAME") 去读配置，而不是在 settings.py 里硬编码。这样源码包发给别人时，只需要改环境变量就能跑起来。对 django 项目实战新手来说，这比要求对方直接改 settings.py 要友好得多。
2.3 MEDIA 配置：MEDIA_URL 与 MEDIA_ROOT 的分工别搞反
视频文件属于非结构化数据，Django 约定把它放在 media 目录，与静态文件（CSS、JS、页面图片）分开。静态文件是代码的一部分，媒体文件是用户上传或运营录入的内容，生命周期完全不同。
# settings.py 追加 MEDIA_URL = "/media/" MEDIA_ROOT = BASE_DIR / "media"只有配置这两个变量还不够，开发服务器默认不会把 /media/ 路径映射到磁盘目录。urls.py 里要加一段开发环境专用映射：
from django.conf import settings from django.conf.urls.static import static urlpatterns = [...] if settings.DEBUG: urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)这里有个容易误会的细节：static() 只把 URL 前缀映射到 document_root，它不会做文件权限校验，也不会加速文件传输。线上部署时真正服务媒体文件的是 Nginx 或云存储，到那时这个 if settings.DEBUG 分支就不会继续命中。很多同学在本地能点开视频，一上服务器就 404，往往就是没搞懂这个分工：MEDIA_ROOT 是文件落盘的位置，MEDIA_URL 是浏览器访问时的 URL 前缀，两者不能混写。
2.4 在线播放方案对比：FileResponse 比自造轮子可靠
毕设里最纠结的问题是“用什么技术实现在线播放”。常见做法有三种。
第一种，直接把 mp4 地址交给 HTML5 video 标签。最简单，适合演示，只要文件编码是 H.264 就能播。第二种，自己写一个文件响应视图，让它支持 HTTP Range 请求，这样用户可以拖拽进度条，浏览器只取需要的字节段。第三种，用 ffmpeg 把视频切片成 HLS（m3u8 + ts），这是商业视频站最常见的做法，但会给毕设增加很大的工作量与部署复杂度。
我的建议是选第二种，但不用自己解析 Range 请求头。Django 3.2 以后，django.http.FileResponse 已内置对 Range 和条件请求的支持，只要用它返回视频文件，浏览器拖拽进度条就能被正确处理。
# views.py 中的视频流视图 from django.http import FileResponse from django.shortcuts import get_object_or_404 from .models import Video def video_stream(request, video_id): video = get_object_or_404(Video, pk=video_id) response = FileResponse(video.file.open("rb")) response["Content-Type"] = "video/mp4" response["Cache-Control"] = "no-cache" return response逻辑说明：video.file.open("rb") 打开的是 FileField 指向的磁盘文件；FileResponse 会把它作为流式响应返回，并自动处理 Range 请求，所以浏览器支持拖拽、快进、倍速播放。Content-Type 设置成 video/mp4 是告诉浏览器按视频解析；Cache-Control 设成 no-cache，是为了避免演示时因为本地缓存读到旧文件。
参数说明：这里刻意不写 Content-Length，因为 FileResponse 会从文件句柄自动获取。如果视频文件很大，请务必确认磁盘读权限和网络带宽。开发阶段把演示视频控制在 50MB 以内，否则答辩现场卡在加载转圈，体验很差。HLS 切片方案可以在“未来优化方向”里回答，但不要让切片逻辑拖垮主线开发进度。
2.5 django 创建 app 的正确姿势：项目结构决定源码包观感
很多毕设源码包拿到手，根目录里横着三四个同名文件、media 目录里混着 .pyc 缓存。其实只要两步就能让项目结构干净得多：
django-admin startproject vod_site . python manage.py startapp vod第一行在当前目录生成名为 vod_site 的项目，第二行生成名为 vod 的应用。注意 startproject 后面的点号，表示“就放在当前目录”，不加点号会多嵌套一层目录。应用名用 vod 而不是 video，是因为应用名会出现在 URL 命名空间、数据库表前缀里，短名字写路由和模板标签时更省心。
生成应用后，必须把 vod 加进 INSTALLED_APPS，否则 migrations 永远提示 “No changes detected”：
INSTALLED_APPS = [ "django.contrib.admin", "django.contrib.auth", ... "vod", ]这一步错了，后面所有 makemigrations 都会识别不到模型。看起来很玄学，其实就是应用没有注册。把这一步放在正式动手前，后面的路由、模型、模板才能按同一个名字空间组织起来。
3. 从 model 到 template：一个能跑通的视频列表与播放页骨架
3.1 数据模型设计：Video、Category 与评论的三个关系
不要过度建模，但基本关系要清晰。一个视频属于一个分类，一条评论属于一个视频和一个用户，这三者用外键连起来就够。
# vod/models.py from django.db import models from django.contrib.auth.models import User class Category(models.Model): name = models.CharField(max_length=50, unique=True, verbose_name="分类名") slug = models.SlugField(max_length=50, unique=True, verbose_name="URL标识") def __str__(self): return self.name class Video(models.Model): title = models.CharField(max_length=200, verbose_name="标题") category = models.ForeignKey( Category, related_name="videos", on_delete=models.CASCADE, verbose_name="分类" ) cover = models.ImageField(upload_to="covers/", blank=True, verbose_name="封面") file = models.FileField(upload_to="videos/", verbose_name="视频文件") description = models.TextField(blank=True, verbose_name="简介") release_year = models.PositiveIntegerField( null=True, blank=True, verbose_name="上映年份" ) created_at = models.DateTimeField(auto_now_add=True, verbose_name="入库时间") class Meta: ordering = ["-created_at"] def __str__(self): return self.title class Comment(models.Model): video = models.ForeignKey(Video, related_name="comments", on_delete=models.CASCADE) user = models.ForeignKey(User, on_delete=models.CASCADE) content = models.TextField(verbose_name="评论内容") created_at = models.DateTimeField(auto_now_add=True)逻辑说明：category 用外键而不是 CharField，是为了后台筛选、前端分类页和按分类统计都能用 ORM 完成。file 用 FileField 而不是 CharField，是为了在 admin 里拿到文件上传控件。Video 与 Category 的关系是“多对一”，所以外键放在 Video 这一侧；Comment 与 Video 是“一对多”，外键放在 Comment 这一侧，并通过 related_name="comments" 让模板里能直接写 video.comments.all。
参数说明：upload_to 指定的是 MEDIA_ROOT 下的相对子目录，不是绝对路径。release_year 用 PositiveIntegerField，比 IntegerField 多一层“不能为负数”的约束，天然适合年份。删除分类时 CASCADE 会把该分类下所有视频一起删掉，在演示阶段合理；如果后续想保留视频，再改成 on_delete=models.SET_NULL 并允许 category 为空。那是一个在源里说“django 查询-删除对象”常被问到的点。
第一行 生成数据库表：
python manage.py makemigrations vod python manage.py migrate3.2 视图写法：函数视图比 CBV 更适合现场讲解
列表页与详情页，可以用通用视图（ListView/DetailView）写得非常简短，但通用视图封装太多，答辩现场一旦被打断问“这句代码在哪一步执行”，很难指出来。函数视图每行都显式，断点也容易下，对毕设源码的可读性更有利。
# vod/views.py from django.shortcuts import render, get_object_or_404 from django.core.paginator import Paginator from .models import Video, Category def video_list(request, category_slug=None): qs = Video.objects.select_related("category").all() if category_slug: qs = qs.filter(category__slug=category_slug) categories = Category.objects.all() paginator = Paginator(qs, 12) page_obj = paginator.get_page(request.GET.get("page")) return render(request, "vod/video_list.html", { "page_obj": page_obj, "categories": categories, "current_category": category_slug, }) def video_detail(request, video_id): video = get_object_or_404( Video.objects.select_related("category"), pk=video_id ) comments = video.comments.select_related("user").all() return render(request, "vod/video_detail.html", { "video": video, "comments": comments, })逻辑说明：qs 一开始就带上 select_related("category")，让分类字段在同一个 SQL JOIN 里取回，列表页循环访问 video.category.name 时不会产生额外查询。category__slug 是跨表过滤的写法，双下划线表示“关联模型的字段”，这是 Django ORM 入门最容易写错的地方——不是 filter(category=slug)，而是 filter(category__slug=slug)。
参数说明：Paginator(qs, 12) 表示每页 12 条；get_page 方法会在页码越界时自动返回最后一页，而不会抛 404，所以模板里的“下一页”按钮可以放心渲染。detail 视图里用 select_related("user") 加载评论用户，是为了详情页显示评论者昵称时不再发第二条查询。
3.3 路由与模板：用命名空间把链接写稳
应用内的 urls.py 单独维护，项目根 urls.py 只做 include，这是源码包便于扩展的基础。
# vod/urls.py from django.urls import path from . import views app_name = "vod" urlpatterns = [ path("", views.video_list, name="video_list"), path("category/<slug:category_slug>/", views.video_list, name="category_videos"), path("video/<int:video_id>/", views.video_detail, name="video_detail"), path("video/<int:video_id>/stream/", views.video_stream, name="video_stream"), ]项目根 urls.py：
# vod_site/urls.py from django.contrib import admin from django.urls import path, include urlpatterns = [ path("admin/", admin.site.urls), path("", include("vod.urls")), ]app_name = "vod" 设置后，模板里就能写 {% url 'vod:video_detail' video.id %} 而不是写死 /video/1/。将来如果要把视频模块挪到子域名或单独后端，只改 urls.py 里的 path，模板不动，这是“源码可维护”最直观的体现。
列表页模板关键片段：
{% extends "base.html" %} {% block content %} <div class="video-grid"> {% for video in page_obj %} <a class="card" href="{% url 'vod:video_detail' video.id %}"> {% if video.cover %} <img src="{{ video.cover.url }}" alt="{{ video.title }}"> {% endif %} <h3>{{ video.title }}</h3> <span>{{ video.category.name }}</span> </a> {% endfor %} </div> {% if page_obj.has_next %} <a href="?page={{ page_obj.next_page_number }}">下一页</a> {% endif %} {% endblock %}详情页播放器部分：
<video controls preload="metadata" src="{% url 'vod:video_stream' video.id %}" id="player"></video>跑通整条链路的验证步骤：
python manage.py makemigrations vod python manage.py migrate python manage.py runserver打开 http://127.0.0.1:8000/，能看到空列表页，再往 admin 里录一条视频，列表页就能出卡片。到这一步，视频列表、分类过滤、详情页、视频流四个页面已经形成一个最小闭环，剩余工作都是在这个骨架上加数据和细节。
4. 数据集与初始化：用 fixture 和管理命令把片库撑起来
4.1 先想清楚数据来源与素材边界
视频点播网站系统的敏感点不在代码，而在数据。很多现成源码包里直接带着整部电影的 mp4，这既踩了版权红线，答辩时也容易被追问“来源是否合法”。我建议把“演示数据”和“真实业务数据”分开：演示视频用自己录屏或公开素材制作成 1 到 2 分钟的短视频；影片的标题、分类、年份这类事实性元数据，手工整理成结构化文件即可。
数据集形态可以拆成三部分：一份元数据 JSON 或 CSV，包含标题、分类、封面路径、视频路径、简介、年份；一份媒体文件放在 media/videos/ 与 media/covers/ 下；一段导入代码负责把元数据写进数据库。这份素材集不追求数量大，一两百条以内足够。关键是让“导入”这个操作能被反复执行，绝对不能只靠 admin 手工逐条录入，否则换个环境重装数据库，演示前光是补数据就要浪费半天。
4.2 用 fixture 做首次导入：一行命令建起片库
Django fixture 用 JSON 描述数据，内置 loaddata 命令直接支持，是最省事的初始导入方式。先写 seed.json：
[ { "model": "vod.category", "pk": 1, "fields": {"name": "Python", "slug": "python"} }, { "model": "vod.category", "pk": 2, "fields": {"name": "Django", "slug": "django"} }, { "model": "vod.video", "pk": 1, "fields": { "title": "Django 安装与项目创建演示", "category": 2, "cover": "covers/django-install.jpg", "file": "videos/django-install.mp4", "description": "演示素材：录屏短视频，时长约两分钟。", "release_year": 2024 } } ]执行导入：
python manage.py makemigrations vod python manage.py migrate python manage.py loaddata seed.json注意，fixture 里的 cover/file 字段填的是相对于 MEDIA_ROOT 的路径，不是绝对路径。文件必须提前以对应名字放进 media 目录，否则 admin 里会显示一个悬空文件，甚至打不开详情页。这个细节经常让新手误认为 loaddata 写坏了，其实 fixture 只写了“索引”，并没有把媒体文件本身打包进来。
fixture 适合初始化一个空库，但它不幂等：重复执行 loaddata seed.json 会因主键冲突报错。如果你需要“追加导入”和“重复执行不报错”，就用下一节的自定义管理命令。
4.3 用管理命令导入 CSV：可重复执行的“重新初始化”
一个更正规的做法是把数据导入逻辑写成一个 Django management command。在 vod/management/commands/ 下新建 import_videos.py。注意 management 和 commands 两个目录下都必须有空的init.py，否则 Django 不会把这个命令注册进 manage.py。
# vod/management/commands/import_videos.py import csv from django.core.management.base import BaseCommand from vod.models import Category, Video class Command(BaseCommand): help = "从 CSV 导入视频元数据，分类不存在时自动创建" def add_arguments(self, parser): parser.add_argument("csv_path", type=str) def handle(self, *args, **options): with open(options["csv_path"], encoding="utf-8-sig") as f: reader = csv.DictReader(f) for row in reader: category, _ = Category.objects.get_or_create( name=row["分类"] ) video, created = Video.objects.get_or_create( title=row["标题"], defaults={ "category": category, "release_year": row.get("年份") or None, "description": row.get("简介", ""), }, ) if created: self.stdout.write(f"已导入: {video.title}") else: self.stdout.write(f"跳过: {video.title}（已存在）")逻辑说明：文件用 utf-8-sig 编码打开，会自动去掉 BOM 头，否则第一列列名会带着 \ufeff 变成乱码，这是 CSV 导入最常见的坑。get_or_create 返回一个二元组，第一个元素是对象，第二个是是否新建的布尔值；这里分类和视频都用了 get_or_create，让命令可以反复执行，已经导入过的记录自动跳过，不会因为主键冲突中断。
参数说明：add_arguments 注册了 csv_path 位置参数，调用方式如下。CSV 第一行需要是表头：分类,标题,年份,简介。如果你希望连视频文件路径也从 CSV 里导入，可以在 CSV 里加一列 file_path，然后给 video.file 字段赋字符串路径，但要注意这个路径必须是相对 MEDIA_ROOT 的路径，否则 admin 里同样访问不到。
python manage.py import_videos data/videos.csv这条命令相当于源码包自带的“重新初始化数据”脚本。答辩时被问“数据集怎么来的”，你可以指一指这个命令，说明元数据是手工整理的 CSV，演示素材是自己录制的短视频，数据链路完全可查，这是给老师吃定心丸的地方。
4.4 接入 Admin 后台：让演示能现场“加片”
数据导入跑通后，再把 admin 后台配置得顺手一点。admin 是 Django 项目最不需要额外开发的“管理系统”，合理配置能省掉很多演示时的口头解释。
# vod/admin.py from django.contrib import admin from .models import Video, Category @admin.register(Video) class VideoAdmin(admin.ModelAdmin): list_display = ("title", "category", "release_year", "created_at") list_filter = ("category", "release_year") search_fields = ("title", "description") date_hierarchy = "created_at" fieldsets = ( (None, {"fields": ("title", "category", "description")}), ("媒体素材", {"fields": ("cover", "file")}), ) admin.site.register(Category)list_display 决定列表页展示哪些列，list_filter 在右侧生成筛选区，search_fields 提供搜索框。date_hierarchy 会在列表页顶部生成一个按日期逐层下钻的控件，对“入库时间”比较敏感的展示场景很好用。fieldsets 把表单分成基本信息与媒体素材两块，录入时不容易把字段看错。
登录 admin 前必须创建超级用户：
python manage.py createsuperuser创建完账号，用 runserver 启动，访问 /admin/，就可以在线添加分类和视频。演示时在后台现加一条视频，再回到前台刷新看到新卡片，这个动作比任何截图都更能说明系统是“活”的。
5. 答辩前避坑自检：Media 404、编码黑屏、N+1 查询与搜索分词
代码能跑和源码能交付之间还有一段距离。下面五条是调试视频点播网站时反复踩过的坑，每条按现象、原因、解决的顺序给出来，演示前一天逐一对一遍。
5.1 图片与视频 404 但页面正常：MEDIA_URL 没接上
现象：页面正常，admin 正常，但封面图片打不开，视频播放器一片空白；浏览器 Network 面板里 /media/covers/xxx.jpg 返回 404。
原因：Django 开发服务器默认只映射静态文件 URL（/static/），不会自动映射 /media/。很多源码包只有在 DEBUG=True 时才加载 static(settings.MEDIA_URL, ...)，你只要改过 DEBUG 设置，media 就会跟着失效。
解决：在 urls.py 里保留开发环境映射：
if settings.DEBUG: urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)同时确认 MEDIA_ROOT 指向的目录真实存在，且视频/封面文件名与数据库里记录的字符串完全一致。常见错误还包括路径里混入中文名或空格，某些环境下会读出 404。演示前先把 media 目录下的文件清单和数据库 file 字段打出来比对一遍，两个都不对就直接换文件名，别在答辩现场赌系统。
5.2 浏览器黑屏但有声音：视频编码不是 H.264
现象：video 标签加载了，控制台也显示请求成功，但画面黑屏或者一直转圈；有的浏览器能放，换一个浏览器就不行。
原因：HTML5 video 对 H.264/AAC 的 MP4 兼容性最好。手机录屏的素材常见是 H.265/HEVC 编码，浏览器要么不支持硬解、要么版权解码器缺失；还有部分演示素材是 WebM 或 MOV 容器，和页面上写死的 video/mp4 不匹配。
解决：用 ffmpeg 统一转码：
ffmpeg -i input.mov -c:v libx264 -c:a aac -movflags +faststart output.mp4参数说明：-c:v libx264 将视频轨转成 H.264，-c:a aac 将音频轨转成 AAC，+faststart 把视频元数据挪到文件头部，浏览器不用下载整个文件就能开始播放。这三个参数组合能解决绝大多数“有画面没声音、有声音没画面、黑屏转圈”的问题。演示素材全部转码一次，再按文件大小压缩到 50MB 以内，比在播放器代码里做兼容判断更省事。
5.3 列表页越来越慢：select_related 没写对
现象：视频数量从 20 条涨到 100 条后，列表页明显变卡；数据库日志或 Django Debug Toolbar 显示 SQL 查询数量随记录数线性增长。
原因：模板循环里访问 video.category.name，甚至 video.comments.count，每访问一次就发一条额外 SQL。这是典型的 N+1 查询问题，也是源码包优化文章里被反复强调的 select_related 场景。
解决：视图里把关联查询一次取回：
qs = Video.objects.select_related("category").prefetch_related("comments")逻辑说明：select_related 用于“多对一/一对一”外键，通过 JOIN 一次取回；prefetch_related 用于“一对多/多对多”反向关系，先查主表再查关联表，然后把结果按外键分组缓存。列表页模板里循环访问 video.comments.all 就不会再发额外查询。只做分类展示时，至少写 select_related("category")；如果列表页还要显示评论数，就把 prefetch_related("comments") 一起加上。
5.4 admin 上传大视频卡死：开发服务器扛不住大请求
现象：在 admin 后台上传一个一两百 MB 的 mp4，保存按钮转圈很久，最后连接重置或调试终端失去响应。
原因：runserver 是单线程开发服务器，上传过程中会阻塞其他请求，也没有断点续传与分片能力；再加上本地网速和临时目录限制，大文件很容易超时失败。
解决：把演示视频压缩或截断到 50MB 以内，这是最直接的办法。视频点播的毕设核心通常是“播放与交互”，不是“海量文件上传”，所以不要把精力耗在分片上传上。如果必须保留大文件，就把文件预先放进 media/videos/ 目录，在后台只填路径或通过数据导入命令关联文件名，绕开 HTTP 上传通道。素材压缩脚本可以放进源码包的 tools 目录，这也是源码包“考虑到了部署问题”的一个加分细节。
5.5 搜索“Django 安装”反而查不到：把整串当了一个词
现象：admin 搜索框输入“Django”能查到记录，输入“Django 安装”反而返回空；前台的搜索功能也出现类似问题。
原因：search_fields 底层用 LIKE 把整个搜索词当成一个连续字符串去匹配，“Django 安装”会被翻译成 LIKE '%Django 安装%'，记录里如果恰好是“Django 安装与项目创建演示”就能命中，但如果词序或空格稍有变化就查不到。搜索引擎语义和数据库模糊匹配是两回事。
解决：在视图层写一个分词搜索函数，按空格把关键词拆开，再组合成 AND 查询：
from django.db.models import Q def search_videos(keyword): if not keyword: return Video.objects.none() q = Q() for word in keyword.split(): q &= Q(title__icontains=word) | Q(description__icontains=word) return Video.objects.filter(q)逻辑说明：q 是一个 Q 对象，循环里每拆出一个词就用 & 叠加条件，最终表达的是“标题或简介里同时包含所有关键词”。这样搜索“Django 安装”时，即使标题写的是“安装 Django 并创建项目”也能命中。如果想要“任意一个词命中即可”，把 & 改成 |；大部分视频站搜索用“同时包含”更符合直觉。
6. 一个进阶技巧：用 localStorage 给播放页加断点续播
6.1 不登录也能记住进度
视频点播网站系统做到能播、能搜、能管理之后，最提升产品感的进阶功能是“记住播放位置”。最轻量的做法是把它放在浏览器 localStorage 里，不依赖登录状态，代码量控制在半天以内。
// 播放页模板中的 script 块 const player = document.getElementById("player"); const storageKey = "vod_progress_" + {{ video.id }}; player.addEventListener("loadedmetadata", () => { const saved = localStorage.getItem(storageKey); if (saved) { const seconds = parseFloat(saved); if (seconds > 5 && seconds < player.duration - 5) { player.currentTime = seconds; } } }); player.addEventListener("timeupdate", () => { localStorage.setItem(storageKey, player.currentTime); });逻辑说明：timeupdate 事件每秒约触发四次，直接写入 localStorage 没有压力，这个写法也最容易被答辩老师理解。判断条件里 seconds > 5 是为了跳过片头误定位，seconds < duration - 5 是为了避免上次已看完时再次打开又从末尾开始播。把 storageKey 里带上 video.id，不同影片的进度互不覆盖。
如果想做成“多设备同步”，才需要在后端建一个播放记录模型，每隔 15 秒上报一次时间点，但那会多出表、API 与定时器三块工作量。毕设把 localStorage 版本先做完，从演示效果来看已经足够，答辩讲“这个可以扩展为后端记录”比现场拿不出功能要稳妥。
这套项目做多了以后，我发现真正的坑往往不在代码层。有一回我把本地所有功能验证通过，答辩当天却当着老师的面翻车——原因是我在无痕窗口里打开演示页，localStorage 为空，播放进度自然没有恢复。现在每回交付源码或上台演示前，我都会用“干净浏览器 + media 路径无中文 + 视频已是 H.264 + 数据库重新导入”四步过一遍环境，而不是只跑一次 runserver 就算完。希望帮到你。
本文还有配套的精品资源，点击获取
