简介这是一套面向高校学生与Python初学者、用于课程设计或数据库大作业的库存管理系统完整资料包含源码、SQL文件与设计报告可帮助读者理解从需求分析到功能落地的完整开发流程。压缩包共1473个文件约28.52MB以ts、html、js、scss、less等前端资源为主辅以py业务代码、pyc编译文件、sql建表脚本及sqlite3数据库文件另有md说明、json配置与少量图片、字体等静态资源目录结构较完整。系统覆盖商品信息管理、库存监控、入库出库记录、查询统计与用户权限管理等核心模块设计报告则阐述数据库表结构、字段约束与表间关系。目前已有44人学习下载适合需要参考完整项目结构、数据库设计思路与Python业务实现细节的读者也可作为二次开发与答辩准备的实践案例。1. 从一份课程设计说起Python 库存管理系统到底能跑出什么效果很多人第一次接触「基于 Python 的库存管理系统」是在课程设计或毕业设计的场景里。拿到手的通常是一个压缩包源码、一个.sql文件、一份设计报告。表面上看是三样东西实际上它们对应三条完全不同的能力线——源码决定系统能不能跑起来SQL 文件决定数据能不能落库设计报告决定你能不能讲清楚自己做了什么。这三样缺一个交付就是残的。我见过太多人卡在第一步Python 装好了PyCharm 也配好了结果导入项目之后一堆红色报错数据库连不上表建不出来最后只能把源码截图贴进报告里交差。这篇笔记就是冲着这个痛点来的。我会按「环境怎么搭 → 数据库怎么建 → 源码怎么读 → 功能怎么跑通 → 坑在哪」的顺序把一套典型的 Python 库存管理系统从零复现一遍。适合正在做课程设计的学生也适合想用 Python 快速搭一个内部小工具的一线开发者。读完你至少能做到本地跑通增删改查、看懂 SQL 文件里的表关系、知道哪些地方最容易翻车。2. 环境准备与项目结构把 Python 和数据库先跑通2.1 Python 安装与虚拟环境配置库存管理系统这类项目通常依赖tkinter桌面 GUI或FlaskWeb 界面再加上pymysql或sqlite3做数据层。不管你用哪种第一步都是把 Python 环境弄干净。我一般不建议直接用系统自带的 Python而是用虚拟环境隔离依赖避免和别的项目打架。# 查看当前 Python 版本建议 3.8 以上 python --version # 在项目根目录创建虚拟环境 python -m venv venv # Windows 激活 venv\Scripts\activate # macOS / Linux 激活 source venv/bin/activate # 安装常用依赖 pip install pymysql flask openpyxl这里有几个参数值得说明。python -m venv venv里的第二个venv是虚拟环境文件夹的名字你可以改成env或.venv但建议保持默认因为很多 IDE 会自动识别这个目录。pymysql是纯 Python 实现的 MySQL 驱动安装不需要编译工具比mysqlclient省事得多。openpyxl用于导出 Excel 报表库存系统几乎都会用到。如果你用的是 SQLite那sqlite3是标准库自带的不用额外装。提示如果你在 Windows 上遇到pip不是内部命令大概率是 Python 安装时没勾选「Add Python to PATH」重新跑一遍安装程序勾上即可。2.2 项目目录结构与 SQL 文件定位拿到源码包之后先别急着打开 IDE。我习惯先用文件管理器把目录结构看一遍搞清楚哪个是入口文件、哪个是配置文件、SQL 文件放在哪。一个典型的 Python 库存管理系统目录大概长这样inventory_system/ ├── main.py # 程序入口 ├── config.py # 数据库配置 ├── db/ │ └── inventory.sql # 建表与初始数据 ├── models/ │ ├── product.py # 商品模型 │ └── stock.py # 库存模型 ├── views/ │ ├── login.py # 登录界面 │ └── main_window.py # 主界面 ├── utils/ │ └── db_helper.py # 数据库连接封装 └── requirements.txt # 依赖清单看到config.py就要立刻打开里面通常写着数据库的 host、port、user、password、database 四个参数。很多新手跑不起来就是因为源码里的密码是作者本地的你直接跑必然连不上。把这里改成你自己的数据库信息是跑通的第一步。inventory.sql这个文件是重点。它一般包含CREATE DATABASE、CREATE TABLE、INSERT INTO三类语句。有些作者会把建库和建表分开写有些会写在一起。你需要确认它用的是 MySQL 还是 SQLite 语法——MySQL 有AUTO_INCREMENTSQLite 是AUTOINCREMENT搞混了就会报语法错误。2.3 用 SQL 文件建库建表的完整流程假设你用的是 MySQL下面是从零导入 SQL 文件的步骤。先确保 MySQL 服务已经启动然后用命令行登录# 登录 MySQL mysql -u root -p # 查看现有数据库 SHOW DATABASES; # 如果 SQL 文件里没有建库语句手动建一个 CREATE DATABASE inventory_db DEFAULT CHARACTER SET utf8mb4; # 退出 MySQL回到命令行导入 exit # 导入 SQL 文件 mysql -u root -p inventory_db db/inventory.sql导入完成后再登录确认USE inventory_db; SHOW TABLES; SELECT * FROM product LIMIT 5;如果SHOW TABLES出来是空的说明 SQL 文件里可能只有建表语句但没有执行成功或者文件编码有问题。我遇到过好几次 SQL 文件是 GBK 编码导入时报「Unknown character set」解决办法是用iconv转成 UTF-8iconv -f GBK -t UTF-8 db/inventory.sql db/inventory_utf8.sql mysql -u root -p inventory_db db/inventory_utf8.sql注意导入之前最好先看一眼 SQL 文件头部有没有DROP DATABASE或DROP TABLE有的话确认自己不需要旧数据再执行否则就是血泪教训。3. 源码核心模块拆解从登录到库存增删改查3.1 数据库连接封装与配置读取库存管理系统的源码里最值得先读的不是界面代码而是数据库连接封装。因为所有功能都依赖它这里出问题后面全崩。常见的写法是utils/db_helper.py里定义一个get_connection()函数import pymysql from config import DB_CONFIG def get_connection(): 获取数据库连接每次调用返回新连接 return pymysql.connect( hostDB_CONFIG[host], portDB_CONFIG[port], userDB_CONFIG[user], passwordDB_CONFIG[password], databaseDB_CONFIG[database], charsetutf8mb4, cursorclasspymysql.cursors.DictCursor ) def query_all(sql, paramsNone): 通用查询返回字典列表 conn get_connection() try: with conn.cursor() as cursor: cursor.execute(sql, params) return cursor.fetchall() finally: conn.close()这段代码有三个关键点。第一cursorclasspymysql.cursors.DictCursor让查询结果以字典形式返回字段名直接作为 key比默认的元组好用得多。第二charsetutf8mb4必须写否则中文商品名会变成乱码。第三finally里关闭连接避免连接泄漏。如果你看到源码里没有finally或者没有close()那这个项目跑久了大概率会报「Too many connections」。config.py通常长这样DB_CONFIG { host: localhost, port: 3306, user: root, password: 123456, database: inventory_db }把password改成你自己的database改成你导入 SQL 时建的库名。如果源码用的是 SQLite那config.py里可能只有一个文件路径比如DB_PATH inventory.db这种更简单不用装 MySQL。3.2 商品入库与库存更新的业务逻辑库存管理系统最核心的功能就是入库和出库。入库是增加库存出库是减少库存同时要记录操作日志。一个典型的入库函数大概是这样def stock_in(product_id, quantity, operator): 商品入库更新库存 写入日志 conn get_connection() try: with conn.cursor() as cursor: # 先查当前库存 cursor.execute( SELECT stock FROM product WHERE id %s, (product_id,) ) row cursor.fetchone() if not row: raise ValueError(f商品 {product_id} 不存在) new_stock row[stock] quantity # 更新库存 cursor.execute( UPDATE product SET stock %s WHERE id %s, (new_stock, product_id) ) # 写入入库日志 cursor.execute( INSERT INTO stock_log (product_id, change_type, quantity, operator, create_time) VALUES (%s, IN, %s, %s, NOW()), (product_id, quantity, operator) ) conn.commit() return new_stock except Exception as e: conn.rollback() raise e finally: conn.close()参数说明product_id是商品主键quantity是入库数量operator是操作人。这里用conn.commit()提交事务用conn.rollback()回滚异常。很多课程设计源码里没有事务控制入库一半报错就导致数据不一致这是典型的踩坑点。NOW()是 MySQL 函数SQLite 里要换成datetime(now)。出库逻辑类似只是把 quantity改成- quantity并且要判断库存是否足够if row[stock] quantity: raise ValueError(库存不足无法出库)3.3 查询、分页与 Excel 导出库存查询通常支持按商品名模糊搜索和分页。分页的核心是LIMIT和OFFSETdef search_products(keyword, page1, page_size10): 按名称模糊搜索分页返回 offset (page - 1) * page_size sql ( SELECT id, name, stock, price FROM product WHERE name LIKE %s ORDER BY id DESC LIMIT %s OFFSET %s ) params (f%{keyword}%, page_size, offset) return query_all(sql, params)%{keyword}%是模糊匹配前后加百分号表示包含即可。LIMIT控制每页条数OFFSET控制跳过多少条。注意page从 1 开始所以offset要减 1 再乘。如果源码里直接拼接 SQL 字符串比如WHERE name LIKE % keyword %那就有 SQL 注入风险虽然课程设计不查这个但自己要知道这是不规范的。Excel 导出用openpyxlfrom openpyxl import Workbook def export_to_excel(products, filepath): 将商品列表导出为 Excel wb Workbook() ws wb.active ws.title 库存清单 ws.append([ID, 商品名称, 库存, 单价]) for p in products: ws.append([p[id], p[name], p[stock], p[price]]) wb.save(filepath)ws.append()每次追加一行第一行是表头。wb.save()保存文件。如果商品名有中文openpyxl默认支持 UTF-8不用额外设置。4. 避坑与排查跑不通库存管理系统时先查这 5 个地方4.1 报错「Access denied for user」——密码或权限不对现象运行main.py后直接抛出pymysql.err.OperationalError: (1045, Access denied for user rootlocalhost)。原因config.py里的密码和你本地 MySQL 的密码不一致或者 MySQL 根本没启动。解决先确认 MySQL 服务在运行。Windows 在服务管理器里看 MySQL 服务状态macOS 用brew services listLinux 用systemctl status mysql。然后确认密码如果忘了 root 密码可以跳过权限表重置但这是另一个话题了。最直接的办法是在命令行用mysql -u root -p试一下能不能登录能登录就说明密码对问题在代码里。4.2 中文乱码——字符集没统一现象商品名显示成????或者手机这种乱码。原因数据库、表、连接三处的字符集不一致。常见的是数据库建的时候用了latin1或者连接时没指定charset。解决三步统一。第一建库时用DEFAULT CHARACTER SET utf8mb4。第二建表时每个VARCHAR字段后面加CHARACTER SET utf8mb4或者直接在建表语句末尾加DEFAULT CHARSETutf8mb4。第三pymysql.connect()里加charsetutf8mb4。三处都对了中文就不会乱。4.3 导入 SQL 文件报「Unknown command」——编码或版本问题现象mysql -u root -p inventory_db inventory.sql执行到一半报错提示ERROR 1064 (42000)或Unknown command \。原因SQL 文件编码不是 UTF-8或者文件里用了 MySQL 8 的新语法但你的 MySQL 是 5.7。解决先用file inventory.sql看编码如果是 ISO-8859 或 GBK用iconv转成 UTF-8。如果是版本问题检查 SQL 里有没有utf8mb4_0900_ai_ci这种排序规则MySQL 5.7 不支持改成utf8mb4_general_ci即可。4.4 界面能打开但按钮没反应——事件绑定丢失现象用 tkinter 写的界面窗口正常显示但点击「入库」「查询」按钮没有任何反应。原因按钮的command参数没有绑定函数或者绑定的函数名拼错了。还有一种可能是函数内部抛了异常但被try/except吞掉了界面上看不到报错。解决先看控制台有没有输出异常信息。如果没有在按钮绑定的函数第一行加print(clicked)确认函数是否被调用。如果没被调用检查commandself.on_stock_in这种写法有没有漏掉self或者函数定义在按钮创建之后。4.5 打包成 exe 后闪退——缺少依赖或路径错误现象用pyinstaller打包后双击 exe 一闪而过看不到任何界面。原因打包时没有把pymysql或openpyxl打进去或者代码里用了相对路径读取 SQL 文件打包后路径变了。解决打包时加--hidden-import参数pyinstaller -F -w main.py --hidden-importpymysql --hidden-importopenpyxl-F是单文件-w是去掉控制台窗口。如果还是闪退先用-w去掉保留控制台看报错。路径问题用os.path.dirname(os.path.abspath(__file__))获取当前文件目录再拼接 SQL 文件路径。5. 设计报告怎么写才不像流水账三个让答辩加分的技巧设计报告不是把代码贴一遍就完事。我见过太多报告第一章「绪论」写了两页第二章「需求分析」全是空话第三章「系统实现」直接贴代码截图最后「总结与展望」写「本系统还有很多不足」。这种报告老师翻两页就不想看了。下面三个技巧是我自己写报告时总结出来的能让你的报告看起来像真的做过东西。第一个技巧用表格代替文字描述功能模块。比如「商品管理模块」不要写一段话而是列一个表功能点输入处理输出商品新增名称、单价、初始库存校验名称非空、单价大于 0写入 product 表返回商品 ID商品查询关键词、页码模糊匹配 name 字段分页返回商品列表和总数库存入库商品 ID、数量校验商品存在更新 stock写入 stock_log返回新库存库存出库商品 ID、数量校验库存充足更新 stock写入 stock_log返回新库存这张表一放老师立刻知道你清楚每个功能的输入输出和处理逻辑比写三段文字管用。第二个技巧把数据库表关系画成文字版 ER 说明。不用画图用文字说清楚外键关系product表主键id字段name、stock、price、category_idcategory表主键id字段namestock_log表主键id外键product_id关联product.id字段change_type、quantity、operator、create_time然后补一句「一个商品属于一个分类一个商品有多条库存日志删除商品时日志保留用于审计。」这句话就体现了你对数据完整性的理解。第三个技巧在「系统测试」章节放真实的测试用例和结果。不要写「系统运行正常」而是列一个表测试项输入预期结果实际结果是否通过空名称新增名称留空提示「名称不能为空」提示「名称不能为空」通过库存不足出库出库数量大于库存提示「库存不足」提示「库存不足」通过模糊查询关键词「手机」返回名称含「手机」的商品返回 3 条记录通过这种表格一放答辩老师基本不会在测试环节为难你。最后一个习惯报告里的代码片段不要超过 20 行。超过 20 行的代码放附录正文只放核心逻辑。我一般会把stock_in函数精简到 10 行左右只保留事务和更新逻辑异常处理用文字说明。这样报告读起来流畅不会变成代码阅读器。希望帮到你。本文还有配套的精品资源点击获取