如何把自己的词表装进 Qwerty Learner自定义词典导入实操指南【免费下载链接】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 词表丢进项目页面不会自动把它认出来。自定义词典由两样东西拼成缺一不可组成部分所在位置负责什么数据文件public/dicts/下的 JSON 词表存放单词和释义的正文内容注册信息src/resources/dictionary.ts 里的一条记录告诉界面这本词典叫什么、归哪个分类、有多少词两边都齐活词库才会出现在列表页。只放文件不注册界面就当它不存在。动手前确认三件事环境检查。本地备齐 Node.js、Git、Yarn各跑一条命令确认版本号能正常输出node --version git --version yarn --version词表文件结构。目标格式是一个 JSON 数组每条记录必须有name单词和trans释义字符串数组两个字段[ { name: file, trans: [n. 档案, 文件] }, { name: command, trans: [n. 命令, 指挥] } ]文件存放位置。词表放在public/dicts/目录下保存时选 UTF-8 编码保证中文释义不乱码。五步把词库搬进列表先把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner后续所有改动都在自己这份副本上进行与远端仓库无关改坏了随时能重来。完成后本地多出一个qwerty-learner文件夹。写一个词表文件把整理好的词表保存为public/dicts/your_dict.json。手头是 Excel 或文本表格的话让 AI 工具批量转成目标格式再人工抽查几条确认没有漏字或串行。完成后用任意 JSON 校验工具检查一遍不报错即可。在注册文件里加一条记录打开 src/resources/dictionary.ts照抄附近现有条目的写法补一项{ id: mydict, name: 我的词库, description: 日常工作高频词汇, category: 编程, tags: [日常], url: /dicts/your_dict.json, length: 1200, language: en, languageCategory: en }id必须全项目唯一起完先搜一遍文件确认不重名length先估个数下一步脚本会修正。完成后注册文件里能搜到你新加的这一条。用脚本补齐词量node scripts/update-dict-size.js脚本会扫描public/dicts/下每个 JSON 的真实词条数把准确数字写回注册文件省掉手动数词。完成后注册文件里length已变成真实词数。启动本地服务验证yarn install yarn dev浏览器打开 http://localhost:5173 进入词库列表页。能在分类下看到自己的词库、名称和词数都对得上导入就成功了 让词库更好用的三处细节补上音标字段效果是练习界面直接显示英式、美式音标背词顺带记读音。做法是给每条记录加上usphone、ukphone。优先选已有分类效果是列表页不乱、方便按分类找书。做法是从现有分类里挑一个相近的不随手造新分类。大词库拆册效果是单次练习的章节更短更容易坚持。做法是把超过 5000 词的词表拆成每册 10003000 词分别注册。不同词库类型怎么配程序员 API 词库name填方法名或关键字、trans填参数说明把language与languageCategory都设为code→ 词典落在编程标签页 → 日常速记 API 很方便。非英语词库language换成对应枚举值德语de、日语ja、哈萨克语kk等取值清单见 src/typings/index.ts → 发音方式自动跟着语言切换 → 练习体验一致。备考词库归入已有的考试分类tags里补一个识别度高的标签 → 日后按标签筛选时一眼定位。高频坑速查症状原因解决列表里没有词库文件只放了没注册到 src/resources/dictionary.ts 补一条记录再刷新页面词量显示不对length还是手动估的值重跑一遍node scripts/update-dict-size.js页面报 JSON 解析错误编码不是 UTF-8或数组末尾多了逗号重新以 UTF-8 保存丢进 JSON 校验工具定位在自己的克隆里照着上面的五步把第一本自定义词库导进去吧字段细节随时可查 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），仅供参考