企业官网建设流程全解析

Qwerty Learner：免费开源打字练习工具，5 分钟跑通

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

Qwerty Learner 是一个免费的开源打字练习工具，边打单词边记释义，顺带练出英文键盘肌肉记忆。读完本文，你把它跑在本地，并知道怎么换词库、开听写、查练习数据。

🚀 跑起来（≤5 分钟）

前置依赖只有三个，用对应命令检查版本即可：

缺什么就先装什么，也可以直接跑项目自带的预检查脚本：macOS/Linux 用 scripts/pre-check.sh，Windows 用 scripts/pre-check.ps1，缺失的依赖会自动帮你安装。不想一条一条敲命令的话，Windows 上执行 scripts/install.ps1、macOS 上执行 scripts/install.sh 可以一键装依赖并启动。手动方式的完整命令是：

git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner yarn install yarn start

启动后在浏览器打开 http://localhost:5173/ 就是主界面。

⌨️ 它能帮你做什么

选词库，开始打字练习

触发：打开主界面。

操作：

1. 在词库列表里挑一个词库，内置 380 多个，从人教版小学、CET-4 到 GRE、雅思，以及程序员常用词都有
2. 进入章节，点击开始
3. 直接键入当前单词，打对才进入下一个

结果：单词上方同时显示音标和释义，底部状态栏实时显示时间、速度（WPM）、正确率和输入字数。单词打错后需要把整个单词重新输入，这是刻意设计，避免形成"边删边凑"的肌肉记忆。

章节完成后开听写

触发：某个章节的单词全部打完。

操作：

1. 完成章节后，界面会弹出是否默写本章的选项
2. 选择默写
3. 凭记忆逐个输入本章单词

结果：本章单词按顺序重新出现，拼全对才算过，适合把刚背完的章节立刻固化一遍，默写期间的速度、正确率同样计入统计。

用编程 API 词库练手

触发：你是写代码的，想顺手练熟常用 API 名。

操作：

1. 在词库列表选择 JavaScript、Java、Python、Linux 命令等 API 类词库
2. 按普通单词流程练习即可

结果：反复键入addEventListener、HashMap这类名字，参数和方法名敲到不用想。

看统计，回看错词

触发：积累了一定练习量。

操作：

1. 进入分析页面，查看近一年的练习热力图、WPM 趋势、正确率趋势，以及按键错误次数排行
2. 进入错词本，按错误次数排序查看打错的单词

结果：你能看出自己最容易按错的键是哪个、哪些词反复出错，错词本里的单词可以整本导出带走。

🔧 深入一层

做自己的词库。内置词库覆盖不到的领域可以自己加：把单词整理成name（单词）加trans（释义）的 JSON 数组，放到 public/dicts/ 目录，再到 src/resources/dictionary.ts 里补一条包含 id、name、url 的索引记录，重启后新词库就会出现在列表里。格式细节以 docs/toBuildDict.md 为准。

导出学习数据。练习记录存在本地浏览器里，不会上传。导出和导入的实现都在 src/utils/db/data-export.ts，换电脑或想留一份备份时可以照这个逻辑走。

发音与音效设置。练习页的设置里可以切换美式/英式发音、开关按键音效，public/sounds/key-sound/ 目录里还有 Topre、Cherry MX 等十几种键声音源可选。

⚠️ 别踩这些坑

在旧版 Windows 上指望一键脚本装完→ install.ps1 依赖 winget，只有 Windows 10 1709（版本 16299）及以上支持；不支持的系统改用git clone+yarn install的手动路线。macOS 的 install.sh 同理，跑之前先确认终端里brew可用。

把 JSON 文件丢进 public/dicts/ 就认为词库加好了→ 应用按索引找词库，只放文件不加索引，词库列表里不会显示它，必须同步在 src/resources/dictionary.ts 登记。

打错字母就退格一个个改→ 设计上单词打错需要整词重输，保证肌肉记忆建立在正确输入上；打错时放慢节奏把整个词重打一遍，比边删边凑更能形成正确的指法习惯。

接下来

• 想加自己的词库，按 docs/toBuildDict.md 里的文件格式和索引步骤做，可以先从 100 词的小词库开始
• 参与开发前读一下 docs/CONTRIBUTING.md 里的贡献约定
• 每次跑之前不确定环境有没有问题，执行一遍 scripts/pre-check.sh（macOS/Linux）或 scripts/pre-check.ps1（Windows）

词库索引文件 src/resources/dictionary.ts 是所有词库的入口，从它出发改词库分类、排序都很快。

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