把私有词表搬进 Qwerty Learner：自定义词典导入实操指南
【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner
手里有一份 2000 词的 API 速记表，想丢进 Qwerty Learner 里练打字。自定义词典导入走通后，这份私有词表就会出现在词库列表里，随时开练。
词典被"看见"的两层机制
让词典出现在界面里，得同时满足两层。public/dicts/下的 JSON 文件是数据层，存放词条本身；src/resources/dictionary.ts是注册层，告诉程序去哪加载、展示成什么样子。两层都齐了，词典才会显示出来。
JSON 就是一个数组，每个词条至少带name和trans：
[ { "name": "file", "trans": ["n. 档案, 文件"] }, { "name": "command", "trans": ["n. 命令, 指挥"] } ]导入五步走：从克隆到在列表里看见它
- 克隆仓库到本地，后面所有改动都只发生在你的本地副本里：
git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner整理词表 JSON。把源词表整理成上面的格式，存到
public/dicts/your_dict.json，编码选 UTF-8。Excel、纯文本这类源文件，截前几行丢给 AI 描述目标结构，让它帮你批量转格式，再抽查几行就行。注册词典条目。打开
src/resources/dictionary.ts，找到目标分类对应的数组，仿照邻近词条写一条。id得全局唯一，category决定它挂在哪个标签下，language与languageCategory控制发音方式，length先填个大概，第 4 步自动修正：
{ "id": "mydict", "name": "我的词库", "description": "日常工作高频词汇", "category": "代码练习", "tags": ["日常"], "url": "/dicts/your_dict.json", "length": 1200, "language": "code", "languageCategory": "code" }- 自动校正词量。跑一遍下面的脚本，它扫描
public/dicts/下全部 JSON，把真实词条数写回dictionary.ts的length，不用手动数词：
node scripts/update-dict-size.js- 启动验证。装依赖、起开发服务，打开 http://localhost:5173，在词库列表里找到自己的条目，导入就成了 🎉：
yarn install && yarn dev三种场景的字段取值差异
注册项里哪些字段跟着用途变，对照这张表填：
| 字段 | 编程 API 词库 | 非英语语种词库 | 考试备考词库 |
|---|---|---|---|
name | 方法名或关键字 | 原词 | 单词 |
trans | 参数说明、用法 | 释义 | 释义 |
language | code | 对应枚举（ja、de、id等） | en |
languageCategory | code | 对应枚举（ja、de等） | en |
category | 代码练习 | 对应语种分类 | 现有考试类分类 |
tags | 语言或框架，如JavaScript | 等级，如N2 | 识别度高的标签，如考研 |
非英语词库的取值清单以src/typings/index.ts里的类型定义为准，发音方式会跟着语言自动切换。
列表里没有？对号入座
- 列表里找不到词典→ 只放了 JSON 没注册 → 到
dictionary.ts补条目，重启 dev 服务。 - 词量显示不对→
length还是手填值 → 重跑一次scripts/update-dict-size.js。 - 页面报 JSON 解析错→ 编码非 UTF-8 或末尾多了逗号 → 转存 UTF-8，丢进 JSON 校验工具定位。
三个让体验更顺的习惯
- 补上音标字段。词条里加
usphone、ukphone，练习界面直接显示音标，背词顺带记读音。 - 控制单册规模。1000~3000 词一册节奏最舒服；超过五千词，拆成几册分别注册。
- 复用现有分类。词库和考试沾边就归进现有考试分类，别随手造新标签，列表不容易乱。
词表在手，动手导入你的第一册自定义词典，更多格式细节见 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），仅供参考
