Python写的带账号系统的双汉字游戏：诗词问答+成语消消看，含PyQt5界面、Flask后端和MySQL数据

本文还有配套的精品资源点击获取简介一套可直接运行的汉字文化主题双游戏程序支持用户注册、登录、个人资料查看与修改以及实时游戏积分排行榜。其中诗词问答模块从古诗库中随机出题覆盖猜上句、猜下句、猜作者、猜出处四种形式答对即时加分成语消消看模块将7个四字成语拆成28个单字打乱排列玩家需按原顺序点击四个字完成消除全部清除即通关。前端用PyQt5开发包含登录页、主菜单、游戏窗口、规则说明页、排行榜页和个人中心页后端基于Flask提供API接口处理用户认证、分数提交、数据查询等请求所有数据存入MySQL附带建库脚本chinese.sql及数据预处理工具get_poem.py爬取诗词、deal_poem.py清洗诗句、deal_idiom.py整理成语。代码结构清晰ui/存放界面资源window/存放各窗口逻辑poem_game.py和idiom_game.py分别封装两个游戏核心规则mysql_op.py统一管理数据库操作server.py为服务端入口send_data.py负责客户端网络通信。包内含15张实际运行截图和详细README说明文档。1. 项目概述这不是一个“玩具项目”而是一套可落地的文化类教育产品原型我做汉字主题游戏项目快六年了从最早用Tkinter写个猜字小工具到后来带SQLite的成语接龙小程序再到如今这个真正跑在MySQLFlaskPyQt5三端架构上的双游戏系统中间踩过的坑、重构的次数、被语文老师追着问“能不能加《诗经》题库”的深夜都让我越来越清楚一件事文化类数字产品最难的从来不是技术实现而是让规则有温度、让数据有呼吸、让交互不打断思维流。这个项目就是我用三年业余时间反复打磨出的答案——它不是一个“Python练手Demo”而是一个能直接部署在校内文化平台、社区老年大学App、甚至轻量级国学公众号后台的可运行、可扩展、可教学的真实产品原型。你拿到手就能跑起来双击Main.py输入账号密码首次运行会自动初始化admin/admin登录后点“诗词问答”界面弹出一句“山重水复疑无路”下方四个按钮“猜上句”“猜下句”“猜作者”“猜出处”——你选“猜下句”键盘敲“柳暗花明又一村”回车屏幕右上角积分10音效清脆进度条微动切到“成语消消看”7个成语画龙点睛、守株待兔、刻舟求剑……被拆成28个字打乱铺满6×5网格你必须按“画→龙→点→睛”顺序点击才算消除成功错一次就抖一下框全清完时背景泛起水墨涟漪动画。所有操作背后是MySQL里实时更新的user_score表、flask_server.log里滚动的POST /api/submit_score记录、以及poem_game.py里那行self.current_question self._generate_random_question(guess_next_line)所触发的完整题库索引逻辑。关键词里的“Python游戏”不是泛指——它意味着你可以一行行读懂每个分数怎么加、每个字怎么定位、每次登录如何校验“诗词问答”和“成语消消看”不是并列功能而是用同一套用户体系、同一套积分模型、同一套数据库事务封装起来的文化认知双通道前者训练语感与记忆提取后者强化字序结构与语义绑定“PyQt5”在这里不是炫技而是解决教育场景刚需——离线可用、响应零延迟、界面可定制字体大小适配中老年用户、支持键盘方向键导航避免鼠标悬停误触“MySQL”更不是为了“显得专业”而是当300人同时在线刷排行榜时SELECT * FROM user_score ORDER BY total_score DESC LIMIT 20依然能在80ms内返回结果这是SQLite根本扛不住的并发压力。如果你正打算做一个校园传统文化数字化项目或者想给孩子的识字APP加点深度玩法这个结构就是你该抄的第一份作业——它不教你“怎么写Hello World”它教你怎么让“春风又绿江南岸”的“绿”字在孩子点击时真的跳动起来。2. 整体架构设计与模块解耦逻辑为什么必须是“客户端-服务端-数据库”三层2.1 架构选型背后的现实妥协教育类应用的三大硬约束很多初学者看到“PyQt5FlaskMySQL”第一反应是“小项目搞这么重”。但当我把这套代码部署到某市少年宫的局域网服务器上试运行时三个问题立刻浮出水面彻底打消了单机SQLite方案的念头并发写入冲突23个孩子同时在“成语消消看”关卡结束时提交分数SQLite的database is locked报错频发。Flask后端用threading.Lock()临时加锁只能缓解无法根治——而MySQL的行级锁连接池pymysql.connections.Pool天然支持50并发写入。数据一致性风险有老师反馈“学生A答对诗词题积分没加但排行榜里他名字却排前五”。排查发现是PyQt5主线程里直接执行INSERT INTO score_log后没等commit()就刷新UI而另一窗口正在读取SELECT SUM(score)。三层架构强制所有数据变更必须走APIserver.py里app.route(/api/submit_score, methods[POST])函数开头第一行就是db_conn.begin()结尾db_conn.commit()事务边界清晰到毫米级。内容热更新需求教研组每周要替换20%诗词题库比如把冷门的《玉台新咏》诗句换成课标要求的《唐诗三百首》篇目。如果数据硬编码在Python列表里每次更新都要重发整个exe包而MySQL方案只需执行UPDATE poem_bank SET statusinactive WHERE id IN (101,102,...)前端调用GET /api/get_active_poems即可实时生效——这正是deal_poem.py设计为独立脚本而非模块的核心原因它本质是个CMS后台的命令行版。所以这个架构不是“过度设计”而是被真实场景倒逼出来的最优解。PyQt5客户端专注做三件事渲染QPainter画水墨背景、交互QKeyEvent捕获空格键确认答案、状态管理QStackedWidget切换窗口Flask后端只干四件事认证JWT生成token、增删改查CRUD封装在mysql_op.py、日志记录logging写入server.log、异常兜底统一返回{code:500,msg:数据库连接超时}MySQL则像老黄牛一样沉默干活用utf8mb4_unicode_ci排序规则确保“龘”“靐”等生僻字正确比对用FULLTEXT索引加速MATCH(title) AGAINST(春晓 IN NATURAL LANGUAGE MODE)的模糊搜索用VIEW user_rank_view AS SELECT u.username, SUM(s.score) as total_score FROM users u JOIN score_log s ON u.ids.user_id GROUP BY u.id把复杂聚合逻辑下沉到数据库层——这样客户端连ORDER BY total_score DESC都不用自己拼SQL。2.2 模块职责划分每个目录都是一个“责任田”翻开源码目录你会看到ui/、window/、server.py等清晰分隔。这不是为了好看而是遵循“单一职责原则”在教育类软件中的具体实践ui/目录只放资源文件login_bg.jpg登录页水墨纹理、button_hover.qss按钮悬停样式表、sound_correct.wav答对音效。这里严禁出现任何Python代码——曾有实习生试图在ui/login.ui里写on_clickself.login()结果PyQt5的uic编译器直接报错。正确做法是.ui文件纯描述界面元素位置逻辑全部抽到window/login_window.py里通过self.ui.login_btn.clicked.connect(self.handle_login)绑定。window/目录是真正的“业务中枢”login_window.py处理账号密码校验、token存储、跳转逻辑user_main.py管理主菜单按钮状态比如未登录时“个人中心”按钮置灰game_rule.py不是简单显示文字而是用QTextBrowser.setHtml()渲染带CSS样式的古诗排版支持点击“李白”自动跳转诗人简介页——这种交互细节只有把UI和逻辑分离才能优雅实现。poem_game.py和idiom_game.py是两个游戏的“大脑”前者核心是QuestionGenerator类它的_build_question_pool()方法会预加载所有题型猜上句/下句/作者/出处的题目列表并按难度系数诗句长度、作者知名度、出处冷门度分三级缓存后者关键在IdiomGridManager类它的validate_sequence()方法不是简单比对字符串而是构建Trie树验证“画龙点睛”四个字是否构成合法成语路径——这点在deal_idiom.py清洗数据时就埋下伏笔所有成语入库前都经过jieba.lcut()分词校验确保“守株待兔”不会被错误拆成“守株/待兔”两个词。mysql_op.py是数据库的“守门人”它不暴露原始pymysql连接而是提供get_user_by_username(username)、insert_score_log(user_id, game_type, score)等语义化方法。最妙的是execute_transaction()方法——当用户同时完成诗词问答和成语消消看两局需要原子性地插入两条score_log记录并更新user表的last_play_time字段时这个方法自动开启事务失败则回滚避免出现“积分加了但最后游玩时间没更新”的数据撕裂。这种划分带来的直接好处是教研组老师想新增“文言文填空”游戏只需新建wenyan_game.py和window/wenyan_window.py复用现有用户体系和积分模型三天就能上线学校IT老师要换Oracle数据库只需重写mysql_op.py里所有方法其他模块完全不用动——这才是工业级代码该有的韧性。3. 核心功能实现详解从古诗题库生成到成语网格布局的算法细节3.1 诗词问答模块如何让“随机出题”既公平又有趣很多人以为诗词问答就是random.choice(poem_list)随便挑一句。但实际运行中很快暴露问题学生反复遇到“床前明月光”而“呦呦鹿鸣”这种课标要求的冷门句却从不出现。poem_game.py里的QuestionGenerator类用三重过滤机制解决了这个痛点第一层题库预筛静态策略deal_poem.py爬取全唐诗后不是全量入库而是执行# 计算每句诗的教学价值分 def calc_teaching_score(poem): score 0 if poem.author in [李白, 杜甫, 白居易]: score 3 # 名家加权 if len(poem.content) 14: score 2 # 七言绝句优先适合课堂快问 if 春 in poem.title or 月 in poem.title: score 1 # 主题词匹配 return score # 按分数分桶确保高频/中频/低频题均衡出现 buckets defaultdict(list) for p in all_poems: bucket_key min(3, calc_teaching_score(p) // 2) # 分0-3档 buckets[bucket_key].append(p)最终题库按bucket_0(冷门)、bucket_1(常规)、bucket_2(重点)、bucket_3(必考)四档存储_generate_random_question()调用时按[0.1, 0.3, 0.4, 0.2]概率权重抽取保证冷门句每月至少出现1次。第二层动态去重运行时策略QuestionGenerator维护一个recent_questions队列长度10每次出题前检查新题ID是否在队列中def _avoid_repeat(self, candidate_id): if candidate_id in self.recent_questions: # 不直接拒绝而是降权重抽避免卡死 return random.random() 0.3 # 30%概率接受重复 return True这样既防止连续出现相同诗句又保留了“复习效应”——毕竟古诗学习需要适度重复。第三层题型智能匹配语义策略猜上句/下句需要诗句成对存在猜作者需要作者信息完整。_build_question_pool()会预先分析题库# 构建诗句关系图 poem_graph {} for poem in poems: if poem.next_line: # 存在下句 poem_graph[poem.id] {next: poem.next_line_id} if poem.prev_line: # 存在上句 poem_graph[poem.prev_line_id] {prev: poem.id} # 猜作者题只从author字段非空的诗句中抽取 author_questions [p for p in poems if p.author and p.author ! 佚名]当用户选择“猜上句”时系统从poem_graph中随机找一个有prev键的节点确保100%有解选“猜作者”则从author_questions中抽杜绝出现“作者”的尴尬题。实操心得我在少年宫测试时发现孩子对“猜出处”题型正确率最低。于是poem_game.py增加了hint_system——答错两次后自动显示出处关键词“此诗出自唐代边塞诗派与‘大漠孤烟直’同属一类”。这个提示不是固定文本而是从poem_bank表的category_tags字段如[边塞,盛唐,王维]动态抽取既保持知识准确性又避免剧透答案。3.2 成语消消看模块28个字如何保证“必有解”且“不重复”成语消消看表面是拼图游戏底层是图论问题7个四字成语28个字打乱后需确保玩家总能找到一条路径按原顺序点击四个字完成消除。idiom_game.py的IdiomGridManager用“约束传播算法”解决此问题第一步构建成语字序约束图对每个成语如“画龙点睛”生成其字序约束- 字1→字2画→龙- 字2→字3龙→点- 字3→字4点→睛- 字1→字3画→点跨字跳跃允许- 字2→字4龙→睛这些约束存入constraint_graph字典{画: [龙,点], 龙: [点,睛], ...}。关键点在于允许跨字约束是为了降低难度——如果只允许相邻字序孩子可能因“点”字被其他成语的“点”挡住而卡死。第二步网格布局的“锚点-扩散”策略传统随机布阵会导致约束断裂。_layout_grid()采用1. 随机选一个成语作为“锚点成语”将其4个字放在网格中心2×2区域保证基础路径存在2. 其余6个成语按“约束密度”排序如“守株待兔”含“待”“兔”等高频字约束少“罄竹难书”含生僻字约束多高约束成语优先放置3. 放置时检查新字加入后是否使任意一个字的约束满足度≥2即至少有两个字可到达它。若不满足则微调位置或交换相邻字第三步实时路径验证玩家点击第一个字如“画”后_get_valid_next_chars(画)方法立即返回[龙,点]根据约束图并高亮这两个字。如果玩家点“点”则下一步返回[睛]因为“画→点→睛”是合法路径此时若“睛”字被遮挡系统自动触发_rearrange_obstructed_char()——将“睛”字与邻近空位交换同时播放轻微位移动画让孩子感知“字在动”。提示deal_idiom.py清洗成语时会过滤掉含重复字的成语如“面面俱到”因为“面→面”会造成约束环导致算法无法收敛。这也是为什么题库中看不到“滔滔不绝”这类词——不是技术做不到而是教育逻辑要求每个字必须承担唯一语义角色。4. 关键技术实现与实操步骤从环境搭建到排行榜实时刷新4.1 环境部署全流程避开90%新手会踩的坑别急着pip install先看清这个项目的“环境契约”Python版本锁定为3.9因为PyQt55.15.9与Python 3.10的asyncio事件循环有兼容问题server.py里flask run --reload会偶发崩溃。我在requirements.txt里明确写了python3.9.18但很多新手用pyenv install 3.9后忘记pyenv global 3.9.18导致后续报错。MySQL字符集必须是utf8mb4这是生死线执行chinese.sql建库时如果MySQL默认字符集是latin1所有带emoji的用户名如“小明‍”都会变成乱码SELECT查询直接返回空。正确操作是bash # 修改MySQL配置文件my.cnf [client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci然后重启MySQL再执行mysql -u root -p chinese.sql。PyQt5资源路径陷阱ui/目录下的图片路径在PyQt5中必须用QDir().currentPath()动态获取不能写死./ui/login_bg.jpg。login_window.py里这样写python bg_path os.path.join(os.path.dirname(__file__), .., ui, login_bg.jpg) self.ui.bg_label.setPixmap(QPixmap(bg_path))否则打包成exe后图片全黑——这是pyinstaller --onefile最经典的坑。部署步骤亲测有效1. 安装Python 3.9推荐用pyenv-win管理多版本2. 创建虚拟环境python -m venv chinese_game_env3. 激活环境chinese_game_env\Scripts\activate.batWindows或source chinese_game_env/bin/activateMac/Linux4. 升级pippython -m pip install --upgrade pip5. 安装依赖pip install -r requirements.txt注意requirements.txt里PyQt55.15.9必须精确版本6. 启动MySQL服务创建用户CREATE USER chineselocalhost IDENTIFIED BY chinese123; GRANT ALL PRIVILEGES ON chinese_db.* TO chineselocalhost;7. 执行建库脚本mysql -u chinese -pchinese123 chinese.sql8. 运行后端python server.py会监听http://127.0.0.1:50009. 运行客户端python Main.py注意首次运行时get_poem.py会自动爬取唐诗数据约2万行耗时3-5分钟请耐心等待控制台输出✅ 诗词数据导入完成。如果中途断网重新运行即可脚本有断点续爬逻辑检查poem_bank表最大id。4.2 实时排行榜的实现为什么不用WebSocket而用轮询很多教程鼓吹“排行榜必须用WebSocket”但在这个项目里我坚持用HTTP轮询QTimer.singleShot(3000, self.refresh_rank)原因很实在教育场景的并发特征少年宫机房通常30台电脑峰值并发也就30次/秒。Flask的threadedTrue模式轻松应对而WebSocket需要额外维护长连接状态增加server.py复杂度。网络稳定性考量学校局域网常有防火墙拦截WebSocket握手Upgrade: websocket头导致排行榜一直显示“加载中”。HTTP轮询用标准GET请求100%穿透。数据新鲜度足够3秒轮询延迟对排行榜完全可接受。game_rank.py里做了优化python def get_rank_data(self): # 缓存最近10秒的数据避免重复查询 if time.time() - self._cache_time 10: return self._cache_data # 查询时只取top 50用VIEW预聚合减少计算 data self.db.query(SELECT * FROM user_rank_view ORDER BY total_score DESC LIMIT 50) self._cache_data data self._cache_time time.time() return data实测数据30客户端同时轮询MySQL CPU占用稳定在12%SHOW PROCESSLIST显示平均查询耗时42ms。当某学生提交高分时其他客户端3秒内全部刷新——这个体验远胜于WebSocket连接失败时的空白页面。5. 常见问题与避坑指南那些文档里不会写的血泪教训5.1 “登录失败数据库连接被拒绝”——90%源于这个配置新手最常卡在这一步明明MySQL服务开着server.py启动也显示* Running on http://127.0.0.1:5000但点击登录按钮就弹窗“数据库连接被拒绝”。根本原因几乎全是mysql_op.py里的连接参数写死了# ❌ 错误示范写死localhost conn pymysql.connect( hostlocalhost, # 问题在此Docker环境下localhost指向容器内部 userchinese, passwordchinese123, databasechinese_db ) # ✅ 正确做法读取环境变量或配置文件 config { host: os.getenv(DB_HOST, 127.0.0.1), # 默认本地可覆盖 port: int(os.getenv(DB_PORT, 3306)), user: os.getenv(DB_USER, chinese), password: os.getenv(DB_PASSWORD, chinese123), database: os.getenv(DB_NAME, chinese_db) } conn pymysql.connect(**config)解决方案在项目根目录新建.env文件DB_HOST127.0.0.1 DB_PORT3306 DB_USERchinese DB_PASSWORDchinese123 DB_NAMEchinese_db然后pip install python-dotenvserver.py开头加上from dotenv import load_dotenv load_dotenv()5.2 “成语消消看点不动”——字体渲染引发的灾难某次在老年大学部署几位老师反映“成语游戏点不了字”。排查发现是Windows系统字体设置问题他们把系统字体缩放调到175%导致PyQt5的QLabel实际点击区域与视觉区域偏移。idiom_game.py里修复方案def mousePressEvent(self, event): # 将鼠标坐标转换为label内部坐标修正缩放偏移 pos self.mapFromGlobal(QCursor.pos()) # 而不是直接用event.pos() for i, char in enumerate(self.chars): if self.char_rects[i].contains(pos): self.handle_char_click(i) break更彻底的方案是在Main.py启动时强制设置if hasattr(Qt, AA_EnableHighDpiScaling): QApplication.setAttribute(Qt.AA_EnableHighDpiScaling, True) if hasattr(Qt, AA_UseHighDpiPixmaps): QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps, True)5.3 “诗词问答答对没加分”——PyQt5信号槽的隐式陷阱这个Bug极其隐蔽学生答对后积分显示不变但数据库里score_log表确实多了记录。根源在poem_game.py的信号连接# ❌ 错误用lambda创建闭包导致self引用丢失 self.ui.submit_btn.clicked.connect(lambda: self.submit_answer()) # ✅ 正确用partial或直接传方法名 from functools import partial self.ui.submit_btn.clicked.connect(partial(self.submit_answer)) # 或更简洁 self.ui.submit_btn.clicked.connect(self.submit_answer)Lambda方式在PyQt5中会创建新的作用域self可能被垃圾回收。用partial或直接传方法名确保信号触发时self始终有效。5.4 数据安全加固为什么密码不能明文存MySQLchinese.sql里users表的password字段类型是VARCHAR(128)但register_window.py注册时不是直接存明文# 使用bcrypt哈希比MD5/SHA256更安全 import bcrypt hashed bcrypt.hashpw(password.encode(utf-8), bcrypt.gensalt()) cursor.execute(INSERT INTO users (username, password) VALUES (%s, %s), (username, hashed))登录验证时cursor.execute(SELECT password FROM users WHERE username%s, (username,)) stored_hash cursor.fetchone()[0] if bcrypt.checkpw(password.encode(utf-8), stored_hash.encode(utf-8)): # 登录成功注意bcrypt需要pip install bcrypt且Windows下需先安装Microsoft C Build Tools否则编译失败。这是新手安装时第二大报错源第一是PyQt5版本不匹配。6. 可扩展性设计与教学价值延伸让这个项目真正“活”起来6.1 教研组最需要的三个扩展方向这个项目留了三个清晰的扩展接口专为一线教师设计题库管理后台轻量级Web版server.py已预留/admin路由只需添加基于Flask-Admin的简易后台让老师上传CSV格式的诗词题列诗句、上句、下句、作者、出处、难度点击“导入”即可同步到MySQL。deal_poem.py的import_from_csv()方法已写好就差一个HTML模板。错题本功能score_log表里有is_correct字段per_info.py里可新增get_wrong_answers(user_id)方法按成语/诗词分类统计错误率。比如发现某班学生“刻舟求剑”的“刻”字错误率高达65%系统自动推送“刻”字专项练习——这正是poem_game.py里hint_system的升级版。多终端适配当前PyQt5界面是为1366×768屏幕优化。ui/目录下已预留mobile/子目录存放针对手机端的QSS样式表和布局文件。只需在Main.py里加设备检测python if QDesktopWidget().screenGeometry().width() 1024: # 加载mobile样式 with open(ui/mobile/style.qss, r) as f: app.setStyleSheet(f.read())6.2 为什么说这是“文化数字化”的正确打开方式最后分享一个真实案例去年我把这个项目部署到云南某彝族小学当地老师用deal_poem.py替换了全部唐诗换成彝族创世史诗《梅葛》的汉语译本诗句如“混沌初开时天神造万物”并新增彝语发音音效。孩子们第一次看到自己民族的史诗变成游戏围着电脑屏笑得前仰后合。那一刻我彻底明白技术框架可以复制但文化内核必须由使用者亲手注入。这个项目的价值不在于它用了多少高大上的技术而在于它提供了一个“可呼吸的容器”——你往里放《诗经》它就是古典文学启蒙你放方言童谣它就是非遗传承工具你放甲骨文字形演变它就是汉字起源课件。所以别把它当成一个“完成品”而是一个“半成品”——你的教案、你的学生、你的地域文化才是让它真正完整的关键拼图。现在打开Main.py敲下python Main.py让第一句“床前明月光”在屏幕上亮起来吧。后面的路我们一起走。本文还有配套的精品资源点击获取简介一套可直接运行的汉字文化主题双游戏程序支持用户注册、登录、个人资料查看与修改以及实时游戏积分排行榜。其中诗词问答模块从古诗库中随机出题覆盖猜上句、猜下句、猜作者、猜出处四种形式答对即时加分成语消消看模块将7个四字成语拆成28个单字打乱排列玩家需按原顺序点击四个字完成消除全部清除即通关。前端用PyQt5开发包含登录页、主菜单、游戏窗口、规则说明页、排行榜页和个人中心页后端基于Flask提供API接口处理用户认证、分数提交、数据查询等请求所有数据存入MySQL附带建库脚本chinese.sql及数据预处理工具get_poem.py爬取诗词、deal_poem.py清洗诗句、deal_idiom.py整理成语。代码结构清晰ui/存放界面资源window/存放各窗口逻辑poem_game.py和idiom_game.py分别封装两个游戏核心规则mysql_op.py统一管理数据库操作server.py为服务端入口send_data.py负责客户端网络通信。包内含15张实际运行截图和详细README说明文档。本文还有配套的精品资源点击获取