简介基于Python-Flask的在线图书管理系统项目源码面向计算机相关专业的在校学生、老师及企业员工尤其适合用于课程设计、毕业设计或Web开发入门实践。系统采用Flask框架实现图书借阅、书目管理、用户操作等核心逻辑并配备简洁的HTML前端模板代码分层清晰便于阅读与二次扩展压缩包共13个文件包括8个Python脚本负责主程序、路由、配置及启动逻辑、3个HTML页面、1个README说明文档和1个配置文件整体仅16KB轻量易部署。目前已有90人学习下载项目代码经作者测试运行成功答辩评审平均分达96分可作为完整参考方案通过源码可学习Flask项目结构、模板渲染、数据库配置等关键技能也可在此基础上补充功能或直接用于课程设计、毕业设计演示。资源内所有代码均在运行成功后上传具备较高完整度适合需要参考真实项目流程的读者。下载后建议先查看README.md仅供学习参考切勿用于商业用途。1. 一个 96 分的 Flask 课设项目解压后重点看什么这份压缩包解压后东西不多manage.py、config.py、uwsgiconfig.ini一个 app 包再加 templates 模板目录。用 Python Flask 写在线图书管理系统做到这个体量评审平均分能到 96靠的不是堆功能而是把「用户登录、图书检索、借阅归还」三条业务线收进了一个结构干净的 Flask 应用工厂里。对正在做 Python 课程设计或毕业设计的人来说这是个比零散教程片段更完整的参考工程对想入门 Flask 开发的人它展示了 manage.py、app 包、模板目录之间该怎么分工。源码量不大适合先整读再动手改。2. 应用工厂与蓝图先把这个 Flask 项目的骨架拆开2.1 目录结构与模块边界项目入口只有一个 manage.py业务代码全部收在 app 包内部。按常见惯例目录应该长成下面这样个别子文件以实际解压为准project/ ├── manage.py # 应用入口创建 app 并启动 ├── config.py # 全局配置数据库、密钥、调试开关 ├── uwsgiconfig.ini # uWSGI 部署配置 ├── README.md # 运行步骤与说明 └── app/ ├── __init__.py # 应用工厂 create_app() ├── main/ # 蓝图模块路由与视图 ├── templates/ # Jinja2 模板 └── static/ # 静态资源通常会有解压后确认这个结构的设计逻辑是manage.py 只负责启动不写业务config.py 单独成文件方便切换开发与生产配置app 包内部按蓝图切分模块而不是把所有路由堆在一个 app.py 里。对课设体量来说这种分法看起来多了一层目录但后续加接口、改字段时不需要在几百行的一个文件里反复找函数边界清楚很多。2.2 create_app 工厂怎么初始化app/init.py 通常是整个项目的初始化中枢常见写法是提供一个 create_app 工厂函数# app/__init__.py from flask import Flask def create_app(config_nameNone): app Flask(__name__) app.config.from_object(config) # 读取 config.py # 初始化数据库扩展 from app.main import db db.init_app(app) # 注册蓝图 from app.main import main as main_blueprint app.register_blueprint(main_blueprint) return app这段代码的逻辑并不难先创建 Flask 实例再读取 config.py 里的配置项接着把数据库扩展绑定到应用上最后注册蓝图。Flask 应用需要知道模板和静态文件在哪默认 template_folder 和 static_folder 都定位在 app 包下所以把 templates 放在 app/templates 下不需要额外声明。用工厂函数而不是模块级 app 实例主要换来了两个能力一是测试时可以传入不同配置反复创建实例不会共享状态二是蓝图的注册集中在一处以后加一个 admin 后台模块只需要多一行 register_blueprint。2.3 蓝图注册与 manage.py 入口蓝图Blueprint本质上是把一组路由打包的容器main 蓝图承载前台图书展示与借阅相关的所有路由。习惯上 app/main/init.py 里面创建蓝图实例views.py 里写视图函数# app/main/__init__.py from flask import Blueprint main Blueprint(main, __name__) from app.main import views, models # 导入视图与模型注册路由manage.py 的职责就变得很单纯# manage.py from app import create_app app create_app() if __name__ __main__: app.run(host0.0.0.0, port5000, debugTrue)提示host 设为 0.0.0.0 而不是 127.0.0.1是为了方便局域网内直接用 IP:5000 访问演示页面。如果只在本机看改回 127.0.0.1 更安全。把 app 实例放在 manage.py 顶层还有一个作用uWSGI 这类 WSGI 服务器可以直接指定 wsgi-file 指向 manage.py、callable 指向 app不用单独写 wsgi.py。这在最后部署章节会再展开。文件/目录承担的职责你改功能时动哪里manage.py创建 app、启动服务基本不动调试开关在这里config.py数据库地址、SECRET_KEY、调试选项换数据库、改密钥时改这里app/init.py工厂函数、扩展初始化、蓝图注册新装扩展或新蓝图时改这里app/main/路由、视图、模型加接口、改业务逻辑时主力战场app/templates/Jinja2 页面调整展示和交互时改这里把模块边界划清楚之后再看核心业务就顺多了先明白模型建在哪再去视图里追数据流最后到模板里看渲染结果。这也是我拿到别人课设源码时固定的阅读顺序。3. 图书、用户、借阅三张表模型与视图的核心写法3.1 三张核心表怎么设计图书管理系统的数据模型绕不开用户、图书、借阅记录三张表。课设项目常选用 Flask-SQLAlchemy 作为 ORM模型文件一般放在 app/main/models.py# app/main/models.py from datetime import datetime from flask_sqlalchemy import SQLAlchemy from werkzeug.security import generate_password_hash, check_password_hash db SQLAlchemy() class User(db.Model): __tablename__ users # user 是 SQL 保留字这里改名避免坑 id db.Column(db.Integer, primary_keyTrue) username db.Column(db.String(64), uniqueTrue, nullableFalse) password_hash db.Column(db.String(128), nullableFalse) def set_password(self, password): self.password_hash generate_password_hash(password) def check_password(self, password): return check_password_hash(self.password_hash, password) class Book(db.Model): id db.Column(db.Integer, primary_keyTrue) title db.Column(db.String(128), nullableFalse) author db.Column(db.String(64), default) isbn db.Column(db.String(32), uniqueTrue) stock db.Column(db.Integer, default1) # 库存借出减一归还加一 class BorrowRecord(db.Model): id db.Column(db.Integer, primary_keyTrue) user_id db.Column(db.Integer, db.ForeignKey(users.id)) book_id db.Column(db.Integer, db.ForeignKey(book.id)) status db.Column(db.String(16), defaultborrowed) # borrowed / returned borrow_time db.Column(db.DateTime, defaultdatetime.now) return_time db.Column(db.DateTime, nullableTrue)几个选型理由值得说明User 表名必须避开 user 这个保留字否则建表时报语法错误密码字段存的是哈希值而不是明文Werkzeug 提供的两个方法配合使用set_password 负责生成check_password 负责校验BorrowRecord 不单独建读者表直接拿 user_id 和 book_id 做外键符合课设的规模。status 用字符串而不是布尔值是因为借阅状态未来可能要扩展出「逾期」「预约中」等中间态字符串字段改起来成本最低。如果要显示借阅人的名字或书名常见做法是在 BorrowRecord 上补两条 relationship 关系字段或者直接在模板里通过 record.user.username 访问SQLAlchemy 会自动按外键关联查询。3.2 登录认证与 session 会话处理登录和注册是用户功能的主体。视图代码通常放在 app/main/views.py 中用蓝图装饰器注册路由# app/main/views.py from flask import (render_template, request, redirect, url_for, session, flash, Blueprint) from app.main import main, db from app.main.models import User, Book, BorrowRecord main.route(/login, methods[GET, POST]) def login(): if request.method POST: username request.form.get(username, ).strip() password request.form.get(password, ) user User.query.filter_by(usernameusername).first() if user and user.check_password(password): session[user_id] user.id session[username] user.username return redirect(url_for(main.index)) flash(用户名或密码错误) return render_template(login.html) main.route(/logout) def logout(): session.clear() return redirect(url_for(main.login))这里的关键点是 session 里只存 user_id 和 username 两个轻量字段不塞整个用户对象。Flask 的 session 默认用签名 Cookie 承载数据体积有限放对象还容易因序列化失败报错。后续视图里判断登录状态直接用 session.get(user_id) 是否存在来判断再配合一个自定义装饰器做登录保护即可。提示SECRET_KEY 必须配置否则 session 无法签名。课程设计里不少人直接写死一串字符如果项目要对外演示至少保证它不是一个能被猜到的值。注册接口逻辑同理创建 User 对象后调用 set_password 再入库注意捕获用户名重复带来的 IntegrityError 异常并回滚事务。3.3 借阅归还的状态流转与事务边界借阅流程是这套代码的难点。借书不等于简单 insert 一条记录库存扣减和借阅记录插入必须发生在同一个数据库事务里否则并发借阅时会出现超借。常见写法如下main.route(/borrow/int:book_id) def borrow(book_id): if not session.get(user_id): return redirect(url_for(main.login)) book Book.query.get_or_404(book_id) if book.stock 0: flash(库存不足无法借阅) return redirect(request.referrer or url_for(main.index)) record BorrowRecord( user_idsession[user_id], book_idbook.id, statusborrowed ) book.stock - 1 db.session.add(record) db.session.commit() return redirect(url_for(main.my_borrow))这里「先检查库存再扣减最后同事务提交」的顺序不是随手写的。如果先 commit 再改库存记录和库存会短暂不一致如果在检查库存前就扣减又可能把负数库存写进库。把 add 和修改放到同一个 commit 里任何一个失败都会整体回滚这是课设代码里最值得参考的一处工程习惯。状态流程触发动作数据变更登录提交用户名密码session 写入 user_id借书点击借阅插入 BorrowRecordBook.stock 减一还书点击归还更新记录 statusreturnedstock 加一退出点击退出session.clear()还书逻辑与借书对称先查出当前用户未归还的记录把 status 改成 returned、return_time 写成当前时间再把对应 Book.stock 加一。写完记得处理重复还书的情况比如加一个条件只更新 status 仍为 borrowed 的记录防止按钮连点导致库存多加。4. 模板继承、搜索与分页Jinja2 层的实现细节4.1 base.html 模板继承与消息闪现templates 目录下通常有一个 base.html 作为母版其他页面通过继承来复用导航栏和样式。核心写法如下!-- app/templates/base.html -- !DOCTYPE html html head meta charsetutf-8 title{% block title %}在线图书管理系统{% endblock %}/title /head body nav a href{{ url_for(main.index) }}首页/a a href{{ url_for(main.books) }}图书检索/a {% if session.get(user_id) %} a href{{ url_for(main.my_borrow) }}我的借阅/a a href{{ url_for(main.logout) }}退出/a {% else %} a href{{ url_for(main.login) }}登录/a {% endif %} /nav {% with messages get_flashed_messages() %} {% if messages %} ul {% for message in messages %} li{{ message }}/li {% endfor %} /ul {% endif %} {% endwith %} {% block content %}{% endblock %} /body /html导航栏里用 url_for 而不是硬编码路径是 Jinja2 模板的规范做法。蓝图路由的 url_for 写法是 蓝图名.视图函数名即 main.index 对应 main 蓝图中名为 index 的视图。这样即使以后改了路由规则模板里的链接也不需要逐个调整。get_flashed_messages 是 Flask 闪现消息的消费端视图里 flash(库存不足) 写入的提示会在这里统一渲染。注意闪现消息是队列式的读一次就清空所以它只能放在被渲染的那个页面的模板里。如果多次调用 get_flashed_messages第二次拿到的就是空列表。子页面继承时只需要在自己的模板里写{% extends base.html %}和{% block content %}母版中的导航和消息区会自动带上。这种层级关系让图书列表、登录页、借阅记录页可以各自只维护内容区不用复制整段 HTML。4.2 图书检索的写法图书列表页承担两个职责展示全部图书和按关键词过滤。检索功能通常和分页放在同一个视图里处理main.route(/books) def books(): page request.args.get(page, 1, typeint) keyword request.args.get(q, ).strip() query Book.query if keyword: like f%{keyword}% query query.filter( db.or_(Book.title.like(like), Book.author.like(like)) ) pagination query.paginate(pagepage, per_page10, error_outFalse) return render_template( books.html, paginationpagination, keywordkeyword )这段代码里值得注意的参数有三个。page 用 typeint 做了显式类型转换请求里 pageabc 时不会直接报 500而是回退成默认值 1error_outFalse 让越界页码返回空列表而不是 404用户体验上更友好keyword 在渲染时再次传回模板是为了让翻页链接能保留搜索条件。db.or_ 是 OR 条件组合用 like 做模糊匹配对课设的数据量完全够用。如果以后图书量过万可以换成 MySQL 的全文索引或者引入专门搜索方案但在当前项目里没有必要过度设计。4.3 分页参数与翻页链接book.html 模板中循环展示分页对象并在底部渲染页码链接{% for b in pagination.items %} div classbook-item strong{{ b.title }}/strong {{ b.author }} span库存{{ b.stock }}/span /div {% endfor %} {% if pagination.pages 1 %} div classpagination {% for p in pagination.iter_pages() %} {% if p %} a href{{ url_for(main.books, pagep, qkeyword) }}{{ p }}/a {% else %} span.../span {% endif %} {% endfor %} /div {% endif %}iter_pages() 是 SQLAlchemy 分页对象提供的方法自动生成带省略号的页码序列p 为 None 时就是省略号占位。翻页链接里把 keyword 原样带回保证从第 2 页点回第 1 页时搜索条件不丢这是搜索加分页场景最容易漏的一个细节。参数名类型作用默认值qstr搜索关键词匹配书名或作者空字符串pageint当前页码1per_pageint每页条数视图内写死 10error_outbool越界时是否抛 404False借阅记录页可以复用同一套分页逻辑只要把 Book.query 换成当前用户的 BorrowRecord 查询。模板里再通过 record.book.title 把书名展示出来SQLAlchemy 会按外键自动补全关联对象不需要手写 join。5. uWSGI 配置与答辩前必改的几处验证点5.1 uwsgiconfig.ini 逐项拆解压缩包里的 uwsgiconfig.ini 表明这个项目不只是本地跑通还考虑过部署到 Linux 服务器。uWSGI 配置用 ini 格式写起来最直观[uwsgi] http 0.0.0.0:8080 chdir /path/to/your/project wsgi-file manage.py callable app master true processes 2 threads 2 vacuum true die-on-term truechdir 是项目根目录uWSGI 会先切到这个目录再加载应用wsgi-file 直接指向 manage.pycallable 指定 Flask 实例变量名为 app这两个配置配合前面工厂模式的设计不需要额外建 wsgi.py。processes 和 threads 分别控制进程数和线程数课设演示场景 2 进程 2 线程足够。启动命令是pip install uwsgi uwsgi --ini uwsgiconfig.ini5.2 部署后的快速验证与答辩检查启动后用 curl 验证核心链路比打开浏览器更可控两步就能确认服务和登录是否正常curl -X POST -d usernameadminpassword123456 \ http://127.0.0.1:8080/login -c cookies.txt -L -o /dev/null -w %{http_code}\n curl -b cookies.txt http://127.0.0.1:8080/books?qPythonpage2 -o /dev/null -w %{http_code}\n第一条命令带 Cookie 登录并跟随重定向输出 200 说明登录成功第二条带同一份 Cookie 访问带搜索条件的列表页同样看 200。如果返回 302 或 403优先检查 SECRET_KEY 是否变化导致 session 失效以及登录保护装饰器是否把未登录请求重定向到了别处。答辩演示前对照这份清单过一遍数据库文件或连接串是否指向演示库、图书库存初始值是否满足演示借阅次数、密码是否全部经过哈希存储、模板里的关联字段路径是否和模型一致。其中最后一项最常见模型字段改名后模板没同步页面会直接抛 500而这类错误通常在浏览器里一眼就能看到但也最容易在演示时手忙脚乱。建议把 uwsgiconfig.ini 的 http 保留在 8080 端口做演示地址避免和系统其他服务抢 80 端口。本文还有配套的精品资源点击获取