企业官网建设流程全解析

Qwerty Learner 自定义词库实操：10 分钟做出你的专属练习词表

【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner

默认词库里没有你行业的术语，最近攒下来的那批单词也没地方练。Qwerty Learner 是面向键盘工作者的单词记忆与打字训练工具，它的词库全部是普通 JSON 文件——会写 JSON，就能把自己的词汇表变成一份可练习的自定义词库。

先看效果

做完之后，你的词库会和内置词库一起出现在词库页，点进去和任何词库行为一致：分章练习、进度统计、错词本都能用。

动手前：词库文件在哪、长什么样

词库文件都放在 public/dicts/ 目录下，是一个 JSON 数组，每个元素代表一个单词：

[ { "name": "affinity", "trans": ["n. 亲和力，密切关系"], "usphone": "əˈfɪnəti", "ukphone": "əˈfɪnəti" } ]

• name是单词本身，trans是释义数组，这两个必填
• usphone/ukphone是美式 / 英式音标，可选，不写就不显示音标
• 章节不用你管：应用按每 20 个词自动分章

创建词库文件

在 public/dicts/ 下新建一个 JSON 文件，比如my_vocabulary.json。文件名用小写字母加下划线最省心。第一次练手建议只写 20 个单词，正好一章，验证起来快。

在配置文件里注册新词库

光放文件还不够。词库列表来自 src/resources/dictionary.ts，找到你词库对应的分类数组（英语词库可加在chinaExam或internationalExam里），按现有条目的格式补一条：

{ id: 'my-vocabulary', name: '我的词汇表', description: '个人自定义练习词库', category: '中国考试', // 可复用已有分类，或填新分类 tags: ['练习'], url: '/dicts/my_vocabulary.json', length: 20, language: 'en', languageCategory: 'en', }

三个容易忽略的点：

• id全局唯一，不能和已有词库重名
• url必须写成/dicts/文件名的形式，对应public/dicts/下的真实文件
• length要填真实单词数，应用靠它计算章节数

跑起来验证

yarn dev

打开词库页找到你的词库，点进去练完一章。单词正常显示、能正常统计，就算通过了。✅

踩坑与排错

• 💡词库不出现或打开是空白：多半是 JSON 语法错误（多余的尾逗号、全角引号），或url里的文件名和真实文件对不上（大小写敏感）。把内容丢进 JSON 校验器过一遍，再逐个字母比对文件名。
• 章节数和预期不符：length与文件里实际单词数不一致。项目自带脚本node scripts/update-dict-size.js，它会扫描public/dicts/下所有 JSON 并把真实数量写回dictionary.ts。
• id与已有词库冲突：页面不报错，但点进去练习会异常。在配置文件里搜一下这个 id，改成唯一的即可。

延伸玩法

• 批量导入：Excel、CSV 词表可以先转成上面的 JSON 数组结构再放入词库目录
• 同步词数：每次批量更新词库后跑一遍node scripts/update-dict-size.js，不用手动数
• 共享词库：如果你的词库对别人也有用，可以提 PR 提交回仓库
• 持续维护：往词库加单词时同步更新length，或直接跑上面的同步脚本

整个流程就是三步：写 JSON、注册配置、跑起来验证。可以先建一个 20 个单词的最小词库，流程走通之后再慢慢扩充到几百个。

【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner