如果你在课程设计季或者毕业季搜过项目资源，大概率见过这类标题：“基于Python+Django的自主在线学习系统”，后面跟着“源码+lw+部署文档+讲解”几个后缀。lw就是论文，整套东西指的是一份可以直接运行、可以直接写进设计文档的项目包。业务场景也很好理解：学生注册登录后浏览课程、选课、按章节学习、记录进度，管理员在后台上架课程、管理用户。技术栈就是Python加Django，外加HTML、CSS、JavaScript以及SQLite或MySQL这类数据库。
我接触过不少类似项目的改造和辅导，说句实话，这类标题看起来“烂大街”，但真正从零做一遍，收获比想象中多得多。Django的认证系统、ORM建模、Admin后台、模板渲染、分页、文件上传，这一套走下来相当于把Web开发的主要模块都过了一遍。这篇文章就把这套系统从项目拆解、数据库设计、代码实现到部署上线的完整流程讲清楚，适合正在做课程设计、想系统学Django、或者想把手头功能Demo变成完整作品集的朋友。
1. 项目整体拆解：这个“自主在线学习系统”到底在做什么
1.1 标题拆解：从关键词看项目形态
先看标题本身的信息量。
“基于Python+Django”是技术栈声明。Python是开发语言，Django是Web框架。Django的特点是“全家桶”，自带ORM、Admin后台、表单、认证、模板引擎等，特别适合信息管理类系统。这类系统最典型的形态就是各种“XX管理系统”“XX平台”，在线学习系统就是其中一类。
“自主在线学习”是业务关键词。“自主”两个字点出了产品定位：不是教师直播授课那种强交互场景，而是学生自选课程、自定节奏、自行安排学习时间，完成学习内容。对应到功能上，必须有课程浏览、选课、按章节学习、进度记录这些核心模块。
“源码+lw+部署文档+讲解”是交付物形态。这说明它是一个面向课程设计或毕业设计的完整项目包，不是单纯的开源Demo。它要求代码能跑、有配套设计文档、能部署上线、还能把设计思路讲清楚。
这种形态的系统，市面上有一个很通用的功能清单：
- 用户端：注册、登录、个人信息查看
- 学习端：课程列表、课程详情、章节内容学习、学习进度
- 管理端：课程管理、章节管理、用户管理
- 辅助功能：评论、收藏、笔记、数据统计
整体来看，这个项目麻雀虽小五脏俱全。用户、课程、学习记录三条核心业务线，几乎覆盖了Web开发的所有基础知识点。
1.2 为什么选Django而不是Flask或Spring Boot
这是很多人第一个纠结的问题。我遇到不少同学问：学了Flask，为什么这类项目推荐用Django？我的回答很直接：Flask适合做小而美的接口服务，Django适合做业务完整的系统。理由有三点。
第一，Django自带Admin后台。在线学习系统必然需要管理端维护课程数据，如果用Flask，管理后台的前端页面全部要自己写；用Django，迁移完数据库之后，在admin.py里注册一下模型，就能获得一个开箱可用的增删改查后台。这个能力能省下大量开发时间，把精力集中在业务逻辑上。
第二，Django的认证系统开箱即用。用户注册、登录、退出、密码哈希、session管理、权限装饰器全部内置。在线学习系统的用户模块是刚需，自己从零实现密码加密和登录状态管理，既浪费时间又容易出安全漏洞。
第三，Django的ORM对数据建模非常顺手。课程、章节、用户、学习进度之间的关系，用模型类的一对多、多对多直接表达，写起来逻辑清晰，数据库表结构和关系一目了然，画ER图也方便。如果换Spring Boot，虽然也能做，但引入的配置和依赖明显更重，对课程设计阶段来说开发效率会低不少。
1.3 业务闭环：一个典型用户的使用路径
设计系统之前，先想清楚业务闭环。我习惯画一条用户路径出来，再沿着路径补页面和数据需求。
学生路径：注册登录 → 浏览课程列表 → 进入课程详情页查看介绍 → 点击选课 → 进入学习页面按章节学习 → 每学完一章标记完成 → 系统更新进度 → 在个人中心看到自己的学习进度和课程完成情况。
管理员路径：登录后台 → 添加课程分类 → 创建课程 → 给课程添加章节和内容 → 查看用户学习数据。
这两条路径串起来就是一个完整的业务闭环。做系统的第一件事不是写代码，而是把这条路径上的页面清单、数据需求、角色权限整理出来。这个习惯到写论文“需求分析”章节时直接能用，不用额外返工。
2. 数据库设计与核心模型
2.1 用户模型：为什么必须自定义User
Django默认的User模型有用户名、密码、邮箱、is_staff等字段，但在线学习系统还需要区分学生和教师角色。常见的做法有两种：一种是新建一个Profile表，用OneToOne关联到User；另一种是自定义User模型，继承AbstractUser并增加role字段。
我的建议很明确：项目一开始就自定义User模型。因为Django的AUTH_USER_MODEL配置一旦在第一次migrate之后修改，会非常麻烦，甚至需要重建整个数据库。项目初始化就把这个配置定好，后面开发一路顺畅。
from django.contrib.auth.models import AbstractUser class User(AbstractUser): ROLE_CHOICES = ( ('student', '学生'), ('teacher', '教师'), ('admin', '管理员'), ) role = models.CharField(max_length=20, choices=ROLE_CHOICES, default='student')然后在settings.py里加上一行：
AUTH_USER_MODEL = 'users.User'角色用字符串字段而不是单独的权限表，对这个项目来说完全够用。如果后面想更细粒度地控制权限，可以在视图层根据user.role做判断，也可以引入Django自带的Permission框架。
2.2 课程与章节：一对多关系的建模
课程表是系统的核心表。至少需要这些字段：
class Course(models.Model): title = models.CharField(max_length=100, verbose_name='课程名称') description = models.TextField(verbose_name='课程简介') cover = models.ImageField(upload_to='covers/', blank=True, null=True, verbose_name='封面图') category = models.ForeignKey(Category, on_delete=models.PROTECT, verbose_name='分类') teacher = models.ForeignKey(User, on_delete=models.CASCADE, limit_choices_to={'role': 'teacher'}, verbose_name='授课教师') created_at = models.DateTimeField(auto_now_add=True)几个设计点要特别注意。
on_delete参数：分类字段用PROTECT，防止删掉一个正在被课程引用的分类导致连锁删除；授课教师用CASCADE，因为教师用户删除时课程跟着删除是合理行为。这个细节在论文和答辩中都能体现你对数据库约束的理解。
ImageField需要安装Pillow库，并且要配置MEDIA_ROOT和MEDIA_URL，否则图片上传后访问不到。很多项目跑不起来，问题就出在这个配置上。
teacher字段加limit_choices_to，只允许教师角色被选为授课人。这个约束不仅在Admin后台生效，也限制了ORM层面的选择范围，是一个很加分的设计。
章节表是课程的从属表，一个课程对应多个章节，外键挂在章节这边：
class Chapter(models.Model): course = models.ForeignKey(Course, on_delete=models.CASCADE, related_name='chapters') title = models.CharField(max_length=100, verbose_name='章节标题') content = models.TextField(verbose_name='章节内容') video_url = models.URLField(blank=True, null=True, verbose_name='视频链接') order = models.PositiveIntegerField(default=0, verbose_name='排序')order字段很多人会忽略，但章节顺序必须显式维护。没有order的话，查询结果只能按id排序，一旦后续在课程中间插入新章节，顺序就全乱了。
2.3 选课、进度与笔记：关系型数据的经典设计
选课关系本质上是多对多。用Django有两种实现方式：一种直接用ManyToManyField，另一种手动建中间表。我推荐手动建中间表，因为选课关系还需要记录选课时间和学习进度，中间表可以承载这些额外业务数据。
class Enrollment(models.Model): user = models.ForeignKey(User, on_delete=models.CASCADE, related_name='enrollments') course = models.ForeignKey(Course, on_delete=models.CASCADE, related_name='enrollments') enrolled_at = models.DateTimeField(auto_now_add=True) class Meta: unique_together = ('user', 'course')unique_together保证一个用户对同一门课程只能选一次，这个约束必须在数据库层做，不能只靠视图层判断。数据库约束是最后一道防线，视图层判断只是体验优化。
学习进度单独建表：
class StudyProgress(models.Model): enrollment = models.ForeignKey(Enrollment, on_delete=models.CASCADE) chapter = models.ForeignKey(Chapter, on_delete=models.CASCADE) completed = models.BooleanField(default=False) completed_at = models.DateTimeField(null=True, blank=True) class Meta: unique_together = ('enrollment', 'chapter')为什么不把“已学章节ID集合”直接存在Enrollment里？因为关系型数据库处理行比处理集合高效得多，而且每个章节的完成时间可以单独记录，后续做学习统计也灵活。进度百分比的计算就是简单除法：某门课程已完成章节数除以总章节数，用count查询就能完成，不需要复杂SQL。
笔记这类附加功能也简单：
class Note(models.Model): user = models.ForeignKey(User, on_delete=models.CASCADE) chapter = models.ForeignKey(Chapter, on_delete=models.CASCADE) content = models.TextField() created_at = models.DateTimeField(auto_now_add=True)整体数据模型就五张核心表：User、Category、Course、Chapter、Enrollment，外加StudyProgress和Note两张辅助表。把它们的关系理清楚，项目的一半工作就完成了。
3. 从零搭建项目：环境、配置与初始化
3.1 版本选择和虚拟环境
先定版本。我给这类项目推荐Python 3.10加Django 3.2 LTS。Django 3.2是长期支持版本，资料多、坑少，网上能搜到的问题基本都有现成答案。Django 4.0之后对Python版本有要求，环境版本不够会直接装不上。课程设计求稳比追新重要。
创建虚拟环境是必须的，尤其当你机器上还有其他Python项目时：
python -m venv venv source venv/bin/activate # Windows下是 venv\Scripts\activate pip install django==3.2 pillowPillow是处理图片上传的依赖，课程封面图会用到。如果计划用MySQL，加装pymysql或mysqlclient。开发阶段用SQLite就行，部署时再切MySQL。
3.2 项目和应用结构
用官方命令创建项目：
django-admin startproject online_learning cd online_learning python manage.py startapp users python manage.py startapp courses python manage.py startapp enrollments应用划分建议按业务边界来：users管用户和认证，courses管课程和章节，enrollments管选课和进度。每个app职责清晰，论文里的功能模块图也好看。
settings.py中需要把三个app加进INSTALLED_APPS，然后配置AUTH_USER_MODEL。模板目录建议在项目根目录建templates文件夹：
TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [BASE_DIR / 'templates'], 'APP_DIRS': True, 'OPTIONS': { 'context_processors': [ 'django.template.context_processors.debug', 'django.template.context_processors.request', 'django.contrib.auth.context_processors.auth', 'django.contrib.messages.context_processors.messages', ], }, }, ]静态文件和媒体文件配置：
STATIC_URL = '/static/' STATICFILES_DIRS = [BASE_DIR / 'static'] STATIC_ROOT = BASE_DIR / 'staticfiles' MEDIA_URL = '/media/' MEDIA_ROOT = BASE_DIR / 'media'这些配置看起来是死代码，但少写一个后面就出问题。静态文件404、图片不显示，90%是这里没配全。
3.3 数据库迁移
数据模型写好后，执行迁移：
python manage.py makemigrations python manage.py migrate python manage.py createsuperusermakemigrations检测模型变更并生成迁移文件，migrate把表建进数据库。开发阶段直接用SQLite，一个文件搞定，方便搬运。上线时切MySQL，迁移文件不用改，Django的ORM已经把SQL差异屏蔽了。
createsuperuser创建的后台管理员，密码是哈希存储的。如果自己写脚本创建用户，千万不要用objects.create，必须用create_user方法，这一点新手特别容易踩。
4. 核心功能实现：从注册登录到学习页
4.1 注册登录的完整实现
Django自带的认证视图能省很多事，但课程设计阶段我建议自己写一遍基础流程，既能加深理解，论文里也好写“系统实现了注册登录功能”。
注册视图的核心逻辑：
from django.contrib.auth import login from django.shortcuts import render, redirect def register(request): if request.method == 'POST': username = request.POST.get('username') password = request.POST.get('password') confirm_password = request.POST.get('confirm_password') if password != confirm_password: return render(request, 'register.html', {'error': '两次密码不一致'}) if User.objects.filter(username=username).exists(): return render(request, 'register.html', {'error': '用户名已存在'}) user = User.objects.create_user(username=username, password=password) login(request, user) return redirect('course_list') return render(request, 'register.html')注意create_user，它会自动调用set_password对密码做PBKDF2哈希，并使用Django的密码校验策略。这是绝对不能省略的环节。如果用objects.create直接存明文，用户的密码就是裸奔状态，答辩时被问到安全问题直接扣分。
登录视图可以直接用Django封装的LoginView，也可以自己写authenticate加login的组合：
from django.contrib.auth import authenticate, login def user_login(request): if request.method == 'POST': username = request.POST.get('username') password = request.POST.get('password') user = authenticate(request, username=username, password=password) if user is not None: login(request, user) return redirect('course_list') else: return render(request, 'login.html', {'error': '用户名或密码错误'}) return render(request, 'login.html')权限控制用装饰器，比如未登录用户访问学习页时强制跳登录：
from django.contrib.auth.decorators import login_required @login_required def course_study(request, course_id): ...如果想区分角色，可以自己写一个装饰器，检查request.user.role：
from functools import wraps def role_required(role): def decorator(view_func): @wraps(view_func) def wrapper(request, *args, **kwargs): if request.user.role != role: return render(request, '403.html', status=403) return view_func(request, *args, **kwargs) return wrapper return decorator这样学习页可以加@role_required('student')，管理页加@role_required('admin')，角色权限清晰可控。
4.2 课程列表、详情与选课
课程列表页用ListView加Django内置的Paginator就能搞定。这里讲一个容易被忽略的点：列表页的查询要防止N+1问题。课程列表要显示授课教师名，模板里直接通过course.teacher取值时，每一行都会多发一次查询。正确做法是：
courses = Course.objects.select_related('category', 'teacher').all()select_related会把外键关联对象一起查出来，一条SQL搞定，页面响应速度明显提升。这个优化点写进论文里，能体现你对数据库访问的理解。
课程详情页要判断当前用户是否已选这门课，没选显示“选课”按钮，选过显示“开始学习”：
def course_detail(request, course_id): course = Course.objects.get(pk=course_id) enrolled = Enrollment.objects.filter(user=request.user, course=course).exists() return render(request, 'course_detail.html', {'course': course, 'enrolled': enrolled})选课操作要考虑两点：重复选课和事务。重复选课在数据库层有unique_together兜底，视图层用exists判断即可。事务操作可以这样写：
from django.db import transaction @login_required def enroll_course(request, course_id): course = Course.objects.get(pk=course_id) if Enrollment.objects.filter(user=request.user, course=course).exists(): return redirect('course_study', course_id=course.id) with transaction.atomic(): Enrollment.objects.create(user=request.user, course=course) return redirect('course_study', course_id=course.id)4.3 学习页与进度记录
学习页是这套系统的灵魂页面。布局通常是左侧章节列表、右侧内容区。左侧用for循环渲染章节标题，右侧展示当前章节的文本内容或视频播放器。
章节内容用TextField存HTML，后台可以直接维护富文本，也可以以HTML片段形式写在模板数据里。视频课程用URL字段存视频地址，前端通过HTML5的video标签播放：
<video controls src="{{ chapter.video_url }}" style="width: 100%;"></video>视频播放完自动记录进度，可以监听video的ended事件，发AJAX请求到后端：
document.querySelector('video').addEventListener('ended', function() { fetch('/api/progress/update/', { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded', 'X-CSRFToken': getCookie('csrftoken') }, body: 'chapter_id=' + chapterId }); });这里有个大量新手踩过的坑：AJAX POST请求必须携带CSRF token，否则Django直接拒绝。很多人以为这是跨域问题，其实只是没带token。
如果做的是纯文本课程，就在每章末尾放一个“标记为已学”按钮，实现更简单。不管哪种方式，后端更新进度时要处理重复标记：
def mark_chapter_completed(request, chapter_id): if request.method == 'POST': chapter = Chapter.objects.get(pk=chapter_id) enrollment = Enrollment.objects.get(user=request.user, course=chapter.course) progress, created = StudyProgress.objects.get_or_create( enrollment=enrollment, chapter=chapter, defaults={'completed': True, 'completed_at': timezone.now()} ) if not created: progress.completed = True progress.completed_at = timezone.now() progress.save() return JsonResponse({'status': 'ok'})get_or_create加defaults的写法比先filter再create简洁，也更安全，能避免并发时重复插入。
4.4 个人中心的进度统计
用户登录后进入个人中心，展示三块信息：正在学的课程、已完成的课程、每门课的完成百分比。
百分比计算可以写成模型方法，放在Enrollment上：
class Enrollment(models.Model): ... def progress_percent(self): total = self.course.chapters.count() if total == 0: return 0 completed = self.study_progress.filter(completed=True).count() return int(completed / total * 100)模板里直接调用{{ enrollment.progress_percent }}即可。进度条用Bootstrap的progress组件，视觉效果好。这一步看似简单，但把“用户价值感”做出来了，答辩演示时很有说服力。
4.5 Admin后台配置
Admin后台是这类项目管理端的核心。配置非常简单，在courses/admin.py里注册：
from django.contrib import admin from .models import Course, Chapter class ChapterInline(admin.TabularInline): model = Chapter extra = 1 class CourseAdmin(admin.ModelAdmin): list_display = ['title', 'category', 'teacher', 'created_at'] list_filter = ['category'] inlines = [ChapterInline] admin.site.register(Course, CourseAdmin)list_display让列表页面直接看到关键字段，list_filter加分类筛选，inlines允许在课程编辑页直接添加多个章节。管理员上架一门课程时，课程信息和章节内容在一个页面搞定，体验很好。users/admin.py里也可以注册User模型，指定只显示必要字段。
5. 部署上线与常见问题排查
5.1 本地开发到服务器部署
很多同学的代码本地跑得好好的，一上服务器就各种404、500、样式丢失。这里说一下标准部署路径。
开发阶段用runserver就够了。正式部署推荐Gunicorn加Nginx加MySQL的组合：
pip install gunicorn gunicorn online_learning.wsgi:application --bind 0.0.0.0:8000 --workers 3Nginx负责反向代理和静态文件服务。配置片段大致如下：
server { listen 80; server_name your_domain.com; location /static/ { alias /path/to/online_learning/staticfiles/; } location /media/ { alias /path/to/online_learning/media/; } location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }部署前必须改几处settings：
DEBUG = False ALLOWED_HOSTS = ['your_domain.com', '你的服务器IP']然后执行collectstatic把散落在各app的静态文件收集到统一目录：
python manage.py collectstatic注意STATIC_ROOT的配置，没有它collectstatic会报错。如果服务器用MySQL，在settings里配置数据库连接，然后执行migrate。数据迁移可以用dumpdata和loaddata：
python manage.py dumpdata > data.json python manage.py loaddata data.jsondumpdata导出的JSON包含了用户和业务数据，loaddata导入即可。注意两边的表结构要一致，否则loaddata会报错。
5.2 部署踩坑实录
我帮人排查过很多次部署问题，高频踩坑集中在以下几处。
静态文件404。症状是页面有结构没样式。原因基本是STATIC_ROOT和STATICFILES_DIRS没配对，或者Nginx的alias路径写错。解决顺序是：先确认本地runserver能正常加载样式，再确认collectstatic执行成功，最后检查Nginx的alias路径。
媒体文件不显示。图片上传成功但访问404。原因是MEDIA_URL没有对应的Nginx location。很多部署教程只写了static，漏掉media，导致课程封面图全挂。
时区问题。数据库里存的创建时间比本地时间晚了8小时，因为Django默认TIME_ZONE是UTC。改这两个变量：
TIME_ZONE = 'Asia/Shanghai' USE_TZ = True注意改了之后，已入库的时间不会自动转换，需要重新写入或在前端做格式化处理。
5.3 常见问题速查表
| 症状 | 常见原因 | 处理办法 |
|---|---|---|
| 注册后密码变成明文存库 | 用了objects.create而非create_user | 改用create_user或在视图里调用set_password |
| 明明已登录，访问受限页面仍跳登录 | 登录视图没有调用login，或session中间件误删 | 检查登录视图是否调用login(request, user) |
| 页面样式全部丢失 | 静态文件配置不全 | 检查STATIC_URL、STATICFILES_DIRS、STATIC_ROOT |
| 图片上传成功但访问404 | 缺少media路由或Nginx未配media | 本地在urls.py加media路由，服务器加Nginx location |
| AJAX保存进度返回403 | 请求未携带CSRF token | 在fetch或XHR中设置X-CSRFToken请求头 |
| 上传图片报错类型错误 | 未安装Pillow | pip install pillow |
| 视频无法播放 | 视频URL跨域或格式浏览器不支持 | 更换为mp4格式，或确认视频服务器允许跨域访问 |
| 后台管理里看不到自定义模型 | 未在admin.py注册模型 | 在对应app的admin.py中注册模型类 |
| 列表页响应非常慢 | N+1查询 | 加select_related或prefetch_related |
6. 围绕课程设计再聊几点经验
6.1 论文和答辩的展示重点
如果这套系统用于毕业设计，论文结构和答辩展示要有侧重点。论文一般分：绪论、需求分析、系统设计、数据库设计、系统实现、系统测试、总结。每一章都有对应的代码和素材可填。
需求分析章节，把前面的用户路径和功能清单展开写，配用例表。系统设计章节，画系统架构图和功能模块图。数据库设计章节，画ER图，把每张表的字段列表贴出来。系统实现章节，按模块贴核心代码，配上页面截图和运行效果说明。系统测试章节，写功能测试用例，比如重复选课、权限拦截、未登录访问这些场景。
答辩时建议按这个顺序演示：先演示学生注册登录，再演示管理员后台发布一门课程，然后学生端选课学习、进度更新，最后展示个人中心的进度统计。这个顺序能完整覆盖系统的所有亮点，而且逻辑连贯。
常见答辩问题提前准备：
- 为什么选Django？回答框架对比和开发效率。
- 如何保证密码安全？回答Django的PBKDF2哈希和set_password机制。
- 重复选课如何防止？回答数据库唯一约束加视图层判断。
- 学习进度怎么记录？回答StudyProgress模型和章节完成标记。
- 系统瓶颈可能在哪？回答视频播放对带宽的消耗和数据库查询优化。
6.2 这套系统的扩展方向
做完基础版之后，如果时间和能力允许，有几个方向值得扩展。
接入Redis做缓存，把课程列表页的热门数据缓存起来，降低数据库压力。这是写进论文里很亮眼的性能优化点。
用Django REST Framework把核心接口改造成RESTful API，前端用Vue或React重写，系统就从前后端不分离升级为前后端分离架构，技术含量明显提升。
增加在线测试模块，课程学完后可以答题自测，自动判分。这是在线学习系统很自然的功能扩展，也能体现业务完整性。
增加数据可视化，用ECharts展示平台课程数量、用户活跃度、学习时长趋势等统计图表，管理端报表的专业感会强很多。
我个人经手过不少类似项目，最大的体会是：这类系统难的不是某个技术点，而是把所有模块串成一个完整闭环。很多同学写代码时只关心页面能不能显示，忽略了数据关系、权限控制、异常处理这些“看不见”的部分，结果一部署就露馅。
如果你正在做类似的系统，建议按这个顺序推进：先画业务路径，再建数据模型，然后逐步实现功能，最后再谈部署优化。过程中多想想“为什么”，比如为什么用户模型要先自定义、为什么选课要做唯一约束、为什么进度要单独建表，这些思考会让你在答辩和面试中表现得完全不一样。
最后分享一个小技巧：开发时给每个功能模块写一段简单的验证脚本，不用多全面，至少保证核心流程能跑通。我见过太多项目，开发时功能是好的，演示前改了个小地方，整个流程崩了，最后只能手动回滚。做好版本管理，经常提交代码，关键时刻能救命。
