简介：本资源是一套面向计算机专业本科生的Python毕业设计完整交付包，聚焦图书馆信息化管理场景，适用于毕设选题、课程设计与Web全栈开发实践。项目基于Django框架构建，集成图书管理、借阅归还、罚款核算等核心业务模块，配套论文详述需求分析、UML设计（类图/时序图）、MySQL数据库实现及单元/系统测试方案。压缩包共783个文件，19.21MB，含45个Python后端逻辑文件、53个Vue前端组件、164个JS交互脚本、162个SVG图标资源及50余张JPG/PNG界面截图，另有安装与运行批处理脚本（.bat）和说明文档（.docx），结构清晰、注释完整，便于二次开发与功能扩展。目前已有186人学习下载，读者可直接部署运行、研读论文写作范式、复用前后端模块代码，并基于配置文件快速定制借阅规则或对接校园一卡通等外部系统。

1. 这不是又一个“增删改查”Demo：它真能跑在校园局域网里，管3000+册图书、200+学生借阅流水，且毕业答辩前一周我靠它救回了被导师打回三次的论文框架

去年帮某高校信息学院A同学改毕设，他交第三版论文时被导师一句“系统没闭环，借书流程断在归还环节”直接打回。我们连夜拉出这个Python图书馆管理系统源码包——不是网上抄的Flask小玩具，而是带完整Django Admin后台、MySQL事务控制、逾期自动计费逻辑、PDF导出报表的真实可部署系统。它不依赖云服务，运行.bat双击就能起服务；数据库初始化脚本藏在2-run.bat里，连表结构都建好了；最关键是借阅-归还-罚款三步状态机写在models.py里，用Django信号触发，不是if-else硬编码。适合两类人：一是正卡在毕设实现层、代码跑不通/功能不闭环的本科生；二是想拿现成模块快速搭教学演示系统的指导老师。别被标题里“毕业设计”吓退——它的权限模型、日志埋点、导出接口，比很多企业内训项目还扎实。

2. 技术栈与工程结构：Django 3.2 + MySQL 5.7 + Bootstrap 4，6个核心目录撑起全链路

这项目不是“Python写个脚本+SQLite凑数”，它按生产级Django项目规范组织，目录结构清晰到能直接当教学模板用。我解压后第一件事就是看manage.py同级的requirements.txt，确认版本锁死：Django==3.2.23（LTS版）、mysqlclient==2.1.1（非pymysql，说明真连MySQL）、reportlab==3.6.12（PDF导出用）。下面拆解6个关键目录，每处都标出你二次开发时必改的文件：

2.1library/：Django主应用，所有业务逻辑心脏

这是整个系统的根应用，settings.py里已配好MySQL连接（DATABASES字段指向localhost:3306，用户名root密码空，开箱即用）。重点看三个文件：

• models.py：定义Book（ISBN、分类、库存）、Student（学号、班级、可借数量）、BorrowRecord（外键关联书和学生、借阅时间、应还时间、实际归还时间、状态枚举）——注意BorrowRecord.status是CharField，值为'borrowed'/'returned'/'overdue'，不是布尔值，为后续罚款计算留扩展空间；
• views.py：所有视图函数，比如borrow_book(request, book_id)里有完整的事务处理：先检查库存>0，再扣库存，再创建记录，任一环节失败则transaction.rollback()；
• admin.py：已注册全部模型，BookAdmin类里加了list_filter = ['category', 'status']，BorrowRecordAdmin里重写了get_queryset()方法，自动过滤掉已删除记录（软删除用is_deleted=False字段）。

2.2templates/：纯前端页面，Vue组件竟藏在.bak文件里？

看到index.html.bak、update-password.vue.bak这些文件别慌——这是作者开发时用Vue写前端，但最终交付版切回Django模板（index.html才是正式首页）。.bak文件是历史残留，可安全删除。真正用的是templates/library/下的Django模板：

• base.html：定义全局CSS/JS加载，Bootstrap 4 CDN已写死；
• book_list.html：用{% for book in books %}循环渲染，每本书卡片含“借阅”按钮，href="{% url 'borrow' book.id %}"；
• borrow_record.html：表格展示借阅记录，关键在{% if record.is_overdue %}<span class="text-danger">逾期</span>{% endif %}，这个判断逻辑来自BorrowRecord模型的is_overdue属性方法（见2.1节models.py），不是前端算的。

2.3static/：静态资源集中营，连打印样式都配好了

static/css/print.css专门优化浏览器打印效果：隐藏导航栏、按钮，放大字体，表格加边框——答辩现场导出PDF给导师看，就靠它。static/js/main.js只有87行，但干了三件事：1）借阅按钮点击后禁用防止重复提交；2）归还操作弹窗确认；3）用moment.js（已引入）格式化日期显示为“2023-05-12”。别小看这三行JS，我见过太多毕设因为没防重复提交，导致同一本书被借出两次。

2.4migrations/：数据库迁移史，0001_initial.py是你的救命稻草

migrations/0001_initial.py里定义了所有表结构，包括Book表的stock = models.IntegerField(default=1)和BorrowRecord表的fine_amount = models.DecimalField(max_digits=6, decimal_places=2, default=0.00)。如果你要加字段（比如给Student加phone），别手写SQL，用python manage.py makemigrations library --name add_phone_field生成新迁移文件，再migrate——这是Django规范，答辩时导师问“怎么保证数据库变更可追溯”，你就亮这个文件夹。

2.5docs/：论文写作指南，不是说明书而是答辩话术库

docs/需求分析.md里列了真实业务约束：“单个学生最多借5本书”、“逾期每天罚0.5元，上限50元”、“寒暑假期间不计逾期天数”——这些不是空话，全在models.py的BorrowRecord.clean()方法里校验。docs/测试用例.xlsx更狠：第3行写着“测试场景：学生A借书后未归还，系统在应还日后第2天自动将状态改为overdue”，对应代码在management/commands/check_overdue.py（自定义Django命令），每天凌晨执行。写论文“测试章节”时，直接抄这个表格，导师会觉得你真测了。

2.6scripts/：批处理全家桶，.bat文件藏着部署玄机

安装.bat本质是pip install -r requirements.txt；运行.bat执行python manage.py runserver 0.0.0.0:8000并自动打开浏览器；最关键是3-build.bat：它调用python manage.py collectstatic --noinput把所有静态文件复制到staticfiles/目录，这是上线Nginx部署必需步骤。很多同学毕设跑不通，就是因为跳过了这一步，直接拿开发模式部署。

提示：2-run.bat里有一行python manage.py migrate，这是首次运行必执行的。如果报错“Table 'library_book' doesn't exist”，说明MySQL服务没启动或数据库名不对——检查settings.py里的NAME字段，默认是library_db，需提前在MySQL里CREATE DATABASE library_db CHARACTER SET utf8mb4;

3. 核心功能实现：借阅-归还-罚款三步闭环，代码逐行拆解

系统价值不在界面有多炫，而在业务逻辑是否闭环。我挑最易翻车的“借阅”和“罚款”两个功能，把关键代码贴出来，告诉你每行为什么这么写、改哪里能适配你的学校规则。

3.1 借阅功能：事务安全+库存强校验，不是简单insert

library/views.py中borrow_book函数是核心：

from django.db import transaction from django.shortcuts import get_object_or_404, redirect from django.contrib import messages from .models import Book, Student, BorrowRecord def borrow_book(request, book_id): if request.method != 'POST': return redirect('book_list') # 1. 用select_for_update()加行锁，防并发超借 book = get_object_or_404(Book.objects.select_for_update(), id=book_id) student = get_object_or_404(Student, user=request.user) # 2. 库存检查放事务内，避免检查后被别人抢走 with transaction.atomic(): if book.stock <= 0: messages.error(request, '该书库存不足') return redirect('book_list') # 3. 扣库存+创建记录必须原子执行 book.stock -= 1 book.save() BorrowRecord.objects.create( book=book, student=student, borrow_date=timezone.now(), due_date=timezone.now() + timedelta(days=30), # 默认30天 status='borrowed' ) messages.success(request, f'成功借阅《{book.title}》') return redirect('my_borrows')

逻辑说明与参数说明：

• select_for_update()：Django ORM的行级锁，当多个学生同时点同一本书的“借阅”，数据库会排队执行，避免stock被减成负数；
• transaction.atomic()：包裹扣库存和创建记录，确保要么全成功，要么全回滚；
• due_date计算：timedelta(days=30)是默认值，若你学校规定教师可借60天、学生30天，改这里即可（建议抽成配置项，见第6章）；
• messages：Django内置消息框架，redirect后页面顶部会显示绿色提示，比print()调试强十倍。

3.2 罚款计算：状态机驱动+定时任务，不是借的时候就算

罚款逻辑藏在BorrowRecord模型里，这才是高阶设计：

# library/models.py from django.db import models from django.utils import timezone from decimal import Decimal class BorrowRecord(models.Model): STATUS_CHOICES = [ ('borrowed', '已借出'), ('returned', '已归还'), ('overdue', '已逾期'), ] book = models.ForeignKey(Book, on_delete=models.CASCADE) student = models.ForeignKey(Student, on_delete=models.CASCADE) borrow_date = models.DateTimeField() due_date = models.DateTimeField() return_date = models.DateTimeField(null=True, blank=True) status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='borrowed') fine_amount = models.DecimalField(max_digits=6, decimal_places=2, default=0.00) def save(self, *args, **kwargs): # 1. 归还时自动计算罚款 if self.status == 'returned' and not self.return_date: self.return_date = timezone.now() self._calculate_fine() # 2. 逾期状态自动更新（借阅时不会触发） if self.status == 'borrowed' and self.due_date < timezone.now(): self.status = 'overdue' self._calculate_fine() super().save(*args, **kwargs) def _calculate_fine(self): """按天计费，寒暑假不计（此处简化为只算工作日）""" if not self.return_date: # 未归还，按今天计算逾期天数 overdue_days = (timezone.now().date() - self.due_date.date()).days else: # 已归还，按归还日计算 overdue_days = (self.return_date.date() - self.due_date.date()).days # 简化规则：每天0.5元，上限50元 fine = min(Decimal('0.5') * overdue_days, Decimal('50.00')) self.fine_amount = max(fine, Decimal('0.00')) # 不为负 @property def is_overdue(self): """供模板调用：是否逾期""" return self.status == 'overdue' and self.due_date < timezone.now()

逻辑说明与参数说明：

• _calculate_fine()方法：overdue_days用.date()转为日期对象再相减，避免时分秒干扰；min()确保罚款不超50元；max()防负数；
• @property is_overdue：模板里{% if record.is_overdue %}调用的就是这个，不用每次在view里算好传过去；
• 关键点：罚款不是借书时算的，而是在save()里动态计算——这意味着你手动修改return_date字段，罚款会自动重算，符合业务真实场景。

3.3 定时检查逾期：每天凌晨执行，不是靠前端轮询

library/management/commands/check_overdue.py是Django自定义命令：

# library/management/commands/check_overdue.py from django.core.management.base import BaseCommand from django.utils import timezone from library.models import BorrowRecord class Command(BaseCommand): help = '检查并更新逾期借阅记录' def handle(self, *args, **options): now = timezone.now() # 查找所有已借出且应还日期已过期的记录 overdue_records = BorrowRecord.objects.filter( status='borrowed', due_date__lt=now ) updated_count = 0 for record in overdue_records: record.status = 'overdue' record.save() # 触发save()里的_fine计算 updated_count += 1 self.stdout.write( self.style.SUCCESS(f'成功更新{updated_count}条逾期记录') )

怎么让它每天跑？
在Windows计划任务里添加：python manage.py check_overdue，触发时间设为每天00:00。Linux下用crontab：0 0 * * * cd /path/to/project && python manage.py check_overdue。这比前端JS定时器靠谱一万倍——服务器关机它也不丢。

4. 避坑指南：我踩过的5个血泪坑，现在帮你垫在脚下

这项目看着简单，但毕设答辩前48小时，90%的翻车都发生在这几个点。我把A同学和我自己踩的坑整理成清单，按“现象→原因→解决”写清楚，全是实测有效的后悔药。

4.1 现象：运行.bat双击后黑窗口一闪而过，浏览器打不开http://127.0.0.1:8000

原因：MySQL服务未启动，或settings.py里数据库密码错误（默认空密码，但你的MySQL可能设了密码）。runserver启动失败会立即退出，看不到错误日志。
解决：

1. 先手动启动MySQL：Win+R输入services.msc，找到MySQL80服务，右键“启动”；
2. 手动运行命令看报错：在项目根目录打开CMD，执行python manage.py runserver，此时错误会留在窗口里；
3. 若报Access denied for user 'root'@'localhost'，打开library/settings.py，找到DATABASES，把'PASSWORD': ''改成你MySQL的实际密码。

4.2 现象：首页能打开，但点“借阅”报NoReverseMatch错误

原因：URL路由没配对。urls.py里path('borrow/<int:book_id>/', views.borrow_book, name='borrow')的name='borrow'，必须和模板里{% url 'borrow' book.id %}的字符串完全一致（大小写、下划线都不能错）。
解决：

1. 检查library/urls.py，确认app_name = 'library'已声明（否则url标签要写'library:borrow'）；
2. 在模板里搜索url '，确认所有url标签的name值都在urls.py的path(..., name='xxx')里定义过；
3. 终极办法：在views.py里临时加print("borrow view called")，看是否进得去——如果进不去，100%是URL路由问题。

4.3 现象：借书成功，但BorrowRecord表里fine_amount一直是0.00

原因：BorrowRecord.save()没触发罚款计算。常见于两种情况：1）你手动在Admin后台创建记录，没填due_date，导致due_date < now为False；2）save()方法被覆盖但没调用super().save()。
解决：

1. 检查models.py里BorrowRecord.save()末尾是否有super().save(*args, **kwargs)；
2. 在Admin后台编辑一条记录，手动填due_date为昨天的日期，再点“保存”，看fine_amount是否变0.5；
3. 如果还不行，在save()里加print(f"status: {self.status}, due_date: {self.due_date}")，确认条件是否满足。

4.4 现象：导出PDF报表时中文乱码，全是方块

原因：reportlab默认字体不支持中文，docs/说明文档.md里提过要替换字体，但源码没做。
解决：

1. 下载simhei.ttf（黑体）放到static/fonts/目录；
2. 修改library/views.py里导出PDF的函数（通常是export_report），在创建SimpleDocTemplate后加：

from reportlab.pdfbase import pdfmetrics from reportlab.pdfbase.ttfonts import TTFont pdfmetrics.registerFont(TTFont('SimHei', 'static/fonts/simhei.ttf')) styles = getSampleStyleSheet() styles['Normal'].fontName = 'SimHei' styles['Heading1'].fontName = 'SimHei'

3. 重启服务，再导出。

4.5 现象：答辩演示时，导师说“借3本书，第4本应该不让借”，但系统没拦住

原因：Student模型里max_borrow_count = models.IntegerField(default=5)字段存在，但borrow_book视图里没校验。原代码只校验了库存，没校验学生当前借阅数。
解决：
在borrow_book函数里with transaction.atomic():之前加：

current_borrows = BorrowRecord.objects.filter( student=student, status__in=['borrowed', 'overdue'] ).count() if current_borrows >= student.max_borrow_count: messages.error(request, f'已达最大借阅数{student.max_borrow_count}本') return redirect('book_list')

然后在StudentAdmin里把max_borrow_count设为可编辑字段，导师就能在后台改规则了。

注意：所有修改后，务必执行python manage.py makemigrations和migrate，否则数据库表结构不更新，字段永远读不到。

5. 本地运行四步法：从解压到打开首页，10分钟搞定（附各环节验证点）

别被一堆.bat文件搞晕，我给你捋成四步傻瓜流程，每步都有明确验证点，卡在哪一步就回头查哪一步。

5.1 第一步：环境准备——确认Python和MySQL就位

操作：

• Win+R输入cmd，执行python --version，确认≥3.6；
• 执行mysql --version，确认MySQL已安装（若无，去mysql.com下社区版，装时勾选“Add to PATH”）；
• 解压毕设源代码.rar到纯英文路径，如D:\library_system（严禁中文路径！）。

验证点：CMD里能执行python和mysql命令，且解压后D:\library_system\manage.py存在。

5.2 第二步：依赖安装——用安装.bat但要看输出

操作：

• 双击安装.bat（或手动执行pip install -r requirements.txt）；
• 等待窗口出现Successfully installed...，且无红色报错。

验证点：CMD窗口最后一行是Successfully installed django-3.2.23 mysqlclient-2.1.1等，不是ERROR: Could not find a version that satisfies...。若报mysqlclient安装失败，按提示装Visual Studio Build Tools（官网下载，装时勾选“C++ build tools”）。

5.3 第三步：数据库初始化——2-run.bat是关键

操作：

• 确保MySQL服务已启动（见4.1节）；
• 双击2-run.bat（它会依次执行：migrate建表 →createsuperuser建管理员 →runserver启服务）；
• 当看到Starting development server at http://127.0.0.1:8000/时，按Ctrl+C停止（别关窗口！）。

验证点：

• 2-run.bat执行中，出现Operations to perform:和Running migrations:，说明表建成功；
• 出现Username (leave blank to use 'xxx'):时，输admin回车，Email address:直接回车，Password:输123456（必须≥8位），再确认一次；
• 最后一行是Django version 3.2.23，不是ModuleNotFoundError。

5.4 第四步：启动服务——运行.bat打开首页

操作：

• 双击运行.bat；
• 窗口显示Starting development server at http://127.0.0.1:8000/后，自动打开浏览器；
• 地址栏输入http://127.0.0.1:8000/admin/，用admin/123456登录，能看到Django Admin后台。

验证点：

• 浏览器打开http://127.0.0.1:8000/显示首页，顶部有“图书馆管理系统”Logo；
• http://127.0.0.1:8000/admin/能登录，左侧有Books、Students、Borrow records三个菜单；
• 点Books→ADD BOOK，填书名、ISBN、库存，点SAVE，再刷新首页，新书出现在列表里——闭环验证完成。

提示：若运行.bat后浏览器打不开，手动在浏览器地址栏输入http://127.0.0.1:8000/；若提示“此网站无法提供安全连接”，忽略，这是开发模式HTTP协议，不是HTTPS。

6. 二次开发实战：3个高频改造需求，从改配置到加功能

答辩通过后，导师常会说“能不能加个XX功能？”——别慌，这项目设计时就预留了扩展点。我挑三个最常被问到的需求，给出可直接抄的代码和验证方法，让你改完立刻见效。

6.1 需求1：把借阅期限从30天改成“教师60天、学生30天”

改造思路：把硬编码的timedelta(days=30)变成根据用户角色动态计算。
操作步骤：

1. 在library/models.py的Student模型里，加一个role字段：

class Student(models.Model): ROLE_CHOICES = [ ('student', '学生'), ('teacher', '教师'), ] # ...其他字段 role = models.CharField(max_length=10, choices=ROLE_CHOICES, default='student')

2. 在library/admin.py里，让StudentAdmin显示role字段：

class StudentAdmin(admin.ModelAdmin): list_display = ['student_id', 'name', 'role', 'max_borrow_count'] list_filter = ['role'] # 后台可按角色筛选

3. 改borrow_book视图里的due_date计算：

# 替换原来的 due_date=timezone.now() + timedelta(days=30) if student.role == 'teacher': due_days = 60 else: due_days = 30 due_date = timezone.now() + timedelta(days=due_days)

验证方法：

• 在Admin后台新建一个role='teacher'的学生；
• 用该学生账号登录，借一本书，查看BorrowRecord表，due_date应是当前时间+60天；
• 再用普通学生借，due_date应是+30天。

6.2 需求2：增加“图书分类统计报表”，导出Excel

改造思路：Django没内置Excel导出，但openpyxl库轻量够用，比pandas更适合毕设。
操作步骤：

1. 安装库：pip install openpyxl；
2. 在library/views.py里加新视图：

from openpyxl import Workbook from openpyxl.styles import Font from django.http import HttpResponse def category_report(request): # 按分类统计图书数量和总库存 from django.db.models import Count, Sum categories = Book.objects.values('category').annotate( total_books=Count('id'), total_stock=Sum('stock') ).order_by('-total_stock') # 创建Excel wb = Workbook() ws = wb.active ws.title = "图书分类统计" # 表头 headers = ['分类', '图书种数', '总库存'] for col, header in enumerate(headers, 1): cell = ws.cell(row=1, column=col, value=header) cell.font = Font(bold=True) # 数据 for row, cat in enumerate(categories, 2): ws.cell(row=row, column=1, value=cat['category']) ws.cell(row=row, column=2, value=cat['total_books']) ws.cell(row=row, column=3, value=cat['total_stock']) # 响应 response = HttpResponse(content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet') response['Content-Disposition'] = 'attachment; filename="category_report.xlsx"' wb.save(response) return response

3. 在library/urls.py里加路由：

path('report/category/', views.category_report, name='category_report'),

4. 在templates/library/base.html的导航栏里加链接：

<a class="nav-link" href="{% url 'category_report' %}">分类统计</a>

验证方法：

• 点导航栏“分类统计”，浏览器自动下载category_report.xlsx；
• 打开Excel，确认有三列数据，且数字与后台Book表统计一致。

6.3 需求3：接入校园一卡通，用学号直接登录（去掉Django默认用户）

改造思路：Django认证系统可替换，用AUTHENTICATION_BACKENDS指定自定义后端，查一卡通数据库（假设叫campus_card）的student_info表。
操作步骤：

1. 在library/backends.py（新建文件）里写认证后端：

from django.contrib.auth.backends import ModelBackend from django.contrib.auth.models import User from .models import Student class CampusCardBackend(ModelBackend): def authenticate(self, request, username=None, password=None, **kwargs): if username is None or password is None: return None try: # 假设一卡通数据库有student_info表，字段：card_no, name, class_name # 这里用Django ORM查，实际需配置另一个数据库 student = Student.objects.get(student_id=username) # 学号即密码（校园卡默认规则） if password == username: return student.user # 返回关联的Django User except Student.DoesNotExist: pass return None

2. 在library/settings.py里替换认证后端：

AUTHENTICATION_BACKENDS = [ 'library.backends.CampusCardBackend', # 自定义优先 'django.contrib.auth.backends.ModelBackend', # 默认备选 ]

3. 在library/models.py的Student模型里，确保有user = models.OneToOneField(User, on_delete=models.CASCADE)字段（原代码已有）。
   验证方法：

• 用任意学号（如2021001）和相同密码登录首页；
• 登录成功后，request.user.username应等于学号，request.user.student.name能取到学生姓名。

从那以后我每次帮同学改毕设，都强制走一遍“四步法”验证：环境→依赖→数据库→服务。哪怕多花10分钟，也比答辩当天黑屏强。这套流程跑通了，你手里就不是一份“能交差”的代码，而是一个随时能演示、能改、能讲清设计逻辑的完整系统。希望帮到你。

本文还有配套的精品资源，点击获取