“作业管理系统”一个听起来毫无新意、但每年课程设计和毕业设计里都能反复见到的选题。说实话这类项目真正难住人的地方往往不是“能不能做出功能”而是“能不能把数据库、业务逻辑、界面这三层完整地串起来”。太多人写完一个窗口就卡住写完两张表就不知道下一步干嘛。今天这套「基于 Python 的中学家庭作业管理系统」我会把整个设计过程从头拆到尾需求边界怎么定、数据库表怎么建、GUI 窗口怎么分层、核心代码怎么实现、最后怎么跑起来验证。文章里会给出可直接复用的建表脚本、公共方法、业务函数和界面联动的关键代码并告诉你每一步为什么要这么做。适合刚开始接触 Python 开发、准备做课程设计或者想系统理解“Python SQLite PyQt5 三件套”如何落地的人。1. 需求分析与整体拆解1.1 这个系统到底在解决什么问题中学家庭作业管理的核心痛点其实不是“布置作业”这个动作而是“留痕与反馈”。老师在微信群里发一张作业照片学生交没交、交得怎么样全凭手动表格记录一旦班级人数超过四十统计漏掉几个人太正常了。家长想知道孩子今天的作业是什么也得逐个翻群消息。所以这套系统要解决的是把“布置作业 - 学生查看 - 学生提交 - 老师批改评分”这条链路搬到电脑上让每一份作业都有记录、有截止时间、有提交状态、有分数反馈。落到具体场景上老师登录后可以给某个班级发布作业设置截止时间学生登录后能看到本班所有作业还有哪些没交一目了然老师还能按班级查看提交明细给每份作业打分并写评语。1.2 功能需求与角色边界我在最初设计时没有急着写代码先把角色和权限画清楚。系统里至少要区分三类角色教师、学生、管理员或班主任。教师负责发布作业、查看提交记录、批改评分学生负责查看作业、提交作业、查看成绩管理员负责维护班级、学生名单和基础科目数据。对应的功能模块可以拆成四个班级与用户管理、作业发布管理、作业提交管理、统计展示。为了避免功能蔓延第一版不需要做太花哨的“图表统计”只要在首页显示“待提交作业数”“已完成数”“最近截止的作业列表”就足够体现系统的价值了。一个清楚的角色功能表比堆十个按钮但都做不深要强得多。功能模块教师端学生端登录认证教师账号登录学生账号登录作业发布选择班级和科目填写标题、内容、截止时间查看本班作业列表作业提交查看每份作业的提交名单与内容填写提交说明、提交时间自动记录批改评分录入分数和评语查看自己的分数和评语数据首页显示自己发布作业的提交率显示自己的待办作业1.3 技术选型为什么是 Python SQLite PyQt5这个组合是我对比过几种方案后定下来的适合课程设计也适合不想在前端折腾的人学习。数据库用 SQLite而不是 MySQL。在一个单机系统里让用户去安装配置 MySQL 服务端、创建用户、导入导出数据这些步骤本身就成了一道门槛。SQLite 是 Python 标准库自带的一个文件就是一个数据库程序调用时开个连接就能读写完全满足几十个班级、上千条作业记录的场景。如果你哪天要换成 MySQL业务层里只要把 SQL 方言稍微调一下整体结构不用推倒重来。GUI 用 PyQt5。Python 自带的 Tkinter 也不能说不行但做多窗口切换、表格展示、控件布局这些实际操作时Tkinter 写起来繁琐且界面丑。PyQt5 的 QStackedWidget 可以优雅地实现页面切换QTableWidget 可以直接管理表格数据信号槽机制让按钮和事件绑定非常清晰。代价是需要额外安装一个依赖包但用 pip 装一下就完事成本很低。选择这个技术组合还有一个现实理由市面上绝大多数课程设计资料都围绕这套组合展开遇到问题容易搜到解决方案答辩时面试官或老师也不会觉得你选型过于冷门。2. 数据库设计一张表都不能少2.1 实体关系怎么理数据库设计是整套系统里最值得花时间的一步。我见过很多半途而废的项目代码写到一半才发现少了一张关联表只能反复回头改表结构。如果你把下面这些实体关系理清楚了写代码时会顺畅非常多。系统核心实体包括用户、学生、教师、班级、科目、作业、提交记录。用户表是所有登录账号的统一入口不分角色统一存用户名和密码学生表和教师表分别存扩展信息学生关联班级教师关联用户作业表关联发布教师、目标班级、所属科目同时记录标题、内容和截止时间提交记录表就是“某个学生提交了某份作业”的关联表加上提交时间、提交内容、分数、评语、批改状态。这里有一个设计细节容易忽略为什么已经建了用户表还要单独建学生表和教师表因为登录只需要用户名和密码而业务查询需要“学号”“班级”“教师姓名”这类扩展属性。如果不拆开用户表字段会越加越乱而且同一个用户既可能是学生又可能是教师这在角色扩展时非常僵硬。2.2 核心建表脚本我建表时会把外键约束和默认值直接写进 SQL避免代码层再去手动控制数据完整性。下面这段是经过精简但可直接运行的建表脚本CREATE TABLE IF NOT EXISTS users ( id INTEGER PRIMARY KEY AUTOINCREMENT, username TEXT NOT NULL UNIQUE, password TEXT NOT NULL, role TEXT NOT NULL CHECK(role IN (admin, teacher, student)), real_name TEXT NOT NULL ); CREATE TABLE IF NOT EXISTS classes ( id INTEGER PRIMARY KEY AUTOINCREMENT, grade INTEGER NOT NULL, class_name TEXT NOT NULL, head_teacher_id INTEGER, FOREIGN KEY (head_teacher_id) REFERENCES teachers(id) ); CREATE TABLE IF NOT EXISTS teachers ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL UNIQUE, subject_id INTEGER NOT NULL, FOREIGN KEY (user_id) REFERENCES users(id), FOREIGN KEY (subject_id) REFERENCES subjects(id) ); CREATE TABLE IF NOT EXISTS students ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL UNIQUE, class_id INTEGER NOT NULL, student_no TEXT NOT NULL, FOREIGN KEY (user_id) REFERENCES users(id), FOREIGN KEY (class_id) REFERENCES classes(id) ); CREATE TABLE IF NOT EXISTS subjects ( id INTEGER PRIMARY KEY AUTOINCREMENT, subject_name TEXT NOT NULL UNIQUE ); CREATE TABLE IF NOT EXISTS homeworks ( id INTEGER PRIMARY KEY AUTOINCREMENT, teacher_id INTEGER NOT NULL, class_id INTEGER NOT NULL, subject_id INTEGER NOT NULL, title TEXT NOT NULL, content TEXT, deadline TEXT NOT NULL, created_at TEXT NOT NULL DEFAULT (datetime(now, localtime)), FOREIGN KEY (teacher_id) REFERENCES teachers(id), FOREIGN KEY (class_id) REFERENCES classes(id), FOREIGN KEY (subject_id) REFERENCES subjects(id) ); CREATE TABLE IF NOT EXISTS submissions ( id INTEGER PRIMARY KEY AUTOINCREMENT, homework_id INTEGER NOT NULL, student_id INTEGER NOT NULL, content TEXT, submit_time TEXT NOT NULL DEFAULT (datetime(now, localtime)), status INTEGER NOT NULL DEFAULT 1, score REAL, comment TEXT, UNIQUE(homework_id, student_id), FOREIGN KEY (homework_id) REFERENCES homeworks(id), FOREIGN KEY (student_id) REFERENCES students(id) );注意两个关键点UNIQUE(homework_id, student_id)是为了防止同一个学生对同一份作业重复提交。有了这条约束插入重复提交记录时数据库会直接报错代码层就能捕获这个异常提示“你已经提交过这份作业”而不需要自己先查一遍再决定。deadline我用 TEXT 类型存格式统一为“YYYY-MM-DD HH:MM:SS”。SQLite 没有专门的日期时间类型但只要字符串格式统一排序、比较都是按字典序生效的比如WHERE deadline 2025-06-01 00:00:00就能正确筛选截止时间之后的作业。2.3 初始化数据与密码处理系统第一次启动时需要写入默认账号和基础数据否则用户打开登录窗口都不知道输什么。初始化数据包含一个管理员账号、一个教师账号、一个学生账号、两个班级、三五个科目和一份示例作业。密码不能用明文。虽然课程设计不需要做高并发安全系统但“密码哈希”这个概念在答辩时是个加分项实现成本也不高。我在初始化脚本里用 SHA-256 加固定盐的方式做了一次哈希import hashlib def hash_password(password: str, salt: str homework_salt) - str: return hashlib.sha256((password salt).encode(utf-8)).hexdigest()初始化时插入用户的代码大概是users [ (admin, hash_password(admin123), admin, 系统管理员), (teacher01, hash_password(teacher123), teacher, 张老师), (student01, hash_password(student123), student, 李小星), ] for username, pwd, role, real_name in users: conn.execute( INSERT INTO users (username, password, role, real_name) VALUES (?, ?, ?, ?), (username, pwd, role, real_name), )插入顺序需要特别注意因为学生表和教师表的外键都指向 users 表所以必须先插入用户拿到user_id后再插入班级、学生、教师。classes表的外键head_teacher_id指向teachers表所以 teachers 表要在 classes 之前插入。这些顺序只要在初始化脚本里遵守一次就够了后面重复执行时因为有CREATE TABLE IF NOT EXISTS不会重复建表但如果是重新初始化建议先删掉旧数据库文件再跑脚本避免主键冲突。3. GUI界面设计简化操作路径是关键3.1 窗口模块划分很多人写 GUI 一上来就堆控件main 函数里塞几百行代码结果窗口一多就完全没法维护。我建议按角色拆窗口、按页面拆模块登录窗口负责认证和角色识别。主窗口根据登录角色显示不同的导航侧栏。页面容器用一个 QStackedWidget 管理多个子页面比如首页看板、作业列表页、提交页、评分页。对话框比如“发布作业”弹窗、“提交作业”弹窗用 QDialog 实现。每个页面都做成独立的类类与类之间只通过业务层函数通信不跨窗口直接操作控件。比如作业列表页需要用到当前用户信息就在初始化时把这个用户字典传进去而不是使用全局变量。3.2 登录窗口与主控台结构登录窗口设计很简单两个输入框、一个登录按钮、一个退出按钮。点击登录按钮后调用业务层login(username, password)收到非 None 结果就打开主窗口并关闭登录窗口。主窗口我强烈建议用QMainWindow QWidget QStackedWidget的组合而不是把所有内容堆在一个窗体里。左侧放一个 QListWidget 作为导航右侧放 QStackedWidget 切换页面。比如教师端导航项是“首页看板”“发布作业”“作业批改”学生端导航项是“首页看板”“提交作业”“我的成绩”。这样代码逻辑清晰界面也接近真实桌面软件的样子。class MainWindow(QMainWindow): def __init__(self, user): super().__init__() self.user user self.setWindowTitle(中学家庭作业管理系统) self.resize(900, 600) self.nav_list QListWidget() self.stack QStackedWidget() if self.user[role] teacher: self.nav_list.addItems([首页看板, 发布作业, 作业批改]) else: self.nav_list.addItems([首页看板, 提交作业, 我的成绩]) self.stack.addWidget(HomePage(user)) self.stack.addWidget(AddHomeworkPage(user)) self.stack.addWidget(GradePage(user)) layout QHBoxLayout() layout.addWidget(self.nav_list, 1) layout.addWidget(self.stack, 4) container QWidget() container.setLayout(layout) self.setCentralWidget(container) self.nav_list.currentRowChanged.connect(self.stack.setCurrentIndex)这里关键点是把currentRowChanged信号直接连接到self.stack.setCurrentIndex对应的下标就能自动完成页面切换。不需要写 if-else 判断这是 PyQt5 里非常典型的信号槽用法。3.3 作业列表与提交页面的交互思考学生端最核心的页面是作业列表。它的目标不是“展示所有字段”而是让用户一眼看到“我该做什么、哪些还没交”。所以表格列我安排为作业标题、所属科目、截止时间、状态、操作按钮。这里的“状态”不要用数据库里的原始布尔值而要在加载时动态计算。逻辑很简单if submission_exists: status_text 已提交 elif now deadline: status_text 已截止 else: status_text 待提交这样界面看到的是友好文案内部逻辑仍然基于数据库原始数据判断互不干扰。“操作”列一般放一个“提交”按钮。你可能会想着在 QTableWidget 的单元格里放按钮其实可以用setCellWidget实现但要记录按钮对应的行和作业 ID防止点击后取错数据。更简单的方法是在表格下面放一个“提交选中作业”的按钮用户先选中行再点击提交窗口交互难度比满表格按钮低得多也不容易出 bug。4. 核心代码实现详解4.1 项目文件结构在写第一行代码前先把目录结构定下来homework_manager/ ├── main.py # 程序入口初始化数据库 打开登录窗口 ├── requirements.txt # PyQt5 依赖 ├── database/ │ ├── db_manager.py # 连接 SQLite 的公共方法 │ └── init_db.py # 建表与初始化数据 ├── services/ │ ├── auth_service.py # 登录认证 │ └── homework_service.py # 作业发布、查询、提交、批改 ├── ui/ │ ├── login_window.py │ ├── main_window.py │ ├── home_page.py │ ├── add_homework_page.py │ └── grade_page.py └── homework.db # 运行时自动生成这种结构把“数据库操作”“业务逻辑”“界面显示”三层分开是最适合这个规模项目的组织方式。你可能会想一个课程设计有必要分这么多文件夹吗有必要。分层之后如果数据库报错你不会去界面代码里找半天如果界面布局乱了也不会改动业务函数。4.2 数据库连接与公共方法所有数据库操作都用同一个连接管理器这是避免代码里到处写sqlite3.connect()的关键。我用了contextmanager把连接、事务提交、异常回滚包进一个get_conn函数里业务层只负责写 SQL不用关心连接什么时候开、什么时候关。import sqlite3 from contextlib import contextmanager DB_PATH homework.db contextmanager def get_conn(): conn sqlite3.connect(DB_PATH) try: conn.row_factory sqlite3.Row yield conn conn.commit() except Exception: conn.rollback() raise finally: conn.close()row_factory sqlite3.Row这行非常值得养成习惯。它让查询结果像字典一样支持row[username]访问而不是row[0]这种谁看了都要数一遍列顺序的方式。后续开发效率和可读性提升非常明显。事务处理逻辑也写在这里正常情况下yield结束后自动 commit一旦业务层抛异常回滚所有未提交的修改。课程设计阶段很多人容易忽略事务觉得“数据库写入失败就失败呗”但一旦出现半途中止的写操作数据就处于不可信状态排查起来远比一开始加上事务麻烦。4.3 业务层登录、发布、提交、批改登录函数没什么神秘就是查表对比哈希值def login(username: str, password: str): with get_conn() as conn: user conn.execute( SELECT * FROM users WHERE username ?, (username,), ).fetchone() if user and user[password] hash_password(password): return dict(user) return None发布作业的核心是拼一个 INSERT 语句。教师端会从用户字典里取teacher_id从界面控件里拿班级、科目、标题、内容和截止时间def publish_homework(teacher_id, class_id, subject_id, title, content, deadline): with get_conn() as conn: conn.execute( INSERT INTO homeworks (teacher_id, class_id, subject_id, title, content, deadline) VALUES (?, ?, ?, ?, ?, ?) , (teacher_id, class_id, subject_id, title, content, deadline), )学生端查看作业时需要把作业表和提交状态关联起来。我用 LEFT JOIN 判断当前学生是否已经提交def list_homeworks_for_student(student_id): with get_conn() as conn: return conn.execute( SELECT h.*, s.subject_name, c.class_name, CASE WHEN sub.id IS NULL THEN 0 ELSE 1 END AS submitted FROM homeworks h JOIN subjects s ON h.subject_id s.id JOIN classes c ON h.class_id c.id LEFT JOIN submissions sub ON sub.homework_id h.id AND sub.student_id ? WHERE h.class_id (SELECT class_id FROM students WHERE id ?) ORDER BY h.deadline ASC , (student_id, student_id), ).fetchall()这个 SQL 有个细节值得学习LEFT JOIN 的条件里带上AND sub.student_id ?确保只关联当前登录学生而不是把所有人的提交记录都关联出来。如果漏了第二个条件一个班有三十个学生这条 SQL 会把每一份作业变成三十行那就全乱了。批改评分逻辑是在提交记录上更新分数和评语def grade_submission(submission_id, score, comment): with get_conn() as conn: conn.execute( UPDATE submissions SET score ?, comment ?, status 2 WHERE id ?, (score, comment, submission_id), )这里额外说明一下status字段的设计1表示已提交待批改2表示已批改。它跟提交记录是否存在是两个维度的事不要混用。4.4 界面层登录窗口与主窗口联动登录窗口代码要特别注意弹出主窗口后窗口对象不能马上被垃圾回收。很多人犯过这个错写LoginWindow().show()窗口一闪而过程序直接退出。正确做法是保存引用class LoginWindow(QWidget): def __init__(self): super().__init__() self.login_btn.clicked.connect(self.check_login) def check_login(self): user login(self.username_edit.text().strip(), self.password_edit.text().strip()) if user: self.main_window MainWindow(user) self.main_window.show() self.close() else: QMessageBox.warning(self, 登录失败, 用户名或密码错误请重试)主窗口里的页面对象也同样要保存在self上比如self.home_page HomePage(user)而不是直接addWidget(HomePage(user))。因为一旦没有强引用某些 PyQt 版本在页面切换时就可能出现“操作已被删除的 C 对象”的报错。界面加载数据的通用套路是进入页面时手动调一次refresh_data方法数据变化后也调一次。拿学生提交页举例切换到这个页面时刷新作业表格提交成功后再次刷新保证表格状态从“待提交”变为“已提交”。5. 运行流程与功能验证5.1 环境准备与启动步骤先准备运行环境项目根目录下执行pip install pyqt5然后运行主程序python main.py如果之前没有数据库文件main.py里会先调用init_database()完成建表和初始化数据然后打开登录窗口from database.init_db import init_database from ui.login_window import LoginWindow from PyQt5.QtWidgets import QApplication import sys if __name__ __main__: init_database() app QApplication(sys.argv) window LoginWindow() window.show() sys.exit(app.exec_())注意init_database()和QApplication的创建顺序有讲究。数据库初始化不需要界面事件循环可以放在前面而登录窗口必须在app.exec_()之前就创建好否则窗口没法进入 Qt 事件循环。5.2 教师端操作路径实录我建议你按下面顺序测试教师端启动程序输入teacher01 / teacher123系统进入主窗口左侧导航能看到“首页看板”“发布作业”“作业批改”。点击“发布作业”选择班级“七年级一班”科目“数学”标题“第一章有理数练习”内容“完成课本第12页第1-10题”截止时间设置成明天下午六点点击发布。回到“作业批改”页应该能看到这份作业出现在列表中但还没有学生提交因为当前还没有学生实际执行提交操作。切到学生账号测试后再切回教师端刷新“作业批改”页面就能看到学生提交记录点击“评分”输入分数和评语。整个过程的核心验证点是数据在教师端发布 - 学生端可见 - 提交后教师端可见这条链路是通的。5.3 学生端操作路径实录输入student01 / student123进入学生端首页会显示“待提交作业 1 份已完成 0 份”。点击“提交作业”页表格里能看到该班所有作业。选中最新的数学作业点击“提交选中作业”弹出一个对话框填写“已完成详见草稿纸拍照”确认提交。再次刷新作业表格状态列变成“已提交”。此时回到教师端查看批改记录能看到这次提交的内容和时间。为了验证“已截止”状态可以再布置一份截止时间设置到过去几分钟的作业学生端刷新后状态列应显示“已截止”操作按钮自动变成不可点击状态。这一步验证非常关键因为“截止时间”是作业管理系统最核心的业务状态之一如果它不准确整个系统的时间提醒功能就失去了意义。6. 常见问题排查与实践避坑6.1 数据库相关报错最经典的错误是sqlite3.OperationalError: no such table: users。原因一般是只写了建表脚本但没调init_database()或者相对路径不对数据库文件被创建到了别的位置。解决方法是不要在main.py里用相对路径拼数据库地址直接统一在项目的根目录下运行程序初始化数据库的脚本只在首次运行时执行后续如果重建就把旧的homework.db删除再执行。另一个常见问题是“插入重复数据报错”。如果你手工执行测试时重复点了提交作业按钮就会触发UNIQUE(homework_id, student_id)约束。代码层要在except sqlite3.IntegrityError里捕获这个异常然后弹提示“你已经提交过该作业”而不是让程序直接崩溃。6.2 界面显示与信号槽问题窗口“闪退”在 PyQt5 里特别常见。除了上一节说的对象引用问题还有一种情况是按钮信号连接写成了self.button.clicked.connect(self.method())多了括号导致在创建界面时就直接调用了方法而不是绑定信号。正确写法是connect(self.method)不要加括号。页面切换后表格数据不刷新也是典型问题。QStackedWidget 切换页面不会自动触发“页面显示”事件所以你不能指望切换过来表格就是最新的。处理方法有两个在导航列表的currentRowChanged信号里调用对应页面的refresh_data()或者在每个页面初始化之后立即调用一次refresh_data()。6.3 中文字符与日期排序的坑Python 3 默认源码编码是 UTF-8所以源文件里的中文字符串基本不会乱码但 PyQt5 界面上的中文偶尔会出现“口口”乱码尤其是在老版本 Windows 上。如果遇到可以在main.py里显式设置字体from PyQt5.QtGui import QFont app.setFont(QFont(Microsoft YaHei, 10))日期字段存的是字符串SQLite 排序用的是字典序。只要格式是“YYYY-MM-DD HH:MM:SS”字典序正好等于时间先后顺序所以直接ORDER BY deadline ASC就能得到“最早截止的作业排最前”。如果你存成了“YYYY/MM/DD”或者“DD-MM-YYYY”排序结果就会完全错乱这是最常见的坑。6.4 课程设计答辩时容易被追问的地方我发现老师和面试官最喜欢问三个点为什么用 SQLite、为什么用 PyQt5、如何防止重复提交。不用慌答案都在上面了。SQLite 是轻量嵌入式数据库适合单机和小型桌面系统无需独立服务部署成本低PyQt5 有丰富的桌面控件和信号槽机制适合快速开发本地 GUI 应用防止重复提交通过UNIQUE(homework_id, student_id)数据库约束来兜底代码层捕获 IntegrityError 后给出友好提示。这样回答既说明你懂业务又说明你理解数据库约束的价值。还有一个小坑要提前准备status字段用的是整数批改状态1和2只是内部约定数据库里看不见含义。答辩时如果被问“为什么不用字符串状态”你可以解释为状态枚举在代码里定义成常量整数存储占用小、查询效率高后续如果要做扩展直接在枚举层加常量就行不需要改数据库结构。我在实际做完这个项目后最大的体会是不要把“完整”理解成一键生成所有代码而是要理解一个功能从界面点击、到业务函数、再到数据库写入的完整调用链。当你把这条链路跑通之后后面加新页面、加新功能都只是复制这个模式而已。如果还有余力可以在班级管理、作业附件上传、提交率统计这几个方向继续扩展这一个骨架足够你往里填很多东西了。