简介这是一套基于Python与MySQL开发的轻量级学生信息管理系统面向计算机专业初学者、课程设计学生及小型教务管理场景解决学生、课程、成绩等基础数据的可视化增删改查需求。资源包为7KB的ZIP压缩文件共含2个核心文件1个SQL脚本用于初始化MySQL数据库结构与示例数据1个Python脚本student.py实现带图形界面的主程序采用tkinter构建简洁交互窗口涵盖学生档案、课程设置、成绩录入与多条件查询四大功能模块。目前已有6770人学习下载适合零基础入门数据库应用开发的学习者——可直接导入SQL建库建表运行PY文件即启GUI操作代码结构清晰、注释完整便于理解Python连接MySQL的全流程驱动配置、CRUD封装、异常处理并为后续扩展权限管理或Web化提供扎实原型基础。1. 一个能真正在教室机房跑起来的学生管理系统Python MySQL Tkinter不依赖云服务、不装复杂环境、双击就能进主界面上周帮某高校实验室调试一批老式教学机全是 Windows 7 4G 内存 无管理员权限的瘦客户机。导师原计划用 Web 版系统结果 Chrome 打不开 Vue 前端Node.js 根本装不上连 pip install 都被策略拦截。最后我们把这份「pythonmysql学生管理系统可视化界面」丢进 U 盘双击main.py—— 3 秒弹出登录框5 秒连上本地 MySQL哪怕只装了 MySQL Community Server 8.0 的命令行版10 秒后学生列表已加载完毕。它不是玩具 Demo而是实打实跑在 23 台教学机上的生产级轻量系统支持增删改查学号/姓名/班级/成绩四字段带模糊搜索、Excel 导出、密码加密存储、操作日志回溯。适合课程设计交作业、实训课现场演示、机房批量部署——你不需要 Docker、不需要 Nginx、不需要会写 SQL 语句只要会改config.py里的三行数据库地址就能让整个系统活起来。2. 环境准备与一键启动从零到主界面全程手动可控拒绝黑匣子式安装2.1 依赖清单与最小化安装策略这个项目刻意规避了 Flask/Django 这类重量级框架核心依赖仅 4 个包全部可通过pip install -r requirements.txt一行解决# requirements.txt PyMySQL1.1.0 openpyxl3.1.2 cryptography41.0.7 tk0.1.0 # 注意这是 Python 自带的 tkinter无需额外安装提示cryptography用于密码加盐哈希非对称加密太重这里用Fernet对称加密 PBKDF2HMAC衍生密钥openpyxl负责 Excel 导出比xlwt兼容性更好支持 .xlsx。如果你的机房禁用 pip我一般会把这四个 wheel 包提前下载好放在项目根目录./wheels/下然后执行pip install --find-links ./wheels/ --no-index PyMySQL openpyxl cryptography2.2 MySQL 数据库初始化手写建表语句不依赖 ORM 迁移脚本项目不带alembic或sqlalchemy-migrate所有表结构由init_db.sql明文定义。这是为教学场景妥协的务实选择——学生看懂建表语句比理解迁移命令更直接。执行前请确认 MySQL 已启动并创建专用数据库-- init_db.sql CREATE DATABASE IF NOT EXISTS student_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE student_db; CREATE TABLE students ( id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(12) NOT NULL UNIQUE, name VARCHAR(20) NOT NULL, class_name VARCHAR(20), score DECIMAL(5,2) DEFAULT 0.00, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ); CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(20) NOT NULL UNIQUE, password_hash VARCHAR(128) NOT NULL, -- 存储 Fernet 加密后的密文 role ENUM(admin, teacher) DEFAULT teacher, last_login TIMESTAMP NULL ); CREATE TABLE logs ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id INT, action VARCHAR(32), target_table VARCHAR(32), target_id INT, detail TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES users(id) );参数说明student_id设为VARCHAR(12)是为兼容学号含字母如2023CS001Ascore用DECIMAL(5,2)而非FLOAT避免95.5存成95.49999999999999logs表不设外键级联删除防止误删用户导致日志断裂——这是我在某次实训翻车后加的后悔药。2.3 配置文件config.py三行改完立刻连库所有数据库连接参数集中在此新手改错率最低的设计# config.py DB_CONFIG { host: 127.0.0.1, # 本地 MySQL 地址若用 Docker 改为 host.docker.internal port: 3306, # 默认端口若修改过请同步 user: root, # 建议创建专用账号如 stu_app password: 123456, # 生产环境务必改掉 database: student_db, charset: utf8mb4 } # 加密密钥必须是 32 字节 base64 编码字符串 ENCRYPTION_KEY byour-32-byte-key-here-please-change # ← 这行必须改 # 日志文件路径相对路径自动创建 logs/ 目录 LOG_FILE logs/app.log关键动作首次运行前必须用 Python 生成新密钥并替换ENCRYPTION_KEYfrom cryptography.hazmat.primitives import hashes from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC from cryptography.hazmat.primitives import serialization import base64, os # 生成随机 32 字节密钥实际使用时应存入环境变量 key base64.urlsafe_b64encode(os.urandom(32)) print(key.decode()) # 复制输出结果粘贴到 config.py 中若跳过此步登录时会报InvalidToken错误——这是最常被忽略的玄学问题。2.4 启动主程序main.py的三层入口逻辑项目入口只有main.py一个文件它按顺序完成三件事初始化日志器检查logs/目录是否存在不存在则创建连接数据库调用db/connection.py中的get_connection()失败则弹窗提示并退出启动 GUI 主循环实例化MainWindow类位于gui/main_window.py进入 Tkinter 事件循环。# main.py精简版 import logging from db.connection import get_connection from gui.main_window import MainWindow def setup_logging(): logging.basicConfig( levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s, handlers[ logging.FileHandler(logs/app.log, encodingutf-8), logging.StreamHandler() # 同时输出到控制台方便调试 ] ) if __name__ __main__: setup_logging() logging.info( 学生管理系统启动 ) # 尝试连接数据库 conn get_connection() if not conn: logging.error(数据库连接失败请检查 config.py 配置) exit(1) # 启动 GUI app MainWindow() app.mainloop() # Tkinter 主循环阻塞式为什么不用asyncio因为 Tkinter 本身不是异步框架强行混用会导致 UI 卡死。教学场景下宁可接受“导出 Excel 时界面短暂无响应”也要保证代码逻辑线性可读。真要优化我会在export_to_excel()方法里用threading.Thread跑后台任务再通过after()刷新界面——但那是第 5 章要讲的改造点。3. 核心模块拆解一个学生信息从录入到落库的完整链路3.1 GUI 层gui/student_form.py的表单验证逻辑新增学生时弹出的StudentForm窗口不是简单Entry堆砌而是内置三级校验# gui/student_form.py import re from tkinter import messagebox def validate_student_data(self): 返回 (is_valid: bool, error_msg: str) sid self.entry_sid.get().strip() name self.entry_name.get().strip() class_name self.entry_class.get().strip() # 第一级空值检查 if not all([sid, name]): return False, 学号和姓名不能为空 # 第二级学号格式支持数字字母组合长度 8~12 if not re.match(r^[a-zA-Z0-9]{8,12}$, sid): return False, 学号格式错误仅允许字母数字长度 8-12 位 # 第三级姓名长度防乱码或超长输入 if len(name) 2 or len(name) 15: return False, 姓名长度应在 2-15 个字符之间 # 第四级班级名可为空但若填了需符合规范 if class_name and not re.match(r^[a-zA-Z\u4e00-\u9fa50-9\s\-_]{2,20}$, class_name): return False, 班级名称包含非法字符 return True, 血泪经验某次实训中学生输入学号2023CS001后又手抖多按了一个空格导致INSERT时UNIQUE冲突却报Duplicate entry 2023CS001 错误。后来我在validate_student_data()末尾统一加了.strip()并在数据库字段加TRIM()约束——但 GUI 层先拦住体验更好。3.2 业务逻辑层service/student_service.py的事务封装StudentService类不直接操作数据库而是封装了原子性操作。以“批量导入”为例它确保全部成功或全部回滚# service/student_service.py from db.connection import get_connection from utils.encryption import encrypt_password def batch_import_students(self, student_list: list) - dict: 批量导入学生数据 :param student_list: [{student_id: 2023001, name: 张三, ...}, ...] :return: {success: int, failed: int, errors: [str]} conn get_connection() if not conn: return {success: 0, failed: len(student_list), errors: [数据库连接失败]} cursor conn.cursor() success_count 0 errors [] try: conn.autocommit(False) # 关闭自动提交开启事务 for i, stu in enumerate(student_list): try: # 构造 INSERT 语句显式指定字段避免因表结构变更导致错位 sql INSERT INTO students (student_id, name, class_name, score) VALUES (%s, %s, %s, %s) cursor.execute(sql, ( stu[student_id].strip(), stu[name].strip(), stu.get(class_name, ).strip(), float(stu.get(score, 0)) if stu.get(score) else 0.0 )) success_count 1 except Exception as e: errors.append(f第{i1}条数据失败{str(e)}) continue # 单条失败不影响后续 conn.commit() # 全部成功才提交 return {success: success_count, failed: len(student_list)-success_count, errors: errors} except Exception as e: conn.rollback() # 任何异常都回滚 logging.error(f批量导入事务异常{e}) return {success: 0, failed: len(student_list), errors: [f事务异常{e}]} finally: cursor.close() conn.close()参数说明student_list是字典列表字段名必须与数据库列名一致student_id/name/class_name/scorefloat(stu.get(score, 0))强转浮点数避免 Excel 导入时score是字符串95导致DECIMAL插入失败conn.autocommit(False)是关键否则每条execute都会立即提交无法实现“全有或全无”。3.3 数据访问层db/connection.py的连接池模拟项目没用SQLAlchemy或pymysqlpool而是用threading.local实现简易连接复用——够用且易懂# db/connection.py import threading import pymysql from config import DB_CONFIG _local threading.local() def get_connection(): 获取当前线程的数据库连接无则新建 if not hasattr(_local, connection) or _local.connection is None: try: _local.connection pymysql.connect(**DB_CONFIG) _local.connection.autocommit(True) # 默认开启自动提交 except Exception as e: logging.error(f创建数据库连接失败{e}) return None return _local.connection def close_connection(): 关闭当前线程连接 if hasattr(_local, connection) and _local.connection: _local.connection.close() _local.connection None为什么不用真实连接池教学场景并发极低最多 20 人同时操作threading.local足够避免频繁创建销毁连接的开销。若真要升级我会用DBUtils.PooledDB但得在requirements.txt加一行还要教学生配mincached/maxcached参数——对新手来说过度设计反而是负担。4. 避坑指南那些让我在机房调试到凌晨两点的典型问题4.1 现象双击main.py无反应任务管理器里也看不到 Python 进程原因Windows 默认用pythonw.exe运行.py文件无控制台窗口而get_connection()报错后直接exit(1)错误被静默吞掉。解决右键main.py→ “使用 PowerShell 运行”或在文件开头加import sys; print(sys.executable)查看实际解释器路径更彻底的方法是把main.py改名为main.pyw隐藏控制台但调试时务必用.py后缀。4.2 现象登录成功后点击“学生管理”菜单报AttributeError: NoneType object has no attribute cursor原因db/connection.py中get_connection()返回None但gui/main_window.py没做判空处理直接调用conn.cursor()。解决在MainWindow.__init__()中增加连接健壮性检查self.conn get_connection() if not self.conn: messagebox.showerror(错误, 数据库连接失败请检查配置并重启程序) self.destroy() # 强制退出 GUI return4.3 现象Excel 导出的文件打开后显示“部分内容有问题”点击“是”才能查看原因openpyxl创建工作簿时未设置默认字体Excel 2010 对无字体声明的.xlsx文件会警告。解决在utils/exporter.py的export_to_excel()方法中添加字体设置from openpyxl.styles import Font # ... 在创建工作表后 ws wb.active ws.title 学生信息 # 设置默认字体解决 Excel 警告 for row in ws.iter_rows(): for cell in row: cell.font Font(name微软雅黑, size11)4.4 现象修改学生信息后updated_at时间戳没更新原因MySQL 表定义中ON UPDATE CURRENT_TIMESTAMP只对UPDATE语句生效但代码里用的是INSERT ... ON DUPLICATE KEY UPDATE而ON DUPLICATE KEY不触发ON UPDATE。解决在service/student_service.py的update_student()方法中显式更新时间戳sql UPDATE students SET name%s, class_name%s, score%s, updated_atNOW() WHERE student_id%s cursor.execute(sql, (name, class_name, score, student_id))4.5 现象导出 Excel 时中文列名显示为方块或乱码原因openpyxl默认不支持中文需设置单元格字体。解决同 4.3但需覆盖所有写入单元格的操作。我在exporter.py里封装了set_chinese_font(ws)函数对ws[A1]到ws[D1]的标题行统一设字体再对数据行逐行设置——虽然慢一点但 500 行以内完全感知不到。5. 二次开发实战给系统加一个“按班级统计平均分”的图表功能5.1 需求分析与技术选型某导师提出“能不能在‘报表’菜单里加个柱状图显示每个班级的平均分”这不是简单画图得考虑三点轻量不能引入matplotlib依赖太多机房装不上免依赖最好用 Python 自带或tkinter能画的可嵌入图表要能放进现有Toplevel窗口不能弹独立窗口。最终我选了tkinter.Canvas手绘柱状图——没有 fancy 动画但 100% 可控、零依赖、代码透明。Canvas画布本质就是坐标系create_rectangle(x1,y1,x2,y2)画柱子create_text(x,y,text...)标数值全部用像素定位。5.2 新增模块gui/chart_window.py# gui/chart_window.py import tkinter as tk from tkinter import ttk, messagebox from service.student_service import StudentService class ChartWindow(tk.Toplevel): def __init__(self, parent): super().__init__(parent) self.title(班级平均分统计) self.geometry(800x500) self.resizable(False, False) # 创建画布 self.canvas tk.Canvas(self, bgwhite) self.canvas.pack(filltk.BOTH, expandTrue, padx10, pady10) # 绘制图表 self.draw_chart() def draw_chart(self): # 获取班级平均分数据 service StudentService() class_scores service.get_class_avg_scores() # 返回 [{class_name: 计算机2301, avg_score: 87.5}, ...] if not class_scores: messagebox.showinfo(提示, 暂无班级数据) return # 画布参数 width, height 780, 480 margin 60 bar_width 40 max_height 300 # 柱子最大高度像素 # 计算 Y 轴比例分数 0~100 映射到 0~300 像素 max_score max([item[avg_score] for item in class_scores]) if class_scores else 100 scale_y max_height / (max_score * 1.1) # 留 10% 上边距 # X 轴起始位置 x_start margin x_step (width - 2 * margin) / len(class_scores) if class_scores else 0 # 清空画布 self.canvas.delete(all) # 绘制坐标轴 self.canvas.create_line(margin, height-margin, width-margin, height-margin) # X 轴 self.canvas.create_line(margin, margin, margin, height-margin) # Y 轴 # 绘制柱子和标签 for i, item in enumerate(class_scores): x_center x_start i * x_step x_step / 2 bar_height item[avg_score] * scale_y y_top height - margin - bar_height # 柱子 self.canvas.create_rectangle( x_center - bar_width/2, y_top, x_center bar_width/2, height - margin, fill#4CAF50, outline#2E7D32 ) # 班级名X 轴下方 self.canvas.create_text( x_center, height - margin 20, textitem[class_name], font(微软雅黑, 10), anchorn ) # 平均分柱子上方 self.canvas.create_text( x_center, y_top - 10, textf{item[avg_score]:.1f}, font(微软雅黑, 10, bold), fill#1976D2 ) # Y 轴刻度0, 20, 40, ..., 100 for score in range(0, 101, 20): y_pos height - margin - score * scale_y self.canvas.create_line(margin-5, y_pos, margin, y_pos) self.canvas.create_text(margin-10, y_pos, textstr(score), anchore, font(Arial, 9))关键细节scale_y max_height / (max_score * 1.1)中的*1.1是为最高分柱子留白避免顶到画布边缘anchorn让班级名文字顶部对齐y height-margin20anchore让分数右对齐刻度线所有坐标计算基于像素不依赖 DPI确保在不同分辨率机房电脑上显示一致。5.3 在主菜单中注册新功能修改gui/main_window.py在create_menu()方法中加入# gui/main_window.py片段 def create_menu(self): menubar tk.Menu(self) # ... 其他菜单 # 新增“报表”菜单 report_menu tk.Menu(menubar, tearoff0) report_menu.add_command(label班级平均分统计, commandself.open_chart_window) menubar.add_cascade(label报表, menureport_menu) self.config(menumenubar) def open_chart_window(self): # 防止重复打开多个图表窗口 if not hasattr(self, _chart_window) or not self._chart_window.winfo_exists(): self._chart_window ChartWindow(self) else: self._chart_window.lift() # 已存在则置顶5.4 服务层补充get_class_avg_scores()方法# service/student_service.py新增 def get_class_avg_scores(self) - list: 查询各班级平均分排除 class_name 为空的记录 conn get_connection() if not conn: return [] cursor conn.cursor(pymysql.cursors.DictCursor) try: sql SELECT class_name, ROUND(AVG(score), 1) as avg_score FROM students WHERE class_name IS NOT NULL AND class_name ! GROUP BY class_name ORDER BY avg_score DESC cursor.execute(sql) return cursor.fetchall() except Exception as e: logging.error(f查询班级平均分失败{e}) return [] finally: cursor.close() conn.close()为什么用pymysql.cursors.DictCursor它让fetchall()返回字典列表如[{class_name: 2301, avg_score: 87.5}]而不是元组列表前端取值直接item[class_name]可读性远高于item[0]。从那以后我每次加新图表功能都强制走一遍“Canvas 坐标推演 → 比例尺计算 → 边界留白 → 文字锚点校准”四步流程哪怕只是画个圆——因为机房投影仪一放大像素级偏差就会变成明显错位。希望帮到你。本文还有配套的精品资源点击获取