如何把自定義詞典導(dǎo)入 Qwerty Learner從零到跑起來的完整指南【免費(fèi)下載鏈接】qwerty-learner為鍵盤工作者設(shè)計(jì)的單詞記憶與英語肌肉記憶鍛煉軟件 / Words learning and English muscle memory training software designed for keyboard workers項(xiàng)目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerQwerty Learner 是一款為鍵盤工作者打造的單詞記憶與英語肌肉記憶訓(xùn)練工具通過打字練習(xí)幫你把詞匯刻進(jìn)手指。本文帶你從零完成自定義詞典導(dǎo)入10 分鐘讓專屬詞庫投入練習(xí)。什么場景下需要自己的詞庫項(xiàng)目自帶的詞庫覆蓋了幾百種場景從四級(jí)、雅思到編程語言關(guān)鍵字全部放在 public/dicts/ 目錄里。但如果你要背的內(nèi)容是行業(yè)術(shù)語、內(nèi)部產(chǎn)品詞或某份定制考綱預(yù)設(shè)詞庫大概率不夠用。這時(shí)你可以準(zhǔn)備一份自己的 JSON 詞典導(dǎo)入后它會(huì)像內(nèi)置詞庫一樣出現(xiàn)在選擇界面按分類和章節(jié)供你點(diǎn)擊 Start 開始打字練習(xí)。準(zhǔn)備詞典 JSON 文件的正確字段每個(gè)單詞是一個(gè)對(duì)象整個(gè)文件是由這些對(duì)象組成的數(shù)組。字段如下字段作用是否必填name單詞本體即你要打出來的內(nèi)容是trans釋義數(shù)組可放多條詞性與解釋是usphone美式音標(biāo)是ukphone英式音標(biāo)是notation備注說明否文件請用 UTF-8 編碼保存。驗(yàn)證動(dòng)作把內(nèi)容粘貼到任意在線 JSON 校驗(yàn)器或本地 JSON 解析中跑一遍不報(bào)錯(cuò)且能解析出對(duì)象數(shù)組這一步才算通過。放置詞典文件到正確目錄把文件放進(jìn)public/dicts/目錄即可命名隨意但必須以.json結(jié)尾例如public/dicts/my_terms.json。這一步只放文件界面還不會(huì)自動(dòng)出現(xiàn)它。在索引文件中注冊詞典條目詞典列表不是掃描目錄自動(dòng)生成的你需要在 src/resources/dictionary.ts 里追加一條記錄字段含義字段說明id唯一標(biāo)識(shí)不能與現(xiàn)有詞典重復(fù)name界面展示的詞典名description詞典描述文案category分類建議沿用已有分類方便歸入現(xiàn)有標(biāo)簽頁url指向剛放入的 .json 文件路徑length單詞數(shù)量language / languageCategory語言標(biāo)記決定出現(xiàn)在哪個(gè)語言標(biāo)簽下驗(yàn)證動(dòng)作url路徑與磁盤上的真實(shí)文件一一對(duì)上length可運(yùn)行 scripts/update-dict-size.js 自動(dòng)統(tǒng)計(jì)避免手填錯(cuò)。啟動(dòng)項(xiàng)目確認(rèn)詞典出現(xiàn)在倉庫根目錄執(zhí)行g(shù)it clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner yarn install yarn dev然后訪問http://localhost:5173。打開詞典選擇界面能看到你剛登記的詞典卡片名稱、詞數(shù)、分類都正確就表示導(dǎo)入成功。? 接著點(diǎn)進(jìn)該詞典、按 Start 敲幾個(gè)單詞確認(rèn)釋義與發(fā)音顯示正常整條鏈路就算徹底跑通。詞典不顯示時(shí)的排查順序按命中率從高到低依次檢查通常前三項(xiàng)就能定位問題JSON 能否解析——多逗號(hào)、缺引號(hào)、中文引號(hào)混入都會(huì)導(dǎo)致整份詞典被靜默跳過文件位置與擴(kuò)展名——確認(rèn)在public/dicts/下且以.json結(jié)尾編碼為 UTF-8url 是否指向真實(shí)文件——索引里寫的路徑和磁盤路徑差一個(gè)/或大小寫都會(huì)失效id 是否重復(fù)——重復(fù) id 可能讓條目被去重丟掉。進(jìn)階拆分大詞典與社區(qū)共建單詞量過大數(shù)千詞以上時(shí)考慮拆成多份文件分章節(jié)練習(xí)單次目標(biāo)更聚焦詞庫內(nèi)容增刪后重新運(yùn)行scripts/update-dict-size.js同步 length 字段想讓詞庫惠及更多人可以參照 docs/toBuildDict.md 了解社區(qū)詞典的共建流程把你的詞庫提交給項(xiàng)目。一條 JSON 文件加一行索引注冊就能讓 Qwerty Learner 為你量身定制練習(xí)內(nèi)容——現(xiàn)在就可以克隆源碼把你手頭的第一份詞庫放進(jìn)去試試?！久赓M(fèi)下載鏈接】qwerty-learner為鍵盤工作者設(shè)計(jì)的單詞記憶與英語肌肉記憶鍛煉軟件 / Words learning and English muscle memory training software designed for keyboard workers項(xiàng)目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考