如何把自定义词典导入 Qwerty Learner从零到跑起来的完整指南【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerQwerty Learner 是一款为键盘工作者打造的单词记忆与英语肌肉记忆训练工具通过打字练习帮你把词汇刻进手指。本文带你从零完成自定义词典导入10 分钟让专属词库投入练习。什么场景下需要自己的词库项目自带的词库覆盖了几百种场景从四级、雅思到编程语言关键字全部放在 public/dicts/ 目录里。但如果你要背的内容是行业术语、内部产品词或某份定制考纲预设词库大概率不够用。这时你可以准备一份自己的 JSON 词典导入后它会像内置词库一样出现在选择界面按分类和章节供你点击 Start 开始打字练习。准备词典 JSON 文件的正确字段每个单词是一个对象整个文件是由这些对象组成的数组。字段如下字段作用是否必填name单词本体即你要打出来的内容是trans释义数组可放多条词性与解释是usphone美式音标是ukphone英式音标是notation备注说明否文件请用 UTF-8 编码保存。验证动作把内容粘贴到任意在线 JSON 校验器或本地 JSON 解析中跑一遍不报错且能解析出对象数组这一步才算通过。放置词典文件到正确目录把文件放进public/dicts/目录即可命名随意但必须以.json结尾例如public/dicts/my_terms.json。这一步只放文件界面还不会自动出现它。在索引文件中注册词典条目词典列表不是扫描目录自动生成的你需要在 src/resources/dictionary.ts 里追加一条记录字段含义字段说明id唯一标识不能与现有词典重复name界面展示的词典名description词典描述文案category分类建议沿用已有分类方便归入现有标签页url指向刚放入的 .json 文件路径length单词数量language / languageCategory语言标记决定出现在哪个语言标签下验证动作url路径与磁盘上的真实文件一一对上length可运行 scripts/update-dict-size.js 自动统计避免手填错。启动项目确认词典出现在仓库根目录执行git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner yarn install yarn dev然后访问http://localhost:5173。打开词典选择界面能看到你刚登记的词典卡片名称、词数、分类都正确就表示导入成功。✅ 接着点进该词典、按 Start 敲几个单词确认释义与发音显示正常整条链路就算彻底跑通。词典不显示时的排查顺序按命中率从高到低依次检查通常前三项就能定位问题JSON 能否解析——多逗号、缺引号、中文引号混入都会导致整份词典被静默跳过文件位置与扩展名——确认在public/dicts/下且以.json结尾编码为 UTF-8url 是否指向真实文件——索引里写的路径和磁盘路径差一个/或大小写都会失效id 是否重复——重复 id 可能让条目被去重丢掉。进阶拆分大词典与社区共建单词量过大数千词以上时考虑拆成多份文件分章节练习单次目标更聚焦词库内容增删后重新运行scripts/update-dict-size.js同步 length 字段想让词库惠及更多人可以参照 docs/toBuildDict.md 了解社区词典的共建流程把你的词库提交给项目。一条 JSON 文件加一行索引注册就能让 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），仅供参考