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 词典导入的完整流程一份 JSON 词表加一条索引记录自定义词库就能出现在打字练习的可选列表里全程 4 步每步都能当场验证。什么场景值得自己建一份词库先看一个具体场景很多后端程序员会觉得软件里自带的词库偏考试词汇同样的 abide 练了十几遍而天天打交道的 middleware、idempotent 却一个都没有。把这些工作高频词整理成词库练习内容才算真的为工作服务。还有一个备考场景错题才是最值钱的练习素材。把最近反复拼错的 200 个单词倒进词库每天练习的目标就非常明确。动手前自定义词库 JSON 格式与文件位置词库文件是一个 JSON 数组每个词条只有两个字段[ { name: refactor, trans: [v. 重构] }, { name: middleware, trans: [n. 中间件] } ]name是单词本身也就是练习时要打的内容trans是释义数组一个元素对应一个义项可以有多个。⚠️ 最容易踩的坑在末尾最后一个词条后多打逗号、或者用了中文引号这两处都会直接导致解析失败。另外需要明确两件事词库文件命名为your_dict.json放在 public/dicts/ 目录下因为要改索引文件并在本地环境验证需要先把项目克隆到本地git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner本机需要 Node.js 环境项目通过 yarn 安装依赖和启动。四步完成导入每步都有可当场验证的结果1. 生成 JSON 词表放入 public/dicts/做什么把词表转换成上面的格式。如果原始词表是 Excel 或 CSV用任意的在线表格转 JSON 工具批量转换再人工抽查若干条成功长什么样文件能被正常解析为 JSON用任意在线 JSON 校验器即可确认且词条数量与源表一致易踩的坑直接整表倒入而不先用 10~20 个词验证——格式错了几百个词条都要返工。2. 在 dictionary.ts 里登记一条索引打开 src/resources/dictionary.ts在对应分类的词表数组中追加一条记录。这一步是打字练习词典配置的核心前端的词库列表就是读这个文件渲染的{ id: my_dict, // 全局唯一 name: 我的词库, description: 自整理高频错词, category: 编程, // 从已有分类中挑选 url: /dicts/my_dict.json, length: 120, language: en, },成功长什么样编辑器里该行无红色波浪线各字段都有值易踩的坑id不能与已有词条重复url必须带/dicts/前缀且与实际文件名完全一致。3. 跑脚本同步词条数运行项目自带的脚本它会读取 public/dicts/ 下每个 JSON 的真实词条数并写回索引文件node scripts/update-dict-size.js成功长什么样终端打印出处理的文件名索引里的length与词库实际词条数一致易踩的坑如果脚本在这一步抛出解析错误说明第 1 步的 JSON 没过关——回去修即可等于免费多了一次格式复查。4. 本地启动验证通过后提交 PRyarn install # 首次执行 yarn dev # 启动开发服务器然后用浏览器打开http://localhost:5173。成功长什么样✅词典列表中出现新词库名称、分类、词条数都对点进去练习显示的是你写的单词易踩的坑列表里能看到词库、但点进去报错多半是url问题——先在浏览器直接打开http://localhost:5173/dicts/my_dict.json能正常下载 JSON 说明路径没问题再回头查字段拼写。如果想让词库面向所有用户本地验证通过后提交 PR 即可。项目欢迎社区贡献审核通过后会随下个版本发布。导入后不生效按这张表自查高频现象先查什么怎么查词库不出现在词典列表索引记录是否写入、id是否唯一在src/resources/dictionary.ts中搜索你写的 id搜不到或出现两处都不对记录中的url是否可达浏览器直接访问http://localhost:5173/dicts/xxx.json返回 404 说明文件名或前缀写错点进词库提示格式错误JSON 结构是否合规确认顶层是数组、每个词条都有name与trans、无尾逗号与中文引号词条数为 0 或与真实值不符length字段是否更新重跑node scripts/update-dict-size.js跑通之后的两个延伸玩法打造主题词库系列按知识点拆分比如把Java 常用 APIRust 标准库类型各做成一份词库练习时按主题切换category和tags字段就是为这种组织方式准备的。配合听写模式巩固词库建好后可以从打字记忆切换到听写模式对备考高频词的巩固效果更好。下一步今天就建你的第一份词库 挑出最近拼错的 10~20 个单词写下 JSON按上面的四步跑一遍——第一份词库跑通后这套流程你就彻底掌握了。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
