简介：这是一套面向计算机相关专业学生与项目实战学习者的Django图书管理系统完整源码，可直接用于毕业设计、课程设计或期末大作业。项目经导师指导并评审通过，代码完整可运行，对刚接触Django的初学者同样友好。压缩包共59个文件，约3.49MB，包含16个py业务代码文件、19个html前端模板、18个pyc编译文件，以及sqlite3数据库、css与scss样式、md说明文档，另附pdf与doc格式的项目报告，覆盖从后端逻辑、页面渲染到数据库存储的完整链路。目录中manage.py、library应用与templates模板分层清晰，便于按模块阅读与二次修改。已有78人学习关注。读者可据此掌握Django的MVT架构、路由配置、模型设计与模板继承等核心知识点，并借助配套报告文档理解系统设计思路与实现细节，快速完成项目搭建与答辩准备。
1. 从零手搓 Django 图书管理系统：这套源码和报告文档到底值不值得跑一遍
如果你正在搜「Python 基于 Django 图书管理系统源码+报告文档」，大概率是三种人之一：课程设计卡在最后一周、想拿一份能跑通的 Django 项目实战练手、或者需要一份带文档的完整交付物交差。我当年第一次做这类系统时，最崩溃的不是写不出增删改查，而是借阅状态、库存联动、逾期计算这三块逻辑一改就崩，改完还找不到哪里错了。这套方案的核心价值就在于：它把「图书—读者—借阅记录」三张表的关系用 Django ORM 串成了一条闭环，并且配了报告文档，让你既能跑起来，也能讲清楚为什么这么设计。适合有 Python 基础、装过 Django、但没独立做过完整业务系统的人。下面我按「环境怎么搭 → 模型怎么设计 → 借阅逻辑怎么写 → 坑在哪 → 怎么验证」的顺序，把能抄作业的部分全给你。
2. 环境搭建与项目骨架：怎样安装 Django 并创建第一个 app
2.1 版本选型：为什么我建议 Django 4.2 LTS 而不是最新版
很多人一上来就pip install django装最新版，结果教程里的url()写法全报错。Django 从 4.0 开始url()基本被re_path()和path()取代，网上大量老教程还在用url()，新手照着抄直接翻车。我的建议是锁 4.2 LTS，它是长期支持版，官方维护到 2026 年，第三方库兼容性最好，报告文档里写版本号也显得专业。
Python 版本选 3.10 或 3.11，别用 3.12 刚出时的早期小版本，某些数据库驱动还没跟上。数据库开发阶段直接用 SQLite，零配置，交付时如果老师要求 MySQL 再切，切换成本很低，因为 Django ORM 屏蔽了大部分差异。
# 创建虚拟环境，避免污染全局 Python python -m venv venv # Windows 激活 venv\Scripts\activate # macOS / Linux 激活 source venv/bin/activate # 锁定版本安装，报告文档里写清楚版本号 pip install django==4.2.11 # 验证安装 python -m django --version这里python -m django比直接敲django-admin更稳，因为前者用的是当前解释器，能避免多版本 Python 环境下命令找不到的玄学问题。虚拟环境这一步别省，我见过太多人因为全局装了七八个包，最后migrate报一堆依赖冲突，排查两小时。
2.2 创建项目与 app：目录结构决定你后期好不好维护
# 创建项目，注意结尾的点，避免多套一层目录 django-admin startproject library_sys . # 创建图书管理核心 app python manage.py startapp books # 创建用户管理 app（借阅人信息） python manage.py startapp accounts结尾那个.是血泪经验：不加的话会生成library_sys/library_sys/settings.py两层嵌套，后期导包路径能把你绕晕。app 拆分上，books管图书和借阅，accounts管读者，职责清晰。如果你把所有逻辑塞一个 app，报告文档里画架构图会很难看，答辩时老师一问「模块怎么划分的」就露馅。
创建完 app 必须去settings.py注册，否则模型不生效：
# library_sys/settings.py INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'books', # 注册图书 app 'accounts', # 注册用户 app ] # 中文界面，报告文档截图更友好 LANGUAGE_CODE = 'zh-hans' TIME_ZONE = 'Asia/Shanghai' USE_TZ = False # 关闭时区，避免借阅时间差 8 小时的坑USE_TZ = False这个参数新手最容易忽略。默认True时，数据库存 UTC 时间，你页面上显示借阅时间会比实际早 8 小时，逾期判断直接错乱。开发阶段关掉它，用本地时间，省心。
3. 数据模型设计：图书、读者、借阅记录三张表怎么建才不返工
3.1 核心模型字段与关系定义
图书管理系统的命门在模型设计。设计错了，后面写借阅逻辑就是不断打补丁。核心是三张表：Book（图书）、Reader（读者）、BorrowRecord（借阅记录）。借阅记录是中间表，用外键关联前两者，同时记录借出时间、应还时间、归还时间、状态。
# books/models.py from django.db import models from django.contrib.auth.models import User class Book(models.Model): isbn = models.CharField('ISBN', max_length=13, unique=True) title = models.CharField('书名', max_length=100) author = models.CharField('作者', max_length=50) publisher = models.CharField('出版社', max_length=50, blank=True) total_copies = models.PositiveIntegerField('总库存', default=1) available_copies = models.PositiveIntegerField('可借数量', default=1) created_at = models.DateTimeField('入库时间', auto_now_add=True) class Meta: verbose_name = '图书' verbose_name_plural = verbose_name def __str__(self): return self.title class Reader(models.Model): user = models.OneToOneField(User, on_delete=models.CASCADE) student_id = models.CharField('学号', max_length=20, unique=True) phone = models.CharField('手机号', max_length=11, blank=True) max_borrow = models.PositiveIntegerField('最大可借数', default=5) def __str__(self): return self.student_id class BorrowRecord(models.Model): STATUS_CHOICES = ( ('borrowed', '借阅中'), ('returned', '已归还'), ('overdue', '已逾期'), ) book = models.ForeignKey(Book, on_delete=models.CASCADE, related_name='records') reader = models.ForeignKey(Reader, on_delete=models.CASCADE, related_name='records') borrow_date = models.DateTimeField('借出时间', auto_now_add=True) due_date = models.DateTimeField('应还时间') return_date = models.DateTimeField('归还时间', null=True, blank=True) status = models.CharField('状态', max_length=10, choices=STATUS_CHOICES, default='borrowed') class Meta: ordering = ['-borrow_date'] # 默认按借出时间倒序 def __str__(self): return f'{self.reader.student_id} - {self.book.title}'关键点解释：available_copies和total_copies分开存，是为了处理「同一本书多本库存」的场景。related_name='records'让你能反向查询，比如book.records.all()拿到这本书所有借阅记录，写统计功能时非常方便。on_delete=models.CASCADE表示删除图书时连带删除借阅记录，如果你希望保留历史记录，改成PROTECT或SET_NULL，但那样book字段要允许为空。
3.2 迁移与后台注册：让数据先跑起来
# 生成迁移文件 python manage.py makemigrations # 执行迁移，建表 python manage.py migrate # 创建超级用户，用于登录 admin 后台 python manage.py createsuperuser迁移报错最常见的原因是模型里用了default没给值，或者外键指向的模型还没定义。遇到no such table先检查migrate有没有执行成功，别急着改代码。
后台注册能让老师直观看到数据管理能力，报告文档里截图也好看：
# books/admin.py from django.contrib import admin from .models import Book, Reader, BorrowRecord @admin.register(Book) class BookAdmin(admin.ModelAdmin): list_display = ('isbn', 'title', 'author', 'total_copies', 'available_copies') search_fields = ('title', 'author', 'isbn') @admin.register(BorrowRecord) class BorrowRecordAdmin(admin.ModelAdmin): list_display = ('reader', 'book', 'borrow_date', 'due_date', 'status') list_filter = ('status',)list_display控制列表页显示哪些列，search_fields开启搜索框，list_filter加右侧筛选。这三个配置是后台体验的分水岭，不加的话后台就是个光秃秃的表格，答辩演示时很掉价。
4. 借阅核心逻辑：库存联动、逾期判断与归还处理怎么写
4.1 借书流程：事务保证库存不超卖
借书是最容易出 bug 的地方。两个人同时借最后一本书，如果不加锁，库存会变成 -1。Django 用transaction.atomic加select_for_update解决并发问题。
# books/services.py from django.db import transaction from django.utils import timezone from datetime import timedelta from .models import Book, Reader, BorrowRecord @transaction.atomic def borrow_book(reader_id, book_id, days=30): # 锁定图书行，防止并发超借 book = Book.objects.select_for_update().get(id=book_id) reader = Reader.objects.get(id=reader_id) # 校验库存 if book.available_copies <= 0: raise ValueError('该书已全部借出') # 校验读者借阅上限 active_count = BorrowRecord.objects.filter( reader=reader, status='borrowed' ).count() if active_count >= reader.max_borrow: raise ValueError(f'已达最大可借数 {reader.max_borrow}') # 扣库存 book.available_copies -= 1 book.save() # 创建借阅记录，应还时间 = 当前 + 30 天 due = timezone.now() + timedelta(days=days) record = BorrowRecord.objects.create( book=book, reader=reader, due_date=due ) return recordselect_for_update()必须在事务里用，它会对数据库行加排他锁，第二个请求会等第一个完成再读，读到的是扣减后的库存。days=30是借阅周期，做成参数方便调整。active_count统计的是「借阅中」状态，已归还的不算，这个细节很多人写错，导致读者还了书还提示超限。
4.2 还书与逾期：状态流转和罚款计算
# books/services.py 续 @transaction.atomic def return_book(record_id): record = BorrowRecord.objects.select_for_update().get(id=record_id) if record.status == 'returned': raise ValueError('该记录已归还') now = timezone.now() record.return_date = now # 判断是否逾期 if now > record.due_date: record.status = 'overdue' overdue_days = (now - record.due_date).days # 逾期罚款，每天 0.5 元，可按需调整 record.fine = overdue_days * 0.5 else: record.status = 'returned' record.save() # 库存回加 book = record.book book.available_copies += 1 book.save() return record逾期判断用now > record.due_date，注意due_date存的是具体时间点，不是日期。如果你只想要「按天算」，可以在比较前把时间归零到当天 0 点，否则 30 天借期的书在第 30 天下午还，可能被判逾期。这个边界我踩过，报告文档里专门写了一段说明，答辩时老师还夸考虑周全。
fine字段上面模型没定义，需要补一个fine = models.DecimalField('罚款', max_digits=6, decimal_places=2, default=0)，然后重新迁移。罚款金额用DecimalField不用FloatField，避免浮点误差，这是财务类字段的基本素养。
4.3 视图与 URL：把逻辑接到页面上
# books/views.py from django.shortcuts import render, redirect, get_object_or_404 from django.contrib.auth.decorators import login_required from .models import Book, BorrowRecord from .services import borrow_book, return_book @login_required def book_list(request): keyword = request.GET.get('q', '') books = Book.objects.all() if keyword: books = books.filter(title__icontains=keyword) return render(request, 'books/book_list.html', {'books': books}) @login_required def do_borrow(request, book_id): reader = request.user.reader try: borrow_book(reader.id, book_id) except ValueError as e: return render(request, 'books/error.html', {'msg': str(e)}) return redirect('book_list')@login_required保证只有登录用户能操作，request.user.reader通过 OneToOne 反向拿到读者对象。title__icontains是大小写不敏感的模糊查询，搜索功能必备。异常用ValueError捕获后渲染错误页，比直接 500 报错友好得多。
URL 配置：
# books/urls.py from django.urls import path from . import views urlpatterns = [ path('', views.book_list, name='book_list'), path('borrow/<int:book_id>/', views.do_borrow, name='do_borrow'), ]<int:book_id>是路径转换器，自动把 URL 里的数字转成 int 传给视图，比正则清爽。name='book_list'用于模板里{% url 'book_list' %}反向解析，改 URL 时不用满项目找硬编码。
5. 避坑与排查：这套源码跑不起来时先看这五条
5.1 报错 No module named 'django'
现象：命令行敲python manage.py runserver提示找不到 django。原因：虚拟环境没激活，或者 pip 装到了别的 Python 版本下。解决：先which python（Windows 用where python）确认当前解释器路径在 venv 里，再pip list看 django 在不在。不在就重新pip install django==4.2.11。我一般会在项目根目录放个requirements.txt，换机器时pip install -r requirements.txt一把梭。
5.2 迁移后 admin 后台登录报错 no such table
现象：createsuperuser成功了，但登录后台 500。原因：migrate没跑，或者中途报错被忽略。解决：删掉db.sqlite3和 app 下migrations里除__init__.py外的文件，重新makemigrations+migrate。注意别删__init__.py，否则 Django 不认这个迁移目录。
5.3 借阅后库存显示不对
现象：借了一本书，available_copies没减，或者减了两次。原因：视图里既调用了 service 又手动改了库存，重复扣减。解决：库存变更只在一个地方做，统一走borrow_book/return_book服务函数，视图层不碰模型字段。这是分层设计的意义，报告文档里可以专门写一节「业务逻辑与视图分离」。
5.4 时间显示差 8 小时
现象：借阅记录时间比实际早 8 小时。原因：USE_TZ = True且没配时区。解决：开发阶段设USE_TZ = False，TIME_ZONE = 'Asia/Shanghai'。如果必须用 UTC，模板里用{% load tz %}加localtime过滤器转换。这个坑我在三个项目里都遇到过，属于 Django 新手必修课。
5.5 静态文件 404，页面没样式
现象：HTML 能打开，但 CSS/JS 全 404。原因：DEBUG=True时 Django 不自动服务静态文件，需要配STATIC_URL和STATICFILES_DIRS。解决：在settings.py里加STATICFILES_DIRS = [BASE_DIR / 'static']，模板顶部{% load static %}，引用写成{% static 'css/style.css' %}。部署时还要collectstatic，但课程设计阶段开发服务器够用。
6. 报告文档怎么写才像高分项目：结构、图表与验证技巧
报告文档不是代码的复述，而是讲清楚「你为什么这么设计」。我一般按这个结构写：需求分析（谁用、解决什么问题）、技术选型（为什么 Django 不是 Flask）、系统设计（E-R 图、模块图）、核心实现（贴关键代码 + 解释）、测试验证（截图 + 边界用例）、总结展望。E-R 图用 draw.io 画，三张表的关系一目了然，比纯文字强十倍。
验证环节最容易被忽略。别只截个「借书成功」的图，要设计边界用例：库存为 0 时借书、超过最大可借数、逾期归还、重复归还同一本书。每个用例截一张图，配上预期结果和实际结果。我当年答辩时，老师专门问了「并发借书怎么处理」，我把select_for_update那段代码和测试截图一摆，直接加分。
一个具体技巧：用 Django 的TestCase写自动化测试，跑一遍全绿，报告里贴测试输出，比手动点页面有说服力。
# books/tests.py from django.test import TestCase from django.contrib.auth.models import User from .models import Book, Reader from .services import borrow_book class BorrowTest(TestCase): def setUp(self): user = User.objects.create_user('test', password='123456') self.reader = Reader.objects.create(user=user, student_id='2024001') self.book = Book.objects.create( isbn='9787111111111', title='测试书', author='张三', total_copies=1, available_copies=1 ) def test_borrow_success(self): record = borrow_book(self.reader.id, self.book.id) self.book.refresh_from_db() self.assertEqual(self.book.available_copies, 0) self.assertEqual(record.status, 'borrowed') def test_borrow_no_stock(self): self.book.available_copies = 0 self.book.save() with self.assertRaises(ValueError): borrow_book(self.reader.id, self.book.id)setUp里造数据，每个测试方法独立跑，互不干扰。refresh_from_db()重新从数据库读，因为 service 里改的是另一个对象实例。assertRaises验证异常抛出，这是测试负面路径的标准写法。跑python manage.py test全绿，报告文档里截图一贴，可信度直接拉满。
最后说个习惯：我每改完一个功能就git commit一次，commit message 写清楚改了什么。报告文档里的「开发日志」章节直接从 git log 导出，时间线清清楚楚，老师一看就知道是你一步步做的，不是网上下的。这套源码和文档的价值不在于代码多复杂，而在于每个决策都有理由、每个坑都有记录。希望帮到你。
本文还有配套的精品资源，点击获取
