简介万维题库管理系统单机版面向教育机构教务人员、教师及需要自测备考的个人用户主要用于解决大量试题分散存放、检索困难与组卷效率低的问题。它可以脱离网络独立运行适合机房、内网或对数据隐私有要求的场景。压缩包共11个文件约14.21MB以安装程序为主SETUP.EXE 与配套的 dll、lib、ins、ini 等文件负责安装与参数配置另有 Readme-说明.htm 提供使用说明与许可信息整体是典型的单机软件安装盘结构。目前已有2257人学习下载。安装后用户可围绕题目分类管理、试题导入导出、随机组卷、答案解析与难度标注等环节建立本地题库并形成可复用的组卷方案说明文档也能帮助读者快速了解功能边界与备份要求减少重复整理题目的时间成本。1. 单机版题库管理解决的是一线出卷人的痛苦我带过一个培训机构的教务小团队每到开课前一周最痛苦的不是讲课是出卷题目散在十几个 Excel 里改一道题要翻三四个文件出完还得手工排版、算分值、对答案错一个字母号就全卷重排。万维题库管理系统单机版瞄准的就是这个场景——它把题库管理从“文件夹 Excel”变成一个带界面的本地程序题目录入、分类检索、按规则组卷、导出成卷一条龙全程不需要连服务器装在本机、数据落在本地文件里关机就是备份。适合谁适合没有 IT 运维、只有一台办公电脑的教务老师也适合想拿它当骨架、改成自己机构专属题库的开发者。下面按我拆包的顺序讲先跑起来再看表结构最后落到组卷算法和二次改造。2. 跑起来单机版目录结构、运行环境和第一次初始化拿到包先别双击 exe先看目录。单机版这类工具的结构通常很朴素但恰恰是这种朴素暴露了它的设计边界数据全在一个本地文件里配置全在一个 app.config 里没有服务端、没有账号体系的后台。你把这几个文件认全了后面改代码就是按图索骥。2.1 目录结构三层是怎么分开的WanweiQuestionBank/ ├─ App.exe # 主程序入口WinForms 窗体的宿主 ├─ App.exe.config # 连接串、日志级别、导出模板路径 ├─ Lib/ # 第三方依赖Excel 读写、Word 导出、SQLite 驱动 ├─ Data/ │ ├─ qbank.db # 单机版的核心整个题库就是这一个文件 │ └─ backup/ # 每次启动自动留一份按日期命名的副本 ├─ Templates/ │ ├─ paper.docx # 试卷排版模板靠占位符替换 │ └─ paper_answer.docx # 答案卷模板 ├─ Logs/ # 按天切分的运行日志 └─ Resources/ # 图标、帮助文档、题型字典这个布局对应的是典型的三层切分App.exe是表现层所有窗体都挂在它下面Lib Data之间的调用是数据访问层封装 SQLite 的增删改查业务层夹在中间负责组卷规则、分值校验、导入解析这些“不碰界面也不碰 SQL”的逻辑。判断一个包是不是分层写好我一般看两点Data/qbank.db是不是唯一的数据来源以及Templates/里的模板是不是纯占位符、不含硬编码题号。两条都满足说明业务和排版是解耦的改起来省事。提示动手前先把整个目录复制一份到别的盘单机版很多是绿色包出问题直接换回旧目录就行别指望它有回滚机制。2.2 环境依赖不用装数据库但要装对运行时单机版最大的好处是没有外部依赖但“没有外部依赖”不等于“什么机器都能跑”。包里带的通常是 .NET Framework 4.x 的 WinForms 程序Windows 10/11 自带大部分版本Windows 7 可能得单独补。另外两类依赖容易漏一是 SQLite 的原生库Lib下的SQLite.Interop.dll之类32 位和 64 位是分开的硬混会直接抛Unable to load DLL二是导出 Word 用到的组件如果走的是 Office COM机器上就必须有 Office走 OpenXML 就不需要这一点在后面导出章节会具体说。!-- App.exe.config连接串和模板路径都在这里改路径比改代码快 -- configuration appSettings !-- 相对路径优先换机器不用改绝对路径只在数据挪到共享盘时用 -- add keyDbPath valueData\qbank.db / add keyTemplateDir valueTemplates / add keyAutoBackup valuetrue / !-- 备份保留天数超过的旧副本启动时清掉 -- add keyBackupKeepDays value15 / /appSettings /configuration这段配置的重点是DbPath用相对路径。很多人第一次迁移就把题库拷到 D 盘然后手改成绝对路径结果换台机器又崩。我的习惯是保持相对路径迁移时整个目录一起搬。AutoBackup建议别关单机版没有服务端事务日志一个误删就是真没了BackupKeepDays给 15 天足够覆盖一次排课周期。2.3 首次启动的完整链路从读配置到进主窗体很多人以为启动就是“打开窗体”实际上单机版启动阶段做的事情比想象中多读配置、验数据库、必要时建库、检查版本号做结构迁移、加载字典缓存最后才弹登录框。这条链路上任何一环失败表现出来都是“双击没反应”或者“一闪就退”所以日志的落点很关键。// Program.cs启动顺序不能乱数据库没准备好就不要往下走 static void Main() { var log Logger.Create(Logs); try { // 1. 配置读取缺 key 直接抛别用默认值兜底掩盖问题 var dbPath Config.Require(DbPath); var dbFull Path.Combine(AppDomain.CurrentDomain.BaseDirectory, dbPath); // 2. 数据库不存在就按内置脚本建库适合第一次分发 if (!File.Exists(dbFull)) { DbInitializer.Create(dbFull, Resources/schema.sql); log.Info($首次运行已创建数据库 {dbFull}); } // 3. 结构迁移靠一张 meta 表记版本升级包才敢直接覆盖 var version DbInitializer.GetSchemaVersion(dbFull); if (version DbInitializer.CurrentVersion) { DbInitializer.Migrate(dbFull, version, DbInitializer.CurrentVersion); log.Info($结构已从 v{version} 迁移到 v{DbInitializer.CurrentVersion}); } // 4. 启动前自动备份失败不阻断启动只记日志 if (Config.GetBool(AutoBackup)) BackupService.Snapshot(dbFull, log); Application.Run(new LoginForm(dbFull)); } catch (Exception ex) { log.Error(启动失败, ex); // 先落盘 MessageBox.Show(启动失败详情见 Logs 目录); // 再提示别让用户面对白屏 } }这段代码真正值钱的是第 3 步。单机版升级最怕的就是“新程序 旧数据”没有版本号就只能在代码里堆IF NOT EXISTS之类的判断越堆越乱。用一个meta表记 schema 版本升级包里带上迁移脚本覆盖安装就不会翻车。第 4 步的备份我建议一定要跑在登录之前因为登录后用户立刻可能开始批量导入那时候再备份就晚了。注意如果你的包启动后直接进了主窗体、没有登录框那多半是把“单机”理解成了“单用户免登录”。这种版本改多人共用会很难受后面二次开发章节会讲怎么补。3. 数据层拆解题目、选项、试卷三张核心表和一次完整写入判断一个题库系统好不好改不看界面漂不漂亮看表结构。表结构设计得糙你在界面上做十个功能也补不回来设计得对加题型、加检索维度都是加几行代码的事。单机版用 SQLite 是很自然的选择——零安装、单文件、支持事务缺点是并发写弱但单机场景本来也不缺这点。3.1 表结构为什么选项要单独一张表-- 题目主表所有题型共用靠 type 区分 CREATE TABLE question ( id INTEGER PRIMARY KEY AUTOINCREMENT, type INTEGER NOT NULL, -- 1单选 2多选 3判断 4填空 5简答 stem TEXT NOT NULL, -- 题干允许含换行 difficulty INTEGER NOT NULL DEFAULT 3, -- 1~5组卷时按档抽 knowledge TEXT, -- 知识点标签逗号分隔如 函数,极限 answer TEXT NOT NULL, -- 多选存 A|C填空存 北京|首都 analysis TEXT, -- 解析导出答案卷时用 default_score REAL NOT NULL DEFAULT 2, -- 建议分值出卷时可按题覆盖 created_at TEXT NOT NULL DEFAULT (datetime(now,localtime)) ); -- 选项表只有选择类题型才有数据其他题型这张表是空的 CREATE TABLE question_option ( id INTEGER PRIMARY KEY AUTOINCREMENT, question_id INTEGER NOT NULL, label TEXT NOT NULL, -- A/B/C/D不存序号便于打乱 content TEXT NOT NULL, FOREIGN KEY (question_id) REFERENCES question(id) ON DELETE CASCADE ); -- 试卷主表 试卷题目关联表关联表里存这一题在这份卷子里的分值 CREATE TABLE paper ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, created_at TEXT NOT NULL DEFAULT (datetime(now,localtime)), total_score REAL NOT NULL DEFAULT 0 ); CREATE TABLE paper_question ( paper_id INTEGER NOT NULL, question_id INTEGER NOT NULL, seq INTEGER NOT NULL, -- 卷面题号从 1 连续 score REAL NOT NULL, -- 覆盖 question.default_score PRIMARY KEY (paper_id, question_id) ); CREATE INDEX idx_question_type ON question(type, difficulty); CREATE INDEX idx_option_qid ON question_option(question_id);三个设计点值得说。第一选项单独成表而不是在question里塞option_a到option_f六个字段。塞字段看着省事但选项数一超、或者要加“选项解析”就没地方放了单独成表之后打乱选项顺序只需要重排label导出时再映射回 ABCD。第二分值存在关联表。同一道题在单元测里值 2 分、在期末卷里值 5 分如果分值写在题目表里就锁死了放在paper_question.score才对。第三answer用竖线分隔的多值字符串。严格说这不是第一范式但单机版题库量级通常在几千到几万题拆成question_answer表会让所有查询都多一次 join收益不划算属于可接受的妥协。提示knowledge用逗号分隔标签同样是不规范设计。如果后面要做知识点维度的统计报表建议加一张question_tag关系表别在 SQL 里写LIKE %,函数,%那个索引用不上。3.2 一次新增单选题的完整调用链界面点“保存”到数据落盘中间要过三层窗体收集控件值业务层做校验和归一化仓储层开事务写两张表。这段链路写清楚了加题型就只是在这条链上多一个分支。// QuestionRepository写题目必须在一个事务里主表和选项表不能半成功 public int Add(Question q) { using var conn new SQLiteConnection(_connStr); conn.Open(); using var tx conn.BeginTransaction(); // 显式事务别靠 autocommit try { // 1. 先写主表拿到自增 id var cmd conn.CreateCommand(); cmd.Transaction tx; cmd.CommandText INSERT INTO question(type, stem, difficulty, knowledge, answer, analysis, default_score) VALUES (type, stem, diff, know, ans, ana, score); SELECT last_insert_rowid();; cmd.Parameters.AddWithValue(type, (int)q.Type); cmd.Parameters.AddWithValue(stem, q.Stem.Trim()); cmd.Parameters.AddWithValue(diff, q.Difficulty); cmd.Parameters.AddWithValue(know, string.Join(,, q.Knowledge)); cmd.Parameters.AddWithValue(ans, string.Join(|, q.Answer)); cmd.Parameters.AddWithValue(ana, q.Analysis ?? ); cmd.Parameters.AddWithValue(score, q.DefaultScore); var newId Convert.ToInt32(cmd.ExecuteScalar()); // 2. 再批量写选项一条一条 Prepare 比拼 SQL 安全也更快 foreach (var opt in q.Options) { var oc conn.CreateCommand(); oc.Transaction tx; oc.CommandText INSERT INTO question_option(question_id,label,content) VALUES(qid,l,c); oc.Parameters.AddWithValue(qid, newId); oc.Parameters.AddWithValue(l, opt.Label); oc.Parameters.AddWithValue(c, opt.Content.Trim()); oc.ExecuteNonQuery(); } tx.Commit(); return newId; } catch { tx.Rollback(); // 回滚后把异常往上抛由界面层统一提示 throw; } }last_insert_rowid()是 SQLite 拿自增主键的标准写法注意它和插入必须在同一条命令里执行否则中间被别的连接插入就串了。参数化这里不只是防注入——题干里带单引号、带换行是常态拼字符串必翻车。事务边界划在“主表 全部选项”这一层是因为这两张表在业务上是一个整体只有题干没有选项的选择题进组卷池就是脏数据。3.3 单机版也躲不开的写入一致性单机不等于单线程。用户点“批量导入”的时候界面上那个进度条如果跑在后台线程同时用户又去改了另一道题两个连接同时写 SQLite 就会撞database is locked。默认的 rollback journal 模式下写锁是排他的读可以并发、写不行。我的做法是初始化时切 WAL// 打开连接后立刻执行的几条 PRAGMA作用比连接串参数更明确 using var cmd conn.CreateCommand(); cmd.CommandText PRAGMA journal_mode WAL; -- 读写不再互相阻塞单机多线程够用 PRAGMA synchronous NORMAL; -- 兼顾速度和安全配合每日备份足够 PRAGMA busy_timeout 5000; -- 抢不到锁等 5 秒再抛别立刻失败 PRAGMA foreign_keys ON; -- 删题时级联清选项必须显式开; cmd.ExecuteNonQuery();busy_timeout这条最容易被忽略。没有它后台导入和前台保存撞上就是直接弹异常有了它绝大多数冲突会在几毫秒内自愈用户根本感知不到。foreign_keys默认是关的不显式打开ON DELETE CASCADE就是一句装饰。文件里改了这几行之后删除题目才真的会把选项一起清掉不会在question_option里留一堆孤儿行拖慢查询。4. 组卷引擎从抽题配额到一份可打印试卷的生成链路题库管理的价值一半在录题一半在组卷。手工挑题的痛点是“抽了 20 道发现有三道重复考点”程序组卷要解决的正是这个按配额抽、按难度配比、保证不重题、抽不够时有降级策略。这段逻辑通常藏在一个PaperBuilder之类的类里是整个项目里最值得读透的一块。4.1 组卷参数四个维度定一份卷子参数含义常见取值改这里会怎样Type题型1单选 2多选 3判断 4填空 5简答加题型要同步改字典和导出模板Count该题型题数单选 20、判断 10超出题库量会触发降级Difficulty目标难度档1~5可给区间给区间时按“先高后低”补足Knowledge知识点过滤逗号分隔空表示不限过滤太细容易抽不满Score每题分值单选 2、简答 10写入paper_question.score一条配额对应一个题型。实际用的时候教务给的往往是“单选 20 题 2 分、多选 10 题 3 分、判断 10 题 1 分、简答 4 题 10 分”这种表单程序把它翻译成一串配额对象丢给组卷器。这里有个隐性约束配额加起来的总分要等于卷面分否则导出时必须重新分配分值。我一般让程序先算总分和卷头写死的分数对不上就拦住别等打印出来才发现。4.2 抽题算法分桶洗牌 去重 降级public ListQuestion Draw(PaperRule rule) { var result new ListQuestion(); var picked new HashSetint(); // 跨题型去重同一道题不许出现两次 var rnd new Random(rule.Seed); // 传种子就能复现同一份卷子 using var conn new SQLiteConnection(_connStr); conn.Open(); foreach (var quota in rule.Quotas) { // 1. 按条件把候选池捞出来只取需要的列别 SELECT * var pool QueryPool(conn, quota) .Where(q !picked.Contains(q.Id)) .ToList(); // 2. 按难度分桶每桶内部洗牌不打乱桶的顺序高难度优先出 var buckets pool.GroupBy(q q.Difficulty) .OrderByDescending(g g.Key) .Select(g Shuffle(g.ToList(), rnd)) .ToList(); var take new ListQuestion(); foreach (var bucket in buckets) { if (take.Count quota.Count) break; take.AddRange(bucket.Take(quota.Count - take.Count)); } // 3. 降级知识点过滤太严导致抽不满时放宽知识点但保留题型 if (take.Count quota.Count) { var extra QueryPool(conn, quota, ignoreKnowledge: true) .Where(q !picked.Contains(q.Id) take.All(t t.Id ! q.Id)) .OrderBy(_ rnd.Next()) .Take(quota.Count - take.Count); take.AddRange(extra); } // 4. 还不够就如实报错别静默少题 if (take.Count quota.Count) throw new PaperBuildException( $题型 {quota.TypeName} 需要 {quota.Count} 题题库仅能满足 {take.Count} 题); take.ForEach(q picked.Add(q.Id)); result.AddRange(take); } return result; }分桶洗牌这一步是整段的核心。为什么不直接ORDER BY random() LIMIT n因为那样抽出来的难度分布是不可控的题库里简单题多的时候整张卷子会偏简单。分桶之后“桶按难度降序、桶内随机”就同时满足了两个需求难度配比可控同难度内不重复。Seed这个参数看起来多余实际很有用——生成的卷子发给不同班级时要保持一致出问题也能复现属于后悔药级设计。降级逻辑要慎用放宽知识点可以放宽题型不行题型变了卷面结构就崩了。注意第 4 步抛异常而不是“有多少给多少”。我见过太多系统在这里静默返回结果卷子少了三道题老师打印前没数考场上才发现。4.3 试卷落库与卷面组装抽出来的只是题目列表还要重排题号、分配分值、算出卷面总分再整体写进paper和paper_question。顺序很讲究按题型分组组内保持抽题顺序组间按单选 → 多选 → 判断 → 填空 → 简答排题号从 1 连续编到底。// 保存试卷先写主表拿 id再批量写关联最后回填总分 public int SavePaper(string title, ListQuestion questions) { using var conn new SQLiteConnection(_connStr); conn.Open(); using var tx conn.BeginTransaction(); var paperId InsertPaper(conn, tx, title); var seq 0; double total 0; // 按题型分组组内保持抽题顺序组间固定顺序 foreach (var group in questions.GroupBy(q q.Type).OrderBy(g (int)g.Key)) { foreach (var q in group) { seq; var score q.PaperScore 0 ? q.PaperScore : q.DefaultScore; total score; InsertPaperQuestion(conn, tx, paperId, q.Id, seq, score); } } UpdatePaperTotal(conn, tx, paperId, total); tx.Commit(); return paperId; }seq用独立变量累加而不是用列表下标是为了让“题号连续”这件事不受分组影响。score优先取题目在这次组卷里的临时分值取不到才回落到题目自带建议分值这样同一道题进不同卷子可以有不同权重。表面上看这是几行 INSERT实际它决定了导出环节能不能靠一个ORDER BY seq就把卷面顺序还原出来——卷面顺序一旦落库模板里就只需要写占位符不用在导出时再算一遍。5. 避坑与排查Excel 导入、数据库锁、导出乱码这几件事单机版的问题九成集中在“数据进出”这两个口子上Excel 导入和 Word 导出。这两处代码通常写得最随意也最容易在换机器、换 Office 版本、换 Excel 保存格式的时候炸。下面几条都是我在实际拆包和改代码时反复遇到的。5.1 坑一Excel 导入后题干全变科学计数法现象导入成功但打开一看纯数字的题干变成了1.23E11或者001变成了1。原因导入代码用单元格的NumericCellValue无脑转字符串或者干脆走ToString()。Excel 里数字单元格没有“前导零”和“长整型原样”的概念取出来就是 double。解决按单元格类型分支取值数字型统一走DataFormatter或等价能力格式化同时给模板加一列“题干”强制文本格式并在导入前用一次“是不是合法数字”做拦截提示。// 按单元格类型取值别用统一的 ToString 一刀切 string CellText(ICell cell) { if (cell null) return ; switch (cell.CellType) { case CellType.Numeric: // 整数值按整数输出避免 3 变成 3.0也别让长数字进科学计数法 var d cell.NumericCellValue; return Math.Abs(d - Math.Round(d)) 1e-9 ? ((long)Math.Round(d)).ToString() : d.ToString(0.####); case CellType.Formula: return cell.CachedFormulaResultType CellType.Numeric ? CellText(cell) : cell.StringCellValue; default: return cell.StringCellValue ?? ; } }5.2 坑二批量导入跑到一半报 database is locked现象一次导三百题进度条走到一半抛异常前面导进去的题目还在数据成了半截。原因两个问题叠在一起。一是导入没包事务每条题目单独提交二是没设busy_timeout后台线程和前台窗体抢写锁直接失败。解决整批导入包一个大事务每 100 条提交一次连接串加上busy_timeout导入期间把主窗体录入功能禁用掉。5.3 坑三导出的 Word 换了台机器排版全乱现象开发机上导出正常客户机上表格边框没了、题号变成乱码或者字体变宋体。原因导出走的是 Office COM 调用本机 Word模板里的样式依赖本机字体和 Word 版本还有一种是把占位符{{STEM}}直接替换成题干题干里带、时被当成 XML 标签吞掉。解决优先改走 OpenXML 或者用docx模板做占位符替换不依赖本机 Office替换前对文本做 XML 转义换行统一转成w:br/。// 占位符替换前必须转义否则题干里的 和 会把文档结构打烂 static string EscapeXml(string s) (s ?? ).Replace(, amp;) .Replace(, lt;) .Replace(, gt;) .Replace(\r\n, /w:tw:br/w:t) .Replace(\n, /w:tw:br/w:t);5.4 坑四删了题试卷里的题号出现空洞现象编辑一份旧试卷时题号变成 1、3、4、7中间缺号。原因paper_question上的外键删掉了question记录时级联清了关联行但没重排剩下的seq或者反过来外键没开删题后关联行成了孤儿查询 join 不上就断号。解决删题走软删除加is_deleted字段已经出过的卷子一律不物理删如果确实要重排写一个Resequence(paperId)方法按现有seq排序后重新赋 1..N并同步更新总分。提示单机版没有审计日志软删除是唯一能救回误删的手段。我在question表上加is_deleted之后所有查询统一拼WHERE is_deleted 0封装在仓储层里界面层感知不到。5.5 坑五备份文件越积越多把盘写满现象用了半年Data/backup目录几百个文件C 盘告警。原因启动就备份、从不清理或者备份是按“每次保存”触发而不是按天。解决备份按天去重同一天只留最早的一份那是最接近“干净状态”的启动时按BackupKeepDays清理过期文件备份文件用qbank_20240513.db这种可排序命名别用qbank(1).db。6. 二次开发加一种新题型顺手把存储层解耦这套系统最典型的改造需求是“再加一种题型”比如材料题、连线题。改动面比想象的大但只要按链路走不会漏。第一步扩type枚举并在题型字典里登记题库管理界面的下拉框跟着走第二步写一个对应的题目编辑器窗体材料题多了“共用材料”字段就在question上加一列parent_id指向材料主记录或者建一张question_material表第三步改组卷器的配额校验材料题通常是“1 段材料带 3 个小题”Count的含义从“题数”变成“材料段数”这块要单独写个分支第四步改Templates/paper.docx加一段循环占位符导出时按材料分组渲染。改之前我建议先做一件事把仓储层抽成接口。原代码大概率是窗体里直接 new 连接、直接拼 SQL这种写法加题型时会到处改。抽成IQuestionRepository、IPaperRepository之后界面层只依赖接口加字段只改实现类还能顺手写一套针对 SQLite 内存库的单元测试来验证组卷算法——Data Source:memory:建库、灌 50 道模拟题、跑一遍Draw检查不重题、难度分布、总分对不对几秒钟跑完比手工点界面靠谱得多。改造点影响文件验证方式新增题型枚举题型字典、编辑器窗体录入 3 道新题型检索能查到组卷配额分支PaperBuilder用内存库跑单测校验数量和总分导出模板paper.docx占位符导出后用 Word 打开看结构是否完整存储接口化仓储层 界面层老功能回归增删改查、导入、组卷、导出各走一遍还有个小技巧加题型时先别急着改数据库用ALTER TABLE question ADD COLUMN加可空列旧数据不用迁移代码里对NULL做兜底。等新题型稳定跑一个月再把历史数据批量补上。血泪经验是别一上来就重建表单机版用户不会备份重建失败就是灾难。从那以后我每次动这类单机项目的表结构都强制走一遍“备份 → 迁移脚本 → 内存库单测 → 拿真实题库副本跑一遍组卷”的流程宁可多花二十分钟也不要在客户的办公电脑上边改边试。希望帮到你。本文还有配套的精品资源点击获取
简介万维题库管理系统单机版面向教育机构教务人员、教师及需要自测备考的个人用户主要用于解决大量试题分散存放、检索困难与组卷效率低的问题。它可以脱离网络独立运行适合机房、内网或对数据隐私有要求的场景。压缩包共11个文件约14.21MB以安装程序为主SETUP.EXE 与配套的 dll、lib、ins、ini 等文件负责安装与参数配置另有 Readme-说明.htm 提供使用说明与许可信息整体是典型的单机软件安装盘结构。目前已有2257人学习下载。安装后用户可围绕题目分类管理、试题导入导出、随机组卷、答案解析与难度标注等环节建立本地题库并形成可复用的组卷方案说明文档也能帮助读者快速了解功能边界与备份要求减少重复整理题目的时间成本。1. 单机版题库管理解决的是一线出卷人的痛苦我带过一个培训机构的教务小团队每到开课前一周最痛苦的不是讲课是出卷题目散在十几个 Excel 里改一道题要翻三四个文件出完还得手工排版、算分值、对答案错一个字母号就全卷重排。万维题库管理系统单机版瞄准的就是这个场景——它把题库管理从“文件夹 Excel”变成一个带界面的本地程序题目录入、分类检索、按规则组卷、导出成卷一条龙全程不需要连服务器装在本机、数据落在本地文件里关机就是备份。适合谁适合没有 IT 运维、只有一台办公电脑的教务老师也适合想拿它当骨架、改成自己机构专属题库的开发者。下面按我拆包的顺序讲先跑起来再看表结构最后落到组卷算法和二次改造。2. 跑起来单机版目录结构、运行环境和第一次初始化拿到包先别双击 exe先看目录。单机版这类工具的结构通常很朴素但恰恰是这种朴素暴露了它的设计边界数据全在一个本地文件里配置全在一个 app.config 里没有服务端、没有账号体系的后台。你把这几个文件认全了后面改代码就是按图索骥。2.1 目录结构三层是怎么分开的WanweiQuestionBank/ ├─ App.exe # 主程序入口WinForms 窗体的宿主 ├─ App.exe.config # 连接串、日志级别、导出模板路径 ├─ Lib/ # 第三方依赖Excel 读写、Word 导出、SQLite 驱动 ├─ Data/ │ ├─ qbank.db # 单机版的核心整个题库就是这一个文件 │ └─ backup/ # 每次启动自动留一份按日期命名的副本 ├─ Templates/ │ ├─ paper.docx # 试卷排版模板靠占位符替换 │ └─ paper_answer.docx # 答案卷模板 ├─ Logs/ # 按天切分的运行日志 └─ Resources/ # 图标、帮助文档、题型字典这个布局对应的是典型的三层切分App.exe是表现层所有窗体都挂在它下面Lib Data之间的调用是数据访问层封装 SQLite 的增删改查业务层夹在中间负责组卷规则、分值校验、导入解析这些“不碰界面也不碰 SQL”的逻辑。判断一个包是不是分层写好我一般看两点Data/qbank.db是不是唯一的数据来源以及Templates/里的模板是不是纯占位符、不含硬编码题号。两条都满足说明业务和排版是解耦的改起来省事。提示动手前先把整个目录复制一份到别的盘单机版很多是绿色包出问题直接换回旧目录就行别指望它有回滚机制。2.2 环境依赖不用装数据库但要装对运行时单机版最大的好处是没有外部依赖但“没有外部依赖”不等于“什么机器都能跑”。包里带的通常是 .NET Framework 4.x 的 WinForms 程序Windows 10/11 自带大部分版本Windows 7 可能得单独补。另外两类依赖容易漏一是 SQLite 的原生库Lib下的SQLite.Interop.dll之类32 位和 64 位是分开的硬混会直接抛Unable to load DLL二是导出 Word 用到的组件如果走的是 Office COM机器上就必须有 Office走 OpenXML 就不需要这一点在后面导出章节会具体说。!-- App.exe.config连接串和模板路径都在这里改路径比改代码快 -- configuration appSettings !-- 相对路径优先换机器不用改绝对路径只在数据挪到共享盘时用 -- add keyDbPath valueData\qbank.db / add keyTemplateDir valueTemplates / add keyAutoBackup valuetrue / !-- 备份保留天数超过的旧副本启动时清掉 -- add keyBackupKeepDays value15 / /appSettings /configuration这段配置的重点是DbPath用相对路径。很多人第一次迁移就把题库拷到 D 盘然后手改成绝对路径结果换台机器又崩。我的习惯是保持相对路径迁移时整个目录一起搬。AutoBackup建议别关单机版没有服务端事务日志一个误删就是真没了BackupKeepDays给 15 天足够覆盖一次排课周期。2.3 首次启动的完整链路从读配置到进主窗体很多人以为启动就是“打开窗体”实际上单机版启动阶段做的事情比想象中多读配置、验数据库、必要时建库、检查版本号做结构迁移、加载字典缓存最后才弹登录框。这条链路上任何一环失败表现出来都是“双击没反应”或者“一闪就退”所以日志的落点很关键。// Program.cs启动顺序不能乱数据库没准备好就不要往下走 static void Main() { var log Logger.Create(Logs); try { // 1. 配置读取缺 key 直接抛别用默认值兜底掩盖问题 var dbPath Config.Require(DbPath); var dbFull Path.Combine(AppDomain.CurrentDomain.BaseDirectory, dbPath); // 2. 数据库不存在就按内置脚本建库适合第一次分发 if (!File.Exists(dbFull)) { DbInitializer.Create(dbFull, Resources/schema.sql); log.Info($首次运行已创建数据库 {dbFull}); } // 3. 结构迁移靠一张 meta 表记版本升级包才敢直接覆盖 var version DbInitializer.GetSchemaVersion(dbFull); if (version DbInitializer.CurrentVersion) { DbInitializer.Migrate(dbFull, version, DbInitializer.CurrentVersion); log.Info($结构已从 v{version} 迁移到 v{DbInitializer.CurrentVersion}); } // 4. 启动前自动备份失败不阻断启动只记日志 if (Config.GetBool(AutoBackup)) BackupService.Snapshot(dbFull, log); Application.Run(new LoginForm(dbFull)); } catch (Exception ex) { log.Error(启动失败, ex); // 先落盘 MessageBox.Show(启动失败详情见 Logs 目录); // 再提示别让用户面对白屏 } }这段代码真正值钱的是第 3 步。单机版升级最怕的就是“新程序 旧数据”没有版本号就只能在代码里堆IF NOT EXISTS之类的判断越堆越乱。用一个meta表记 schema 版本升级包里带上迁移脚本覆盖安装就不会翻车。第 4 步的备份我建议一定要跑在登录之前因为登录后用户立刻可能开始批量导入那时候再备份就晚了。注意如果你的包启动后直接进了主窗体、没有登录框那多半是把“单机”理解成了“单用户免登录”。这种版本改多人共用会很难受后面二次开发章节会讲怎么补。3. 数据层拆解题目、选项、试卷三张核心表和一次完整写入判断一个题库系统好不好改不看界面漂不漂亮看表结构。表结构设计得糙你在界面上做十个功能也补不回来设计得对加题型、加检索维度都是加几行代码的事。单机版用 SQLite 是很自然的选择——零安装、单文件、支持事务缺点是并发写弱但单机场景本来也不缺这点。3.1 表结构为什么选项要单独一张表-- 题目主表所有题型共用靠 type 区分 CREATE TABLE question ( id INTEGER PRIMARY KEY AUTOINCREMENT, type INTEGER NOT NULL, -- 1单选 2多选 3判断 4填空 5简答 stem TEXT NOT NULL, -- 题干允许含换行 difficulty INTEGER NOT NULL DEFAULT 3, -- 1~5组卷时按档抽 knowledge TEXT, -- 知识点标签逗号分隔如 函数,极限 answer TEXT NOT NULL, -- 多选存 A|C填空存 北京|首都 analysis TEXT, -- 解析导出答案卷时用 default_score REAL NOT NULL DEFAULT 2, -- 建议分值出卷时可按题覆盖 created_at TEXT NOT NULL DEFAULT (datetime(now,localtime)) ); -- 选项表只有选择类题型才有数据其他题型这张表是空的 CREATE TABLE question_option ( id INTEGER PRIMARY KEY AUTOINCREMENT, question_id INTEGER NOT NULL, label TEXT NOT NULL, -- A/B/C/D不存序号便于打乱 content TEXT NOT NULL, FOREIGN KEY (question_id) REFERENCES question(id) ON DELETE CASCADE ); -- 试卷主表 试卷题目关联表关联表里存这一题在这份卷子里的分值 CREATE TABLE paper ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, created_at TEXT NOT NULL DEFAULT (datetime(now,localtime)), total_score REAL NOT NULL DEFAULT 0 ); CREATE TABLE paper_question ( paper_id INTEGER NOT NULL, question_id INTEGER NOT NULL, seq INTEGER NOT NULL, -- 卷面题号从 1 连续 score REAL NOT NULL, -- 覆盖 question.default_score PRIMARY KEY (paper_id, question_id) ); CREATE INDEX idx_question_type ON question(type, difficulty); CREATE INDEX idx_option_qid ON question_option(question_id);三个设计点值得说。第一选项单独成表而不是在question里塞option_a到option_f六个字段。塞字段看着省事但选项数一超、或者要加“选项解析”就没地方放了单独成表之后打乱选项顺序只需要重排label导出时再映射回 ABCD。第二分值存在关联表。同一道题在单元测里值 2 分、在期末卷里值 5 分如果分值写在题目表里就锁死了放在paper_question.score才对。第三answer用竖线分隔的多值字符串。严格说这不是第一范式但单机版题库量级通常在几千到几万题拆成question_answer表会让所有查询都多一次 join收益不划算属于可接受的妥协。提示knowledge用逗号分隔标签同样是不规范设计。如果后面要做知识点维度的统计报表建议加一张question_tag关系表别在 SQL 里写LIKE %,函数,%那个索引用不上。3.2 一次新增单选题的完整调用链界面点“保存”到数据落盘中间要过三层窗体收集控件值业务层做校验和归一化仓储层开事务写两张表。这段链路写清楚了加题型就只是在这条链上多一个分支。// QuestionRepository写题目必须在一个事务里主表和选项表不能半成功 public int Add(Question q) { using var conn new SQLiteConnection(_connStr); conn.Open(); using var tx conn.BeginTransaction(); // 显式事务别靠 autocommit try { // 1. 先写主表拿到自增 id var cmd conn.CreateCommand(); cmd.Transaction tx; cmd.CommandText INSERT INTO question(type, stem, difficulty, knowledge, answer, analysis, default_score) VALUES (type, stem, diff, know, ans, ana, score); SELECT last_insert_rowid();; cmd.Parameters.AddWithValue(type, (int)q.Type); cmd.Parameters.AddWithValue(stem, q.Stem.Trim()); cmd.Parameters.AddWithValue(diff, q.Difficulty); cmd.Parameters.AddWithValue(know, string.Join(,, q.Knowledge)); cmd.Parameters.AddWithValue(ans, string.Join(|, q.Answer)); cmd.Parameters.AddWithValue(ana, q.Analysis ?? ); cmd.Parameters.AddWithValue(score, q.DefaultScore); var newId Convert.ToInt32(cmd.ExecuteScalar()); // 2. 再批量写选项一条一条 Prepare 比拼 SQL 安全也更快 foreach (var opt in q.Options) { var oc conn.CreateCommand(); oc.Transaction tx; oc.CommandText INSERT INTO question_option(question_id,label,content) VALUES(qid,l,c); oc.Parameters.AddWithValue(qid, newId); oc.Parameters.AddWithValue(l, opt.Label); oc.Parameters.AddWithValue(c, opt.Content.Trim()); oc.ExecuteNonQuery(); } tx.Commit(); return newId; } catch { tx.Rollback(); // 回滚后把异常往上抛由界面层统一提示 throw; } }last_insert_rowid()是 SQLite 拿自增主键的标准写法注意它和插入必须在同一条命令里执行否则中间被别的连接插入就串了。参数化这里不只是防注入——题干里带单引号、带换行是常态拼字符串必翻车。事务边界划在“主表 全部选项”这一层是因为这两张表在业务上是一个整体只有题干没有选项的选择题进组卷池就是脏数据。3.3 单机版也躲不开的写入一致性单机不等于单线程。用户点“批量导入”的时候界面上那个进度条如果跑在后台线程同时用户又去改了另一道题两个连接同时写 SQLite 就会撞database is locked。默认的 rollback journal 模式下写锁是排他的读可以并发、写不行。我的做法是初始化时切 WAL// 打开连接后立刻执行的几条 PRAGMA作用比连接串参数更明确 using var cmd conn.CreateCommand(); cmd.CommandText PRAGMA journal_mode WAL; -- 读写不再互相阻塞单机多线程够用 PRAGMA synchronous NORMAL; -- 兼顾速度和安全配合每日备份足够 PRAGMA busy_timeout 5000; -- 抢不到锁等 5 秒再抛别立刻失败 PRAGMA foreign_keys ON; -- 删题时级联清选项必须显式开; cmd.ExecuteNonQuery();busy_timeout这条最容易被忽略。没有它后台导入和前台保存撞上就是直接弹异常有了它绝大多数冲突会在几毫秒内自愈用户根本感知不到。foreign_keys默认是关的不显式打开ON DELETE CASCADE就是一句装饰。文件里改了这几行之后删除题目才真的会把选项一起清掉不会在question_option里留一堆孤儿行拖慢查询。4. 组卷引擎从抽题配额到一份可打印试卷的生成链路题库管理的价值一半在录题一半在组卷。手工挑题的痛点是“抽了 20 道发现有三道重复考点”程序组卷要解决的正是这个按配额抽、按难度配比、保证不重题、抽不够时有降级策略。这段逻辑通常藏在一个PaperBuilder之类的类里是整个项目里最值得读透的一块。4.1 组卷参数四个维度定一份卷子参数含义常见取值改这里会怎样Type题型1单选 2多选 3判断 4填空 5简答加题型要同步改字典和导出模板Count该题型题数单选 20、判断 10超出题库量会触发降级Difficulty目标难度档1~5可给区间给区间时按“先高后低”补足Knowledge知识点过滤逗号分隔空表示不限过滤太细容易抽不满Score每题分值单选 2、简答 10写入paper_question.score一条配额对应一个题型。实际用的时候教务给的往往是“单选 20 题 2 分、多选 10 题 3 分、判断 10 题 1 分、简答 4 题 10 分”这种表单程序把它翻译成一串配额对象丢给组卷器。这里有个隐性约束配额加起来的总分要等于卷面分否则导出时必须重新分配分值。我一般让程序先算总分和卷头写死的分数对不上就拦住别等打印出来才发现。4.2 抽题算法分桶洗牌 去重 降级public ListQuestion Draw(PaperRule rule) { var result new ListQuestion(); var picked new HashSetint(); // 跨题型去重同一道题不许出现两次 var rnd new Random(rule.Seed); // 传种子就能复现同一份卷子 using var conn new SQLiteConnection(_connStr); conn.Open(); foreach (var quota in rule.Quotas) { // 1. 按条件把候选池捞出来只取需要的列别 SELECT * var pool QueryPool(conn, quota) .Where(q !picked.Contains(q.Id)) .ToList(); // 2. 按难度分桶每桶内部洗牌不打乱桶的顺序高难度优先出 var buckets pool.GroupBy(q q.Difficulty) .OrderByDescending(g g.Key) .Select(g Shuffle(g.ToList(), rnd)) .ToList(); var take new ListQuestion(); foreach (var bucket in buckets) { if (take.Count quota.Count) break; take.AddRange(bucket.Take(quota.Count - take.Count)); } // 3. 降级知识点过滤太严导致抽不满时放宽知识点但保留题型 if (take.Count quota.Count) { var extra QueryPool(conn, quota, ignoreKnowledge: true) .Where(q !picked.Contains(q.Id) take.All(t t.Id ! q.Id)) .OrderBy(_ rnd.Next()) .Take(quota.Count - take.Count); take.AddRange(extra); } // 4. 还不够就如实报错别静默少题 if (take.Count quota.Count) throw new PaperBuildException( $题型 {quota.TypeName} 需要 {quota.Count} 题题库仅能满足 {take.Count} 题); take.ForEach(q picked.Add(q.Id)); result.AddRange(take); } return result; }分桶洗牌这一步是整段的核心。为什么不直接ORDER BY random() LIMIT n因为那样抽出来的难度分布是不可控的题库里简单题多的时候整张卷子会偏简单。分桶之后“桶按难度降序、桶内随机”就同时满足了两个需求难度配比可控同难度内不重复。Seed这个参数看起来多余实际很有用——生成的卷子发给不同班级时要保持一致出问题也能复现属于后悔药级设计。降级逻辑要慎用放宽知识点可以放宽题型不行题型变了卷面结构就崩了。注意第 4 步抛异常而不是“有多少给多少”。我见过太多系统在这里静默返回结果卷子少了三道题老师打印前没数考场上才发现。4.3 试卷落库与卷面组装抽出来的只是题目列表还要重排题号、分配分值、算出卷面总分再整体写进paper和paper_question。顺序很讲究按题型分组组内保持抽题顺序组间按单选 → 多选 → 判断 → 填空 → 简答排题号从 1 连续编到底。// 保存试卷先写主表拿 id再批量写关联最后回填总分 public int SavePaper(string title, ListQuestion questions) { using var conn new SQLiteConnection(_connStr); conn.Open(); using var tx conn.BeginTransaction(); var paperId InsertPaper(conn, tx, title); var seq 0; double total 0; // 按题型分组组内保持抽题顺序组间固定顺序 foreach (var group in questions.GroupBy(q q.Type).OrderBy(g (int)g.Key)) { foreach (var q in group) { seq; var score q.PaperScore 0 ? q.PaperScore : q.DefaultScore; total score; InsertPaperQuestion(conn, tx, paperId, q.Id, seq, score); } } UpdatePaperTotal(conn, tx, paperId, total); tx.Commit(); return paperId; }seq用独立变量累加而不是用列表下标是为了让“题号连续”这件事不受分组影响。score优先取题目在这次组卷里的临时分值取不到才回落到题目自带建议分值这样同一道题进不同卷子可以有不同权重。表面上看这是几行 INSERT实际它决定了导出环节能不能靠一个ORDER BY seq就把卷面顺序还原出来——卷面顺序一旦落库模板里就只需要写占位符不用在导出时再算一遍。5. 避坑与排查Excel 导入、数据库锁、导出乱码这几件事单机版的问题九成集中在“数据进出”这两个口子上Excel 导入和 Word 导出。这两处代码通常写得最随意也最容易在换机器、换 Office 版本、换 Excel 保存格式的时候炸。下面几条都是我在实际拆包和改代码时反复遇到的。5.1 坑一Excel 导入后题干全变科学计数法现象导入成功但打开一看纯数字的题干变成了1.23E11或者001变成了1。原因导入代码用单元格的NumericCellValue无脑转字符串或者干脆走ToString()。Excel 里数字单元格没有“前导零”和“长整型原样”的概念取出来就是 double。解决按单元格类型分支取值数字型统一走DataFormatter或等价能力格式化同时给模板加一列“题干”强制文本格式并在导入前用一次“是不是合法数字”做拦截提示。// 按单元格类型取值别用统一的 ToString 一刀切 string CellText(ICell cell) { if (cell null) return ; switch (cell.CellType) { case CellType.Numeric: // 整数值按整数输出避免 3 变成 3.0也别让长数字进科学计数法 var d cell.NumericCellValue; return Math.Abs(d - Math.Round(d)) 1e-9 ? ((long)Math.Round(d)).ToString() : d.ToString(0.####); case CellType.Formula: return cell.CachedFormulaResultType CellType.Numeric ? CellText(cell) : cell.StringCellValue; default: return cell.StringCellValue ?? ; } }5.2 坑二批量导入跑到一半报 database is locked现象一次导三百题进度条走到一半抛异常前面导进去的题目还在数据成了半截。原因两个问题叠在一起。一是导入没包事务每条题目单独提交二是没设busy_timeout后台线程和前台窗体抢写锁直接失败。解决整批导入包一个大事务每 100 条提交一次连接串加上busy_timeout导入期间把主窗体录入功能禁用掉。5.3 坑三导出的 Word 换了台机器排版全乱现象开发机上导出正常客户机上表格边框没了、题号变成乱码或者字体变宋体。原因导出走的是 Office COM 调用本机 Word模板里的样式依赖本机字体和 Word 版本还有一种是把占位符{{STEM}}直接替换成题干题干里带、时被当成 XML 标签吞掉。解决优先改走 OpenXML 或者用docx模板做占位符替换不依赖本机 Office替换前对文本做 XML 转义换行统一转成w:br/。// 占位符替换前必须转义否则题干里的 和 会把文档结构打烂 static string EscapeXml(string s) (s ?? ).Replace(, amp;) .Replace(, lt;) .Replace(, gt;) .Replace(\r\n, /w:tw:br/w:t) .Replace(\n, /w:tw:br/w:t);5.4 坑四删了题试卷里的题号出现空洞现象编辑一份旧试卷时题号变成 1、3、4、7中间缺号。原因paper_question上的外键删掉了question记录时级联清了关联行但没重排剩下的seq或者反过来外键没开删题后关联行成了孤儿查询 join 不上就断号。解决删题走软删除加is_deleted字段已经出过的卷子一律不物理删如果确实要重排写一个Resequence(paperId)方法按现有seq排序后重新赋 1..N并同步更新总分。提示单机版没有审计日志软删除是唯一能救回误删的手段。我在question表上加is_deleted之后所有查询统一拼WHERE is_deleted 0封装在仓储层里界面层感知不到。5.5 坑五备份文件越积越多把盘写满现象用了半年Data/backup目录几百个文件C 盘告警。原因启动就备份、从不清理或者备份是按“每次保存”触发而不是按天。解决备份按天去重同一天只留最早的一份那是最接近“干净状态”的启动时按BackupKeepDays清理过期文件备份文件用qbank_20240513.db这种可排序命名别用qbank(1).db。6. 二次开发加一种新题型顺手把存储层解耦这套系统最典型的改造需求是“再加一种题型”比如材料题、连线题。改动面比想象的大但只要按链路走不会漏。第一步扩type枚举并在题型字典里登记题库管理界面的下拉框跟着走第二步写一个对应的题目编辑器窗体材料题多了“共用材料”字段就在question上加一列parent_id指向材料主记录或者建一张question_material表第三步改组卷器的配额校验材料题通常是“1 段材料带 3 个小题”Count的含义从“题数”变成“材料段数”这块要单独写个分支第四步改Templates/paper.docx加一段循环占位符导出时按材料分组渲染。改之前我建议先做一件事把仓储层抽成接口。原代码大概率是窗体里直接 new 连接、直接拼 SQL这种写法加题型时会到处改。抽成IQuestionRepository、IPaperRepository之后界面层只依赖接口加字段只改实现类还能顺手写一套针对 SQLite 内存库的单元测试来验证组卷算法——Data Source:memory:建库、灌 50 道模拟题、跑一遍Draw检查不重题、难度分布、总分对不对几秒钟跑完比手工点界面靠谱得多。改造点影响文件验证方式新增题型枚举题型字典、编辑器窗体录入 3 道新题型检索能查到组卷配额分支PaperBuilder用内存库跑单测校验数量和总分导出模板paper.docx占位符导出后用 Word 打开看结构是否完整存储接口化仓储层 界面层老功能回归增删改查、导入、组卷、导出各走一遍还有个小技巧加题型时先别急着改数据库用ALTER TABLE question ADD COLUMN加可空列旧数据不用迁移代码里对NULL做兜底。等新题型稳定跑一个月再把历史数据批量补上。血泪经验是别一上来就重建表单机版用户不会备份重建失败就是灾难。从那以后我每次动这类单机项目的表结构都强制走一遍“备份 → 迁移脚本 → 内存库单测 → 拿真实题库副本跑一遍组卷”的流程宁可多花二十分钟也不要在客户的办公电脑上边改边试。希望帮到你。本文还有配套的精品资源点击获取
