简介万维题库管理系统单机版是一款面向教育机构、教师及个人自测用户的本地化题库管理工具无需联网即可独立运行适合网络环境不稳定或对数据隐私有较高要求的场景。软件支持题目的创建、编辑、分类存储与检索并提供试题导入导出、随机组卷、答案解析、难度设置等功能可服务于日常教学、考试准备与自我测试。资源包共11个文件约14.21MB以exe安装程序为主辅以dll、lib、ini、ins等安装配置组件以及htm格式的说明文档整体构成一套完整的单机安装包。目前已有2256人学习下载说明该工具在题库管理需求中具有一定参考价值。通过安装部署读者可获得一套可离线使用的题库管理环境并借助说明文档了解分类管理、试题格式导入导出与组卷规则等操作要点从而提升题目组织与复用效率同时需注意定期手动备份本地数据并关注后续更新以获取功能与安全补丁。1. 单机题库管理系统的真实使用场景带过培训班或者做过内部技术考核的开发者大概都遇到过这种需求需要一套能离线运行的题库系统不依赖外网、不依赖云服务装在一台普通办公电脑上就能完成题目录入、组卷、导出和成绩记录。万维题库管理系统单机版就是冲着这个场景来的。它把数据库、服务端和前端打包成一个本地可执行环境双击启动后浏览器访问本机端口即可使用断网也能跑。适合谁一是需要给学员做日常刷题练习的培训场景二是企业内部技术认证的题库维护人员三是想拿一套完整 CRUD 项目练手或做二次开发的开发者。整个项目结构清晰没有过度设计拿来改比从零搭要省事得多。2. 技术选型与目录结构先搞清楚这套单机系统怎么搭起来的2.1 为什么单机版反而更考验架构取舍单机版听起来简单实际上比联网版更考验架构决策。联网版可以把数据库、缓存、文件存储都丢到远端单机版必须把所有东西塞进一个进程或者一组本地进程里。常见的做法是后端用轻量级框架内嵌数据库前端用静态资源打包后由后端直接托管避免额外起 Nginx。万维题库管理系统单机版走的就是这条路后端负责 API 和静态文件服务数据库文件放在项目目录下的 data 文件夹里启动脚本负责初始化环境。这样部署时只需要拷贝整个目录到目标机器改一下端口配置就能跑。这种架构的好处是迁移成本极低坏处是并发能力有限。如果只是几十个人同时在线刷题完全够用如果要支撑几百人并发就得考虑把数据库换成独立服务。我一般会在项目初期就确认清楚使用规模避免后期翻车。2.2 目录结构逐层拆解拿到源码后先别急着跑花五分钟把目录结构看一遍后面改代码会顺很多。典型的单机题库项目目录大致长这样wanwei-question-bank/ ├── server/ # 后端服务 │ ├── app.py # 入口文件注册路由和中间件 │ ├── models/ # 数据模型定义 │ │ ├── question.py # 题目模型 │ │ ├── paper.py # 试卷模型 │ │ └── record.py # 答题记录模型 │ ├── routes/ # API 路由 │ │ ├── question_api.py │ │ ├── paper_api.py │ │ └── auth_api.py │ ├── services/ # 业务逻辑层 │ │ ├── question_service.py │ │ └── paper_service.py │ └── utils/ # 工具函数 │ ├── db.py # 数据库连接管理 │ └── export.py # 导出 Word/PDF 逻辑 ├── web/ # 前端静态资源 │ ├── index.html │ ├── js/ │ └── css/ ├── data/ # 数据库文件和上传资源 │ └── question_bank.db ├── config.yaml # 端口、数据库路径等配置 ├── requirements.txt # Python 依赖 └── start.sh # 启动脚本这个结构里最值得关注的是services层。很多小项目会把业务逻辑直接写在路由函数里后期改起来很痛苦。万维题库管理系统单机版把组卷算法、题目去重、导出格式化这些逻辑抽到了 service 层路由只负责参数校验和响应组装。二次开发时如果要改组卷策略直接动paper_service.py就行不用在一堆路由里翻找。2.3 数据模型设计的关键字段题库系统的核心是题目模型和试卷模型。题目模型通常包含题干、选项、答案、解析、难度、知识点标签、题型这几个字段。其中题型和难度是组卷时的筛选条件知识点标签决定了能不能按章节抽题。试卷模型则记录试卷名称、总分、题目列表、生成时间。答题记录模型关联用户和试卷存得分和每道题的对错情况。常见做法是把题目选项存成 JSON 字符串而不是单独建选项表。单机版数据量不大这样查起来更快改起来也直观。但要注意 JSON 字段的序列化和反序列化要统一否则前端拿到的选项格式可能对不上。3. 本地跑起来从零到浏览器访问的完整步骤3.1 环境准备与依赖安装先确认本机 Python 版本。这类项目一般要求 Python 3.8 以上我习惯用 3.10 或 3.11兼容性好且性能稳定。数据库方面单机版通常用 SQLite不需要额外安装数据库服务省事。# 进入项目根目录 cd wanwei-question-bank # 创建虚拟环境避免污染全局包 python -m venv venv # 激活虚拟环境 # Linux / macOS source venv/bin/activate # Windows venv\Scripts\activate # 安装依赖 pip install -r requirements.txtrequirements.txt里一般会包含 Flask 或 FastAPI、SQLAlchemy、openpyxl用于 Excel 导入导出、python-docx用于 Word 导出这几个核心包。如果安装过程中某个包编译失败大概率是缺少系统级依赖比如 python-docx 需要 lxml而 lxml 在 Windows 上可能需要预编译轮子。遇到这种情况直接装lxml的 wheel 包即可。3.2 配置文件修改与数据库初始化装完依赖后别急着启动先看config.yaml。这个文件决定了服务监听端口、数据库文件路径、上传文件大小限制等关键参数。# config.yaml 典型配置 server: host: 0.0.0.0 # 监听地址本机访问用 127.0.0.1 更安全 port: 8080 # 服务端口被占用时改成 8081 等 database: path: ./data/question_bank.db # SQLite 文件路径 echo: false # 是否打印 SQL 日志调试时改 true upload: max_size_mb: 20 # 单文件上传大小限制 allowed_ext: [xlsx, xls, docx, pdf]端口如果和本机其他服务冲突启动时会报Address already in use改个端口就行。数据库路径建议保持默认除非你想把数据文件放到其他盘符。首次启动时后端会自动检测数据库文件是否存在不存在则根据模型定义建表。有些项目会额外提供一个init_db.py脚本手动执行一次即可完成初始化。# 如果项目提供了初始化脚本 python init_db.py # 或者直接启动让应用自动建表 python server/app.py启动成功后终端会打印监听地址比如Running on http://127.0.0.1:8080。打开浏览器访问这个地址应该能看到登录页或者题目列表页。如果页面空白按 F12 看控制台报错常见原因是前端静态资源路径配置不对检查web目录是否被正确托管。3.3 首次登录与基础功能验证默认管理员账号一般在文档或初始化脚本里写死常见的是admin / admin123。登录后先做三件事验证系统是否正常第一手动新增一道单选题看能否保存成功第二用 Excel 批量导入十道题看导入日志有没有报错第三随机抽五道题生成一份试卷导出 Word 看格式是否完整。这三步走完基本能确认核心链路是通的。如果导入 Excel 时报字段映射错误检查模板文件的表头是否和代码里定义的列名一致。很多项目会要求表头必须是「题干、选项A、选项B、选项C、选项D、答案、解析」这种固定格式多一个空格都会导致解析失败。4. 核心模块拆解组卷算法与导入导出怎么实现的4.1 组卷服务的随机抽题与去重逻辑组卷是题库系统里最核心也最容易出问题的模块。简单随机抽题谁都会写但要保证同一份试卷里不出现重复题目、难度分布合理、知识点覆盖均衡就需要一些策略。万维题库管理系统单机版的组卷逻辑放在paper_service.py里核心思路是先按条件筛选候选题目池再按难度比例分层抽取。# paper_service.py 组卷核心逻辑简化版 import random from collections import defaultdict def generate_paper(db, subject, difficulty_ratio, question_count): 按难度比例生成试卷 :param subject: 知识点/科目筛选条件 :param difficulty_ratio: 难度比例如 {easy: 0.3, medium: 0.5, hard: 0.2} :param question_count: 总题数 :return: 题目列表 # 1. 按条件拉取候选题目 candidates db.query_questions(subjectsubject) if len(candidates) question_count: raise ValueError(题库中符合条件的题目不足) # 2. 按难度分组 grouped defaultdict(list) for q in candidates: grouped[q.difficulty].append(q) # 3. 按比例计算每层需要抽多少题 selected [] for level, ratio in difficulty_ratio.items(): need int(question_count * ratio) pool grouped.get(level, []) if len(pool) need: # 某一层不够时从其他层补足 need len(pool) selected.extend(random.sample(pool, need)) # 4. 如果总数不够从剩余题目中随机补 if len(selected) question_count: selected_ids {q.id for q in selected} remaining [q for q in candidates if q.id not in selected_ids] extra random.sample(remaining, question_count - len(selected)) selected.extend(extra) # 5. 打乱顺序避免难度分层导致题目扎堆 random.shuffle(selected) return selected这段代码的关键点有三个。第一difficulty_ratio是外部传入的意味着可以在前端让用户自己调难度比例后端不用改。第二某一层题目不够时做了降级处理从其他层补避免直接报错。第三最后一步random.shuffle很重要否则试卷会按难度从易到难排列失去随机性。我见过有人忘了打乱结果每次生成的试卷都是前易后难学员做几次就摸到规律了。参数方面subject可以是单个知识点也可以是多个知识点的列表具体看db.query_questions的实现。如果要做更细的组卷策略比如按题型比例抽题可以在分组维度上再加一层。4.2 Excel 批量导入的字段映射与校验批量导入是题库维护人员用得最多的功能。手动录一百道题能累死人有了 Excel 导入十分钟搞定。导入的核心是字段映射和校验代码一般在question_service.py里。# question_service.py Excel 导入逻辑简化版 import openpyxl # 定义 Excel 表头到模型字段的映射 COLUMN_MAP { 题干: content, 选项A: option_a, 选项B: option_b, 选项C: option_c, 选项D: option_d, 答案: answer, 解析: analysis, 难度: difficulty, 知识点: subject, } def import_from_excel(file_path): 从 Excel 文件批量导入题目 wb openpyxl.load_workbook(file_path) ws wb.active headers [cell.value for cell in ws[1]] # 校验表头是否完整 missing [h for h in COLUMN_MAP if h not in headers] if missing: raise ValueError(f缺少必要列: {missing}) questions [] errors [] for row_idx, row in enumerate(ws.iter_rows(min_row2, values_onlyTrue), start2): data dict(zip(headers, row)) # 必填字段校验 if not data.get(题干) or not data.get(答案): errors.append(f第 {row_idx} 行题干或答案为空) continue # 构建题目对象 q {field: data.get(col) for col, field in COLUMN_MAP.items()} questions.append(q) if errors: # 有错误时返回错误列表不写入数据库 return {success: False, errors: errors} # 批量写入 save_questions(questions) return {success: True, count: len(questions)}这段代码有几个设计取舍值得说。第一表头校验放在最前面避免读到一半才发现列不对。第二逐行校验必填字段把错误行号记下来返回给前端方便用户定位修改。第三有错误时整体不写入保证数据一致性。如果改成边校验边写入中途出错会留下脏数据清理起来很麻烦。实际使用中还有一个坑Excel 里的数字会被 openpyxl 读成 float 类型比如答案填1可能变成1.0。解决办法是在读取后做类型转换或者要求用户把答案列格式设成文本。我一般会在代码里加一层str(int(value)) if isinstance(value, float) else str(value)的处理。4.3 导出 Word 试卷的格式化处理导出功能看起来简单实际上格式调整很费时间。用 python-docx 生成试卷时需要控制标题样式、题目间距、选项对齐、答案页分隔等细节。# export.py 导出 Word 试卷简化版 from docx import Document from docx.shared import Pt from docx.enum.text import WD_ALIGN_PARAGRAPH def export_paper_to_word(paper, questions, include_answerFalse): 将试卷导出为 Word 文档 doc Document() # 设置默认字体 style doc.styles[Normal] style.font.name 宋体 style.font.size Pt(12) # 试卷标题 title doc.add_heading(paper.name, level1) title.alignment WD_ALIGN_PARAGRAPH.CENTER # 逐题写入 for idx, q in enumerate(questions, start1): # 题干 doc.add_paragraph(f{idx}. {q.content}) # 选项 for label in [A, B, C, D]: option_text getattr(q, foption_{label.lower()}) if option_text: doc.add_paragraph(f{label}. {option_text}) # 题目间空一行 doc.add_paragraph() # 如果需要附带答案页 if include_answer: doc.add_page_break() doc.add_heading(参考答案, level2) for idx, q in enumerate(questions, start1): doc.add_paragraph(f{idx}. {q.answer}) output_path f./data/export/{paper.name}.docx doc.save(output_path) return output_path导出模块最容易翻车的地方是字体和段落间距。python-docx 默认字体是 Calibri中文显示会很难看必须手动设置成宋体或微软雅黑。另外选项的缩进和对齐如果不在代码里控制导出来的 Word 会参差不齐。我一般会在选项段落上设置左缩进Pt(21)让选项和题干有明显层次。5. 避坑与常见问题排查5.1 启动报端口占用现象执行启动命令后终端报OSError: [Errno 98] Address already in use。 原因配置的端口被其他程序占用了常见的是 8080 被 Tomcat 或另一个 Web 服务占用。 解决改config.yaml里的server.port为 8081 或其他空闲端口重启即可。用lsof -i:8080可以查是哪个进程占用的。5.2 Excel 导入后题目乱码现象导入成功但题目内容显示为乱码或问号。 原因Excel 文件保存时编码不是 UTF-8或者 openpyxl 读取时未正确处理中文。 解决确保 Excel 另存为.xlsx格式而非.xls并且不要用 CSV 中转。如果必须用 CSV导入时指定encodingutf-8-sig。5.3 组卷时提示题目不足现象生成试卷时弹窗提示「题库中符合条件的题目不足」。 原因筛选条件太窄比如同时限定了知识点、难度和题型导致候选题目数量少于试卷题数。 解决放宽筛选条件或者在前端增加提示告诉用户当前条件下有多少道可用题目。代码层面可以在generate_paper里返回候选数量让前端提前判断。5.4 导出 Word 后公式或特殊符号丢失现象题目里包含数学公式或特殊符号导出后变成空白或乱码。 原因python-docx 对 OMML 公式支持有限特殊符号依赖字体。 解决如果题目里有大量公式建议导出 PDF 而不是 Word或者在前端用 MathJax 渲染后再截图嵌入。单机版场景下公式题不多的话手动处理也能接受。5.5 数据库文件越来越大现象使用一段时间后question_bank.db文件膨胀到几百 MB。 原因答题记录表只增不删或者导入导出产生了临时数据未清理。 解决定期归档旧的答题记录或者在配置里加一个自动清理策略比如只保留最近三个月的记录。SQLite 可以用VACUUM命令回收空间。6. 二次开发改造从单机到小团队协作的扩展思路单机版跑通之后很多人会想把它改成支持多人同时使用的版本。最直接的改造点是把 SQLite 换成 MySQL 或 PostgreSQL然后把后端服务部署到一台内网服务器上。这个改造涉及三个地方数据库连接配置、SQL 方言兼容、并发写入处理。数据库连接层一般封装在utils/db.py里改起来不难。但要注意 SQLite 和 MySQL 在字段类型上的差异比如 SQLite 的TEXT在 MySQL 里对应LONGTEXT自增主键的写法也不同。如果项目用了 ORM比如 SQLAlchemy大部分差异会被屏蔽只需要改连接字符串和驱动。并发写入是另一个要处理的问题。单机版没有锁竞争改成多人使用后两个人同时导入题目可能会冲突。常见做法是在 service 层加事务控制或者用数据库的行锁。如果不想动太多代码可以在导入接口上加一个简单的文件锁同一时间只允许一个导入任务执行。还有一个实用的改造方向是加一个简单的用户体系。单机版通常只有一个管理员账号改成多人后需要区分出题人、审题人和普通学员。可以在现有用户表上加一个role字段然后在路由层加权限装饰器。改造时建议先加角色字段和权限判断再逐步迁移功能不要一次性全改完否则出问题很难定位。验证改造是否成功我一般会走一遍完整流程用两个不同角色的账号登录一个导入题目一个生成试卷同时操作看会不会互相影响。如果数据库连接池配置太小并发时会出现连接超时这时候把池大小调到 10 以上通常能解决。从那以后我每次改数据库相关代码都会先在本地用两个终端同时跑一遍导入和查询确认没有锁冲突再提交。希望帮到你。本文还有配套的精品资源点击获取
简介万维题库管理系统单机版是一款面向教育机构、教师及个人自测用户的本地化题库管理工具无需联网即可独立运行适合网络环境不稳定或对数据隐私有较高要求的场景。软件支持题目的创建、编辑、分类存储与检索并提供试题导入导出、随机组卷、答案解析、难度设置等功能可服务于日常教学、考试准备与自我测试。资源包共11个文件约14.21MB以exe安装程序为主辅以dll、lib、ini、ins等安装配置组件以及htm格式的说明文档整体构成一套完整的单机安装包。目前已有2256人学习下载说明该工具在题库管理需求中具有一定参考价值。通过安装部署读者可获得一套可离线使用的题库管理环境并借助说明文档了解分类管理、试题格式导入导出与组卷规则等操作要点从而提升题目组织与复用效率同时需注意定期手动备份本地数据并关注后续更新以获取功能与安全补丁。1. 单机题库管理系统的真实使用场景带过培训班或者做过内部技术考核的开发者大概都遇到过这种需求需要一套能离线运行的题库系统不依赖外网、不依赖云服务装在一台普通办公电脑上就能完成题目录入、组卷、导出和成绩记录。万维题库管理系统单机版就是冲着这个场景来的。它把数据库、服务端和前端打包成一个本地可执行环境双击启动后浏览器访问本机端口即可使用断网也能跑。适合谁一是需要给学员做日常刷题练习的培训场景二是企业内部技术认证的题库维护人员三是想拿一套完整 CRUD 项目练手或做二次开发的开发者。整个项目结构清晰没有过度设计拿来改比从零搭要省事得多。2. 技术选型与目录结构先搞清楚这套单机系统怎么搭起来的2.1 为什么单机版反而更考验架构取舍单机版听起来简单实际上比联网版更考验架构决策。联网版可以把数据库、缓存、文件存储都丢到远端单机版必须把所有东西塞进一个进程或者一组本地进程里。常见的做法是后端用轻量级框架内嵌数据库前端用静态资源打包后由后端直接托管避免额外起 Nginx。万维题库管理系统单机版走的就是这条路后端负责 API 和静态文件服务数据库文件放在项目目录下的 data 文件夹里启动脚本负责初始化环境。这样部署时只需要拷贝整个目录到目标机器改一下端口配置就能跑。这种架构的好处是迁移成本极低坏处是并发能力有限。如果只是几十个人同时在线刷题完全够用如果要支撑几百人并发就得考虑把数据库换成独立服务。我一般会在项目初期就确认清楚使用规模避免后期翻车。2.2 目录结构逐层拆解拿到源码后先别急着跑花五分钟把目录结构看一遍后面改代码会顺很多。典型的单机题库项目目录大致长这样wanwei-question-bank/ ├── server/ # 后端服务 │ ├── app.py # 入口文件注册路由和中间件 │ ├── models/ # 数据模型定义 │ │ ├── question.py # 题目模型 │ │ ├── paper.py # 试卷模型 │ │ └── record.py # 答题记录模型 │ ├── routes/ # API 路由 │ │ ├── question_api.py │ │ ├── paper_api.py │ │ └── auth_api.py │ ├── services/ # 业务逻辑层 │ │ ├── question_service.py │ │ └── paper_service.py │ └── utils/ # 工具函数 │ ├── db.py # 数据库连接管理 │ └── export.py # 导出 Word/PDF 逻辑 ├── web/ # 前端静态资源 │ ├── index.html │ ├── js/ │ └── css/ ├── data/ # 数据库文件和上传资源 │ └── question_bank.db ├── config.yaml # 端口、数据库路径等配置 ├── requirements.txt # Python 依赖 └── start.sh # 启动脚本这个结构里最值得关注的是services层。很多小项目会把业务逻辑直接写在路由函数里后期改起来很痛苦。万维题库管理系统单机版把组卷算法、题目去重、导出格式化这些逻辑抽到了 service 层路由只负责参数校验和响应组装。二次开发时如果要改组卷策略直接动paper_service.py就行不用在一堆路由里翻找。2.3 数据模型设计的关键字段题库系统的核心是题目模型和试卷模型。题目模型通常包含题干、选项、答案、解析、难度、知识点标签、题型这几个字段。其中题型和难度是组卷时的筛选条件知识点标签决定了能不能按章节抽题。试卷模型则记录试卷名称、总分、题目列表、生成时间。答题记录模型关联用户和试卷存得分和每道题的对错情况。常见做法是把题目选项存成 JSON 字符串而不是单独建选项表。单机版数据量不大这样查起来更快改起来也直观。但要注意 JSON 字段的序列化和反序列化要统一否则前端拿到的选项格式可能对不上。3. 本地跑起来从零到浏览器访问的完整步骤3.1 环境准备与依赖安装先确认本机 Python 版本。这类项目一般要求 Python 3.8 以上我习惯用 3.10 或 3.11兼容性好且性能稳定。数据库方面单机版通常用 SQLite不需要额外安装数据库服务省事。# 进入项目根目录 cd wanwei-question-bank # 创建虚拟环境避免污染全局包 python -m venv venv # 激活虚拟环境 # Linux / macOS source venv/bin/activate # Windows venv\Scripts\activate # 安装依赖 pip install -r requirements.txtrequirements.txt里一般会包含 Flask 或 FastAPI、SQLAlchemy、openpyxl用于 Excel 导入导出、python-docx用于 Word 导出这几个核心包。如果安装过程中某个包编译失败大概率是缺少系统级依赖比如 python-docx 需要 lxml而 lxml 在 Windows 上可能需要预编译轮子。遇到这种情况直接装lxml的 wheel 包即可。3.2 配置文件修改与数据库初始化装完依赖后别急着启动先看config.yaml。这个文件决定了服务监听端口、数据库文件路径、上传文件大小限制等关键参数。# config.yaml 典型配置 server: host: 0.0.0.0 # 监听地址本机访问用 127.0.0.1 更安全 port: 8080 # 服务端口被占用时改成 8081 等 database: path: ./data/question_bank.db # SQLite 文件路径 echo: false # 是否打印 SQL 日志调试时改 true upload: max_size_mb: 20 # 单文件上传大小限制 allowed_ext: [xlsx, xls, docx, pdf]端口如果和本机其他服务冲突启动时会报Address already in use改个端口就行。数据库路径建议保持默认除非你想把数据文件放到其他盘符。首次启动时后端会自动检测数据库文件是否存在不存在则根据模型定义建表。有些项目会额外提供一个init_db.py脚本手动执行一次即可完成初始化。# 如果项目提供了初始化脚本 python init_db.py # 或者直接启动让应用自动建表 python server/app.py启动成功后终端会打印监听地址比如Running on http://127.0.0.1:8080。打开浏览器访问这个地址应该能看到登录页或者题目列表页。如果页面空白按 F12 看控制台报错常见原因是前端静态资源路径配置不对检查web目录是否被正确托管。3.3 首次登录与基础功能验证默认管理员账号一般在文档或初始化脚本里写死常见的是admin / admin123。登录后先做三件事验证系统是否正常第一手动新增一道单选题看能否保存成功第二用 Excel 批量导入十道题看导入日志有没有报错第三随机抽五道题生成一份试卷导出 Word 看格式是否完整。这三步走完基本能确认核心链路是通的。如果导入 Excel 时报字段映射错误检查模板文件的表头是否和代码里定义的列名一致。很多项目会要求表头必须是「题干、选项A、选项B、选项C、选项D、答案、解析」这种固定格式多一个空格都会导致解析失败。4. 核心模块拆解组卷算法与导入导出怎么实现的4.1 组卷服务的随机抽题与去重逻辑组卷是题库系统里最核心也最容易出问题的模块。简单随机抽题谁都会写但要保证同一份试卷里不出现重复题目、难度分布合理、知识点覆盖均衡就需要一些策略。万维题库管理系统单机版的组卷逻辑放在paper_service.py里核心思路是先按条件筛选候选题目池再按难度比例分层抽取。# paper_service.py 组卷核心逻辑简化版 import random from collections import defaultdict def generate_paper(db, subject, difficulty_ratio, question_count): 按难度比例生成试卷 :param subject: 知识点/科目筛选条件 :param difficulty_ratio: 难度比例如 {easy: 0.3, medium: 0.5, hard: 0.2} :param question_count: 总题数 :return: 题目列表 # 1. 按条件拉取候选题目 candidates db.query_questions(subjectsubject) if len(candidates) question_count: raise ValueError(题库中符合条件的题目不足) # 2. 按难度分组 grouped defaultdict(list) for q in candidates: grouped[q.difficulty].append(q) # 3. 按比例计算每层需要抽多少题 selected [] for level, ratio in difficulty_ratio.items(): need int(question_count * ratio) pool grouped.get(level, []) if len(pool) need: # 某一层不够时从其他层补足 need len(pool) selected.extend(random.sample(pool, need)) # 4. 如果总数不够从剩余题目中随机补 if len(selected) question_count: selected_ids {q.id for q in selected} remaining [q for q in candidates if q.id not in selected_ids] extra random.sample(remaining, question_count - len(selected)) selected.extend(extra) # 5. 打乱顺序避免难度分层导致题目扎堆 random.shuffle(selected) return selected这段代码的关键点有三个。第一difficulty_ratio是外部传入的意味着可以在前端让用户自己调难度比例后端不用改。第二某一层题目不够时做了降级处理从其他层补避免直接报错。第三最后一步random.shuffle很重要否则试卷会按难度从易到难排列失去随机性。我见过有人忘了打乱结果每次生成的试卷都是前易后难学员做几次就摸到规律了。参数方面subject可以是单个知识点也可以是多个知识点的列表具体看db.query_questions的实现。如果要做更细的组卷策略比如按题型比例抽题可以在分组维度上再加一层。4.2 Excel 批量导入的字段映射与校验批量导入是题库维护人员用得最多的功能。手动录一百道题能累死人有了 Excel 导入十分钟搞定。导入的核心是字段映射和校验代码一般在question_service.py里。# question_service.py Excel 导入逻辑简化版 import openpyxl # 定义 Excel 表头到模型字段的映射 COLUMN_MAP { 题干: content, 选项A: option_a, 选项B: option_b, 选项C: option_c, 选项D: option_d, 答案: answer, 解析: analysis, 难度: difficulty, 知识点: subject, } def import_from_excel(file_path): 从 Excel 文件批量导入题目 wb openpyxl.load_workbook(file_path) ws wb.active headers [cell.value for cell in ws[1]] # 校验表头是否完整 missing [h for h in COLUMN_MAP if h not in headers] if missing: raise ValueError(f缺少必要列: {missing}) questions [] errors [] for row_idx, row in enumerate(ws.iter_rows(min_row2, values_onlyTrue), start2): data dict(zip(headers, row)) # 必填字段校验 if not data.get(题干) or not data.get(答案): errors.append(f第 {row_idx} 行题干或答案为空) continue # 构建题目对象 q {field: data.get(col) for col, field in COLUMN_MAP.items()} questions.append(q) if errors: # 有错误时返回错误列表不写入数据库 return {success: False, errors: errors} # 批量写入 save_questions(questions) return {success: True, count: len(questions)}这段代码有几个设计取舍值得说。第一表头校验放在最前面避免读到一半才发现列不对。第二逐行校验必填字段把错误行号记下来返回给前端方便用户定位修改。第三有错误时整体不写入保证数据一致性。如果改成边校验边写入中途出错会留下脏数据清理起来很麻烦。实际使用中还有一个坑Excel 里的数字会被 openpyxl 读成 float 类型比如答案填1可能变成1.0。解决办法是在读取后做类型转换或者要求用户把答案列格式设成文本。我一般会在代码里加一层str(int(value)) if isinstance(value, float) else str(value)的处理。4.3 导出 Word 试卷的格式化处理导出功能看起来简单实际上格式调整很费时间。用 python-docx 生成试卷时需要控制标题样式、题目间距、选项对齐、答案页分隔等细节。# export.py 导出 Word 试卷简化版 from docx import Document from docx.shared import Pt from docx.enum.text import WD_ALIGN_PARAGRAPH def export_paper_to_word(paper, questions, include_answerFalse): 将试卷导出为 Word 文档 doc Document() # 设置默认字体 style doc.styles[Normal] style.font.name 宋体 style.font.size Pt(12) # 试卷标题 title doc.add_heading(paper.name, level1) title.alignment WD_ALIGN_PARAGRAPH.CENTER # 逐题写入 for idx, q in enumerate(questions, start1): # 题干 doc.add_paragraph(f{idx}. {q.content}) # 选项 for label in [A, B, C, D]: option_text getattr(q, foption_{label.lower()}) if option_text: doc.add_paragraph(f{label}. {option_text}) # 题目间空一行 doc.add_paragraph() # 如果需要附带答案页 if include_answer: doc.add_page_break() doc.add_heading(参考答案, level2) for idx, q in enumerate(questions, start1): doc.add_paragraph(f{idx}. {q.answer}) output_path f./data/export/{paper.name}.docx doc.save(output_path) return output_path导出模块最容易翻车的地方是字体和段落间距。python-docx 默认字体是 Calibri中文显示会很难看必须手动设置成宋体或微软雅黑。另外选项的缩进和对齐如果不在代码里控制导出来的 Word 会参差不齐。我一般会在选项段落上设置左缩进Pt(21)让选项和题干有明显层次。5. 避坑与常见问题排查5.1 启动报端口占用现象执行启动命令后终端报OSError: [Errno 98] Address already in use。 原因配置的端口被其他程序占用了常见的是 8080 被 Tomcat 或另一个 Web 服务占用。 解决改config.yaml里的server.port为 8081 或其他空闲端口重启即可。用lsof -i:8080可以查是哪个进程占用的。5.2 Excel 导入后题目乱码现象导入成功但题目内容显示为乱码或问号。 原因Excel 文件保存时编码不是 UTF-8或者 openpyxl 读取时未正确处理中文。 解决确保 Excel 另存为.xlsx格式而非.xls并且不要用 CSV 中转。如果必须用 CSV导入时指定encodingutf-8-sig。5.3 组卷时提示题目不足现象生成试卷时弹窗提示「题库中符合条件的题目不足」。 原因筛选条件太窄比如同时限定了知识点、难度和题型导致候选题目数量少于试卷题数。 解决放宽筛选条件或者在前端增加提示告诉用户当前条件下有多少道可用题目。代码层面可以在generate_paper里返回候选数量让前端提前判断。5.4 导出 Word 后公式或特殊符号丢失现象题目里包含数学公式或特殊符号导出后变成空白或乱码。 原因python-docx 对 OMML 公式支持有限特殊符号依赖字体。 解决如果题目里有大量公式建议导出 PDF 而不是 Word或者在前端用 MathJax 渲染后再截图嵌入。单机版场景下公式题不多的话手动处理也能接受。5.5 数据库文件越来越大现象使用一段时间后question_bank.db文件膨胀到几百 MB。 原因答题记录表只增不删或者导入导出产生了临时数据未清理。 解决定期归档旧的答题记录或者在配置里加一个自动清理策略比如只保留最近三个月的记录。SQLite 可以用VACUUM命令回收空间。6. 二次开发改造从单机到小团队协作的扩展思路单机版跑通之后很多人会想把它改成支持多人同时使用的版本。最直接的改造点是把 SQLite 换成 MySQL 或 PostgreSQL然后把后端服务部署到一台内网服务器上。这个改造涉及三个地方数据库连接配置、SQL 方言兼容、并发写入处理。数据库连接层一般封装在utils/db.py里改起来不难。但要注意 SQLite 和 MySQL 在字段类型上的差异比如 SQLite 的TEXT在 MySQL 里对应LONGTEXT自增主键的写法也不同。如果项目用了 ORM比如 SQLAlchemy大部分差异会被屏蔽只需要改连接字符串和驱动。并发写入是另一个要处理的问题。单机版没有锁竞争改成多人使用后两个人同时导入题目可能会冲突。常见做法是在 service 层加事务控制或者用数据库的行锁。如果不想动太多代码可以在导入接口上加一个简单的文件锁同一时间只允许一个导入任务执行。还有一个实用的改造方向是加一个简单的用户体系。单机版通常只有一个管理员账号改成多人后需要区分出题人、审题人和普通学员。可以在现有用户表上加一个role字段然后在路由层加权限装饰器。改造时建议先加角色字段和权限判断再逐步迁移功能不要一次性全改完否则出问题很难定位。验证改造是否成功我一般会走一遍完整流程用两个不同角色的账号登录一个导入题目一个生成试卷同时操作看会不会互相影响。如果数据库连接池配置太小并发时会出现连接超时这时候把池大小调到 10 以上通常能解决。从那以后我每次改数据库相关代码都会先在本地用两个终端同时跑一遍导入和查询确认没有锁冲突再提交。希望帮到你。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
