10 分钟把自定义词库接进 Qwerty Learner当天就能打字练起来【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner你手上有一份自己的单词表——可能是考研重点、某个编程领域的 API、或者客户项目的术语——想在 Qwerty Learner 里练打字但不知道词库该以什么格式、放在哪、怎么让它出现在练习列表里。这篇文章就讲这件事一个 JSON 文件加一条索引记录你的自定义词库就能跑起来。词库是怎么被加载的Qwerty Learner 的词库不用装数据库全部是静态 JSON 文件。启动时它读 src/resources/dictionary.ts 这份索引索引里每条记录指向 public/dicts/ 目录下的一个 JSON 文件同时记录名称、分类、单词数量用来渲染词典列表和章节拆分。真正练词时前端按索引里的url去请求对应的 JSON 文件逻辑在 src/utils/wordListFetcher.ts拿到词条数组后开始出词。所以导入词库本质就两步把 JSON 放进对的目录在索引里登记一条记录。先把词表转成 JSON每个词条只要两个必填字段name是要敲的内容trans是释义数组。[ { name: file, trans: [n. 文件, 档案, vt. 归档] }, { name: path.join(), trans: [path 的 join 方法拼接路径片段] } ]源文件是 CSV 就转一下格式词条不多就手写条目多可以让 ChatGPT 写个转换脚本。trans必须是字符串数组哪怕只有一条释义也要写成[...]。文件放对目录再登记一条索引把处理好的文件命名为myDict.json放进 public/dicts/。然后在 src/resources/dictionary.ts 里合适的分类下加一条记录{ id: myDict, name: 我的词库, description: 专项词汇打字练习, category: 编程词汇, url: /dicts/myDict.json, length: 120, language: en, }id要全局唯一category建议沿用已有的分类值比如中国考试编程词汇length可以跑一下node scripts/update-dict-size.js自动算出全部词典的词条数并回填不用手数。启动开发服务器验证yarn install yarn dev访问 http://localhost:5173在词典列表里找到你的词库选它开一章练习能正常出词、显示释义就算搞定。容易踩的三个坑列表里看不到新词库→ 多半是只在public/dicts/放了文件忘了在dictionary.ts里加索引记录或者url写错了路径。核对两者文件名一致即可。能点开但出词空白或报错→ 检查 JSONtrans不是字符串数组、name缺失、文件里混进了注释都会导致解析失败。先用任意 JSON 校验工具确认格式合法。列表上显示的单词数不对→length是手写的近似值。跑node scripts/update-dict-size.js重新统计它会扫描整个public/dicts/目录并回填索引里的数量。再往上走一步词库跑通之后可以试着按主题做成系列比如按语言、按考试拆成多个词库挂到同一分类下练习时按章节推进比一锅端一个巨型词库体验好得多。完整流程见 docs/toBuildDict.md。自定义词库让 Qwerty Learner 从通用练字工具变成你自己的练习场。下一步把那份一直躺在文档里的词表转成 JSON接进去练一章。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
