Qwerty Learner 自定义词库教程3 个文件搞定 Excel 词表转 JSON 专属词典【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerqwerty-learner 是一款把背单词和打字练习绑在一起的软件屏幕给出单词你靠键盘把它敲出来才算记住。它自带的词库从小学英语、四六级到 GRE、雅思都有可如果你的目标词单不在里面——比如医院轮岗的专业术语、公司代码库里的函数名、自己按考纲整理的雅思听力高频词——选库界面里就翻不到它。本文带你把一份 Excel 词表变成软件里能直接开练的专属词典只做三件事建一个 JSON 文件、登记一段元数据、核对一遍字数。以下所有路径都指你 clone 下来的本地副本全程不需要动上游仓库。图中是 qwerty-learner 的单词练习主界面单词、释义与按键输入区同屏换成自己的词库后界面不变变的只是词表内容。词库文件实际长什么样字段先对齐很多人照着网上旧教程建词库写出word、translation这样的字段名结果放进去就是白建。先看仓库里现成词表的真实结构raz-AA.json 里每个词是这样的{ name: boat, trans: [n. 小船轮船 vi. 划船], usphone: bəʊt, ukphone: bəʊt }整个词库文件是以[开头、以]结尾的数组每个元素这样一个对象。规则就四条name存单词本体必填trans存释义是个字符串数组写多行释义就放多个字符串必填usphone和ukphone分别存美音、英音标可选顶层必须是数组哪怕只有一个词。字段最少可以只有前两个{ name: nudge, trans: [v. (用肘)轻触、轻推] }GRE-1500 词表GRE_1500.json里的词就是这种裸词软件照常运行只是没有发音按钮的声音。把 Excel 词表转成 JSON导出 CSV 再转数组假设你的 Excel 前几列是单词、释义、美音。流程是三步把需要的列另存为 CSV避免 Excel 格式里的合并单元格捣乱用任意CSV 转 JSON工具转成数组保证每个词一行一个对象存进 public/dicts/文件名保持简短例如ielts-listening-2026.json小写字母最稳妥。如果表里恰好有美音和英音两列就把它们分别填进usphone和ukphone没有就留空不影响练习本身。还有一个隐藏机制值得知道词表加载后每 20 个词自动拆成一章你选库时看到的共 N 章就是从这里算出来的。图中是词库选择界面分类导航在左侧词库卡片上能看到单词数和章节进度你新登记的词库最终会出现在这里。自定义词库元数据在哪里登记dictionary.ts光有 JSON 文件软件不认识你。每个词库在 src/resources/dictionary.ts 里都有一段元数据CET-4 那段长这样{ id: cet4, name: CET-4, description: 大学英语四级词库, category: 中国考试, tags: [大学英语], url: /dicts/CET4_T.json, length: 2607, language: en, languageCategory: en, }照着抄一段插到对应分类的数组末尾即可。四个字段最容易出错id全局唯一建议直接用文件名去掉扩展名url必须以/dicts/开头并且和文件真实名字一字不差category决定它挂在哪个分类下可以选现成的也可以新建一个length先随便填个数占位下一节说怎么自动填对。单词数不用手数update-dict-size.js 的作用src/目录下有一个辅助脚本 scripts/update-dict-size.js。它会扫一遍public/dicts里所有 JSON统计单词数把结果写回dictionary.ts里已登记条目的length字段。顺序别搞反先登记元数据再跑脚本没登记的词表它不会碰。跑完不用自己核对打开选库界面看卡片上的数字对不对就行。图中是练习完成后的结果区打字速度和准确率按章节累计统计自定义词库练得越久这里的曲线越有参考价值。排查三件高频问题词库不出现、字数为 0、发音没声音词库不出现——九成是 JSON 语法没过关中文引号、数组末尾多一个逗号、漏了]都是常见死因。把文件丢进任意 JSON 校验工具看一眼最省事。校验过了还不出现就回头核url拼写然后重启本地开发服务静态资源是打包时读进去的。字数不对或显示 0——词表改过之后忘记重跑update-dict-size.js或者元数据里length还是手填的旧值。重跑一次就好。发音按钮没声音——词表里没有usphone/ukphone。想补的话从相近的现有词表里抄对应单词的音标列即可不必逐手查。图中是练习界面的单词区音标显示在单词下方点发音按钮可以听读音——这就是词表里两个音标字段在界面里的样子。进阶玩法编程词库、多语言、持续喂养照着编程词库抄public/dicts/ 里已经有一批编程词表比如 python-builtin.json、js-string.json、go_keyword.json。要自建技术术语库它们的字段写法就是现成模板。不只有英语仓库里也有日语 N5 到 N1 的词表以及哈萨克语基础词表照着现有配置改language字段就能建非英语词库。持续喂养词库文件本质是静态 JSON往自己的副本里加新词、补例句再跑一次字数脚本下一轮练习就生效。练习进度和错题存在浏览器本地换词库不会清掉历史数据。用听写模式练拼写练习界面有听写开关系统只念音、你来敲词专门用来抓眼熟手不生的词自定义词库开练后这个模式最值得打开。图中是听写模式界面屏幕不显示单词只靠读音把词敲出来适合检验自定义词库里那些反复出错的词。自定义词库执行清单照着勾完就能练 清单如下全部在本地副本完成词表 JSON 存入public/dicts/通过 JSON 语法校验在src/resources/dictionary.ts登记元数据id唯一、url与文件名一致运行 scripts/update-dict-size.js 同步真实字数打开选库界面确认卡片上的词数、章数正确进入第 1 章开练。勾完最后一项自定义词库就正式上线了。剩下的交给重复——词库是死的打字练习是活的。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考