从Excel到桌面应用：用Python + PyQt5 + SQL构建完整的学校管理系统

在传统校园管理中，学生档案、课程安排、成绩记录往往散落在Excel表格和纸质文件中，查询一次数据需要在多个文档间反复切换。用Python + PyQt5 + SQL构建一套完整的学校管理软件，不仅是技术练习，更是对“数据如何驱动管理”这一命题的工程化回应。

这类系统的核心架构通常是经典的三层设计：表现层（PyQt5 GUI）、业务逻辑层（Python处理请求与规则校验）、数据访问层（SQL数据库存取）。这种分层让UI与数据操作解耦，便于后期维护和功能扩展。

一、数据库设计：承载业务语义的基石

数据库设计直接决定了系统能管什么、怎么管。从开源项目的实践来看，完整的学校管理系统通常包含以下核心表：

学生表（students） ：存储学号（设 UNIQUE 防止重复）、姓名、性别、班级、联系方式、入学年份等字段。学号作为主键，是所有关联查询的锚点。

教师表（teachers） ：记录教师ID、姓名、所属院系、职称、联系电话。教师与课程通过开课表关联。

课程表（courses） ：包含课程ID、课程名称、学分、学时等信息。课程本身是“模板”，具体到每个学期的开课安排由开课表承接。

开课表（course_offerings） ：这是连接教师、课程和学期的时间表——记录哪门课在哪个学期由哪位教师开设，以及上课时间、教室、最大选课人数。开课表的存在让同一门课程可以在不同学期复用，避免了数据冗余。

选课表（enrollments） ：记录哪位学生选了哪门开课，包含成绩字段（可空，成绩录入前为NULL）、选课时间。这是系统中数据量最大、增长最快的表。

用户表（users） ：存储登录账号、密码哈希值、角色（admin/teacher/student）、关联的外键ID（指向学生表或教师表）、账号状态（启用/禁用）、最后登录时间。

用SQL建表的语句大致如下：

CREATE TABLE students (
    student_id VARCHAR(20) PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    gender CHAR(1),
    class_name VARCHAR(30),
    phone VARCHAR(20)
);

CREATE TABLE users (
    user_id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) UNIQUE NOT NULL,
    password_hash VARCHAR(255) NOT NULL,
    role ENUM('admin', 'teacher', 'student') NOT NULL,
    ref_id VARCHAR(20),  -- 指向student_id或teacher_id
    is_active BOOLEAN DEFAULT TRUE
);

二、数据库连接层：统一管理会话

PyQt5通过 QtSql 模块提供了对SQL数据库的原生支持。连接层的封装应该做到：统一管理连接、异常时给出明确反馈、支持多种数据库驱动（MySQL用 QMYSQL，SQLite用 QSQLITE）。

from PyQt5.QtSql import QSqlDatabase, QSqlQuery

def create_connection():
    db = QSqlDatabase.addDatabase('QMYSQL')
    db.setHostName('localhost')
    db.setDatabaseName('school_db')
    db.setUserName('root')
    db.setPassword('your_password')
    if not db.open():
        print('数据库连接失败:', db.lastError().text())
        return False
    return True

对于本地部署或课程设计场景，SQLite是更轻量的选择——单文件、零配置、无需单独安装数据库服务。将数据库类型作为配置项，可以在 QMYSQL 和 QSQLITE 之间灵活切换，兼顾开发便利和生产环境的性能需求。

三、登录与权限：不止是“验证密码”

登录模块是整个系统的入口，也是权限控制的起点。一个健壮的登录模块需要做到三件事：

1. 验证身份：查询 users 表，比对用户名和密码哈希值，而非明文存储。
2. 检查状态：确认账号未被禁用。
3. 记录审计：登录成功后更新 last_login 时间戳，写入操作日志。

登录成功后，系统根据 role 字段决定进入哪个主界面——管理员看到全量数据管理面板，教师看到所授课程和成绩录入入口，学生只能看到自己的成绩和课表。

权限控制的精髓在于：不是登录后隐藏按钮，而是从数据查询层面做隔离。教师查课表时自动追加 WHERE teacher_id = ?，学生查成绩时自动追加 WHERE student_id = ?，这个过滤条件由登录态携带的用户信息在模块初始化时动态注入。

四、核心CRUD：Model/View架构的威力

PyQt5的 QSqlTableModel 是操作数据库表的利器——它将数据库表直接映射为表格模型，天然支持自动同步、主键识别、事务回滚和内置编辑缓冲。配合 QTableView 使用，可以做到“界面编辑即数据库更新”。

from PyQt5.QtSql import QSqlTableModel
from PyQt5.QtWidgets import QTableView

model = QSqlTableModel()
model.setTable('students')
model.setEditStrategy(QSqlTableModel.OnFieldChange)  # 编辑即提交
model.select()

view = QTableView()
view.setModel(model)

setEditStrategy 有三个选项：

• OnFieldChange：单元格编辑完成后立即提交到数据库
• OnRowChange：行编辑完成后提交
• OnManualSubmit：手动调用 submitAll() 才提交

对于学生管理这类高频操作，OnFieldChange 最直观；对于成绩录入这类需要批量审核的场景，OnManualSubmit 更合适——教师录入整行成绩后统一提交，提交前可随时撤销。

增删改查的操作封装在独立的业务模块中。例如 student.py 负责学生信息的增删改查，grade.py 处理成绩录入与查询，classes.py 管理班级列表。每个操作都包裹事务控制，比如删除学生时同步处理其选课记录，避免产生孤儿数据。

五、实际项目结构参考

一个可直接运行的PyQt5学校管理系统，其目录结构通常如下：

SchoolManagement/
├── main.py              # 程序入口
├── login.py             # 登录窗口
├── register.py          # 注册窗口
├── student.py           # 学生管理模块（增删改查）
├── grade.py             # 成绩录入与查询
├── classes.py           # 班级管理
├── user.py              # 用户权限控制
├── db_student.sql       # 数据库建表脚本
├── requirements.txt     # 依赖清单（PyQt5、PyMySQL等）
├── ui/                  # Qt Designer设计的界面文件
│   ├── main.ui
│   └── login.ui
└── images/              # 图标资源

这种结构的好处是模块分工明确：main.py 只负责启动和路由，具体功能按业务领域拆分到独立文件中。即便是学校机房的老旧Windows 7机器（4G内存），安装Python后也能在几分钟内跑起来。

六、从桌面到云端：技术演进路径

桌面版跑通后，这套系统具备向Web端演进的能力。MySQL作为后端数据库天然支持网络访问，桌面GUI（PyQt/Tkinter）的业务逻辑可以逐步迁移到Django的MTV架构中。演进路径大致是：

1. 第一阶段：PyQt5桌面应用 + MySQL本地部署，满足单机房或单办公室的使用需求。
2. 第二阶段：将MySQL迁移到云数据库（如阿里云RDS），桌面应用通过网络连接，实现多地点访问。
3. 第三阶段：用Django重写前端，将桌面GUI替换为Web界面，原有数据表结构和业务逻辑复用。

这种渐进式迁移策略，让学校可以在不中断业务的情况下完成技术升级。

总结

用Python + PyQt5 + SQL构建学校管理系统，本质上是在做一个 “数据驱动的桌面应用” 。它考验的不是炫酷的前端特效，而是对业务实体的准确抽象、对数据库关系的合理设计、以及对用户权限的精细控制。

从实际项目来看，这套技术栈在以下几个方面具有显著优势：PyQt5保证了跨平台兼容性和低学习门槛，教师双击就能运行；MySQL/SQLite提供了稳定可靠的数据持久化能力；清晰的模块划分让系统具备可维护性和可扩展性。

对于正在学习PyQt5和数据库编程的开发者而言，从一个真实的学校管理需求出发，远比抄一个“通讯录管理”Demo更有价值——因为你会遇到真实场景才有的问题：数据一致性、权限隔离、事务控制、多表关联查询。而这些，正是桌面应用开发的核心能力。