如何在 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 把「打字练习 单词记忆」拧在一起你边敲键盘边背词手感和词量一起涨。想练自己领域里的词专业课、项目术语、某场考试的高频词就得会自定义词库添加。下面先带你拆它的加载原理再照着清单动手最后给验证和避坑建议。词库是怎么被加载的先看懂两个文件别急着建文件。先记住一个词库 一份数据 一张档案数据你的单词本身放在 词库目录 下的.json档案名字、分类、语言、单词数登记在 元数据文件运行时App 拿档案里的url形如/dicts/my_vocab.json去fetch那份 JSON解析成一串单词再按每 20 个一章切给你练。所以你真正要做的只有两件事把 JSON 放进public/dicts/在元数据里补一行档案。怎么写一份能被识别的词库JSON结构打开public/dicts/里任意现成文件比如CET4_T.json照抄字段即可结构长这样[ { name: algorithm, trans: [算法程序], usphone: ældżərəðəm, ukphone: ældgərɪðəm } ]字段说明对照 Word 类型定义name要练的英文单词trans释义字符串数组可写多条usphone/ukphone美音 / 英音音标没有就填notation可选词性标注只要字段名对得上发音和默写就能正常渲染不用管顺序。怎么在元数据里注册你的自定义词库JSON 放好还不够得让 App 知道它的存在。打开src/resources/dictionary.ts在对应语言分组里追加一段档案下面是英文词库的写法照着填{ id: my_vocab, name: 我的专业词汇, description: 计算机专业备考词, category: 中国考试, tags: [自定义], url: /dicts/my_vocab.json, length: 120, language: en, languageCategory: en, }填的时候盯住这几点id全局唯一用英文小写如my_vocaburl必须以/dicts/开头指向你刚放好的文件名category填一个已存在的分组名界面按它归类想新开班就写新名字length 单词总数就是 JSON 数组的长度英文词库的language和languageCategory都填en文件名只建议用字母、数字、下划线、连字符这样后面的统计脚本才能自动认出来。加完怎么验证它真的生效 ✅改完两处跑yarn dev起本地服务去词库选择页找你的新卡片能翻到第一个词、发音有反应、默写能开就说明加载成功了。再往下练一章确认单词按 20 个一章翻页、进度能正常记录。这一步能抓出url打错、JSON 里多逗号这类隐蔽问题——页面空白或报错多半是数据没解析对。维护清单length字段和批量导入的坑怎么避词库不是一次性的后期最常踩三个点 单词增删 → 记得同步length或直接跑node scripts/update-dict-size.js它会自动读public/dicts/下所有 JSON 回填 length 批量导入Excel / CSV→ 先把数据规整成上面那种 JSON 数组再落盘别手敲几百行发音字段可留空 →usphone/ukphone填不影响练习只是没音频三处对齐——JSON 文件、元数据档案、length 数字——你的专属词库就能长期用下去。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考