Qwerty Learner 自定义词典导入指南3步将任意词库变成打字练习素材【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerQwerty Learner 是一款为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件通过打字输入单词的方式同时巩固词汇记忆和键盘肌肉记忆。本文教你 3 步完成自定义词典导入把任何词库变成专属的打字练习素材。读完本文你能做什么读懂 Qwerty Learner 词典文件的 JSON 格式看懂每个字段的含义把自己的词库txt、Excel、ChatGPT 导出内容等转换成合法词典文件正确放置文件并登记到词典索引让新词典出现在练习界面用 3 条自查命令验证导入是否生效并会处理常见的不生效问题导入前需准备的3样东西一个已克隆的本地仓库——所有操作在你的本地副本中进行不改动线上仓库git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner你的原始词库数据——任意格式都可以文本、表格、CSV 等稍后统一转换成 JSON。Node.js 环境——用于运行项目自带的字数统计脚本和本地开发服务器可用node -v自查。核心操作从看懂格式到验证生效看懂格式Qwerty Learner 词典文件的 JSON 结构打开 public/dicts/ 目录中任意现有词典如CET4_T.json或程序员词库Child_cpp.json即可看到标准结构文件是一个 JSON 数组每个元素包含两个必填字段——name要练习输入的单词字符串和trans释义字符串数组usphone/ukphone美/英音标和notation标注为可选[ { name: file, trans: [n. 档案; 公文箱; [计算机] 文件, vt. 归档; 提交], usphone: faɪl, ukphone: faɪl } ]验证点trans必须是数组即使只有一条释义也要用[ ]包住这是新手最容易写错的地方。备齐数据把原始词库转换为目标 JSON根据来源选择最省力的转换方式内容不多几百条以内直接手动写成上面的格式有现成 CSV 表格用在线 CSV→JSON 转换工具批量转出再核对字段名格式复杂把源文件片段和需求描述给 ChatGPT让它生成转换脚本。预期结果得到一份以.json结尾、UTF-8 编码的文件建议文件名用英文如myterms.json内容通过任意在线 JSON 校验工具检查无报错。接入项目放置文件并登记词典索引词典要在练习界面出现需要完成两件事把 JSON 文件放入public/dicts/目录例如public/dicts/myterms.json在词典索引文件src/resources/dictionary.ts的数组中追加一条登记信息参照现有条目填写{ id: myterms, name: 我的专业词汇, description: 计算机专业常用词, category: 英语学习, url: /dicts/myterms.json, length: 0, language: en, languageCategory: en, }字段说明id必须全局唯一name是展示给用户看到的词典名category从现有条目的分类中选一个合适的url必须与第一步文件名严格一致length先填 0随后运行项目自带脚本自动计算node scripts/update-dict-size.js验证效果本地启动后确认词典已生效安装依赖并启动开发服务器yarn install yarn dev浏览器访问http://localhost:5173。验证点在词典列表中能看到我的专业词汇词量与你的文件一致选中它点击 Start页面中央出现单词、下方出现时间/速度/正确率统计条即导入成功。练习完一个章节后还可开启默写模式回测本章单词场景化应用同一套流程的两种变通程序员 API 词库把 Java、Python 常用 API 整理进 JSON模板见public/dicts/java-string.jsonname填方法名、trans填作用说明练习时顺带背熟 API 拼写考试词库分册一个 5000 词的考纲词表按核心词 / 进阶词拆成两个 JSON 分别登记每次只练一册降低单次练习负担。避坑指南导入不生效的3个常见原因现象词典列表里看不到新词典。原因只放了 JSON 文件没在src/resources/dictionary.ts中登记索引。解决补登记条目后重启开发服务器仍不显示则检查条目缩进和逗号是否破坏了数组语法。现象词典出现了但点开无法加载单词。原因url指向的文件名与实际文件名不一致大小写、下划线差异都会计或 JSON 含全角标点、尾随逗号等语法错误。解决逐一比对 url 与public/dicts/下的文件名用 JSON 校验工具定位首个报错位置。现象词典显示词量为 0 或与实际不符。原因length是手填值从未自动计算。解决运行node scripts/update-dict-size.js脚本会扫描public/dicts/并自动回写所有词典的真实词量。进阶技巧让自定义词典更好用为每个词补上 usphone/ukphone 音标——开启后练习界面显示音标并可发音听、看、打三路同步记忆留存更牢用现有词典当模板——照抄CET4_T.json的完整字段再替换内容比从零手写少踩一半格式坑给同族词库复用同一 category——同类词典在界面上归组展示找词更快也方便他人理解你的词库结构。写在最后把背诵词表和打字练习合二为一自定义词典就是 Qwerty Learner 的核心扩展方式。现在克隆仓库导入你的第一份词库开始打字记忆吧git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考