Qwerty Learner自定义词典导入教程4步把你自己的词表送上打字练习页【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner你手上有一份自己整理的单词表想用它来练打字但Qwerty Learner——这款做单词记忆和英语肌肉记忆训练的打字软件——默认只提供内置词库。这篇教程带你从一份原始词表出发4步把自定义词典放进软件并真正跑起来。动手前自查4个硬性条件先花30秒确认以下事项能避开后面大部分返工格式词库是一个 JSON 文件顶层为数组每个词条至少含name单词和trans释义数组两个字段位置文件必须放在public/dicts/目录下注册软件不自动扫描目录词典必须在src/resources/dictionary.ts里登记一条记录才会出现在列表中编码文件保存为 UTF-8否则中文释义会乱码依赖本地需要 Node.js 环境项目用yarn管理依赖主流程从词表到练习页的4个步骤第1步获取项目并安装依赖在任意目录执行git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner yarn做完后应该看到node_modules/目录已生成终端无报错输出。第2步创建你的词典文件在public/dicts/下新建文件比如MyWords.json。内容长这样[ { name: example, trans: [n. 例子示例] }, { name: keyboard, trans: [n. 键盘, n. 打字机] } ]要点trans必须是数组一个单词有多个释义就放多个元素usphone、ukphone音标字段可选不提供则该词不显示音标。做完后应该看到文件可被任意 JSON 编辑器/校验器正常解析。第3步在索引文件中登记词典打开src/resources/dictionary.ts找到你目标分类对应的数组如chinaExam、internationalExam追加一条记录{ id: my-words, name: 我的专属词表, description: 个人整理的练词清单, category: 中国考试, tags: [大学英语], url: /dicts/MyWords.json, length: 120, language: en, languageCategory: en }各字段的作用id全局唯一重复会导致行为异常name/description展示给用户看的词典名和描述category决定词典在目录页归入哪个分组可先浏览该文件里已有的分类选一个url指向第2步的文件必须以/dicts/开头length词条总数后面会用脚本自动修正language/languageCategory词典的语言决定练习页的发音和显示方式第4步启动开发服务器并验证运行yarn dev浏览器打开http://localhost:5173。做完后应该看到词典目录页出现我的专属词表词量显示与文件一致点进去能开始打字练习每打对一个词都有即时反馈。两种典型词库的字段差异流程相同但不同用途的词典在注册字段上有讲究。场景一英语考试词汇考研、四六级等按第3步默认字段填写即可language: en、languageCategory: encategory选中国考试或国际考试。词条里建议带上usphone/ukphone这样练习时能开发音开关跟读。场景二编程术语、代码关键字这类词库走 code 通道两个字段要改成language: code, languageCategory: code此时练习页按代码模式处理词条不走英语发音逻辑。项目里go_keyword.json、python-builtin.json等都是这类可参考public/dicts/下的现成文件抄结构。顺带一提language还支持ja、de、id等取值做日语、德语词库时按需对应即可其余步骤不变。避坑区3个最容易卡住的地方词典注册了但列表里不出现现象yarn dev正常启动目录页却找不到新词典原因url写成了dicts/xxx.json漏了开头的/或id与已有词典重复被覆盖解法对照文件里相邻条目逐字段核对url必须以/dicts/开头词库能选但列表空白或报错现象点进词典后加载失败或词条没有释义原因JSON 语法错误数组末尾多写逗号、释义里含未转义的引号导致整个文件解析失败解法把文件内容粘进 JSON 校验器定位具体行同时确认trans是字符串数组而不是单个字符串词量数字对不上现象页面上显示的词条数和你实际的条数不一致原因length是手填的改过词表后忘了更新解法运行node scripts/update-dict-size.js脚本会扫描public/dicts/并自动把正确的数量写回src/resources/dictionary.ts下一步换成你真正的词表把第2步示例里的example、keyboard替换成你实际要练的词重跑第4步确认加载正常再做一本不同分类的词库比如一本考研、一本编程对比目录页的分组效果想从 CSV、Excel 等词源批量转换格式或走社区贡献流程把词典提交给官方完整说明见 docs/toBuildDict.md【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考