Qwerty Learner 安装指南：3 条命令把单词记忆与打字训练跑起来
【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner
Qwerty Learner 是一款免费开源的单词记忆工具，它把英语单词背诵和键盘打字绑在一起训练：屏幕上给出一个单词，你靠敲键盘把它拼出来，拼对才算掌握。对每天坐在电脑前的人来说，这是顺手练打字速度和英语拼写两不误的路子。跟着这篇安装教程走一遍，你很快就能在浏览器里开练。
🚀 最快跑起来：3 条命令装好 qwerty-learner
只要环境就绪（下一节有核对方法），三步就能在浏览器里看到它跑起来。
第一条，克隆仓库并进入目录——这一步就是把 qwerty-learner 打字训练工具下载到本地：
git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner第二条，安装项目依赖，首次跑完要几分钟，属正常现象：
yarn install第三条，启动本地服务，然后把终端里打印出的地址（形如http://localhost:5173）丢进浏览器：
yarn start看到单词和统计面板，就说明装好了。
📦 环境准备清单：Node、Git、Yarn 三件套
开工前先确认机器上有这三样：
- NodeJS（推荐 LTS 版）：网页应用运行所依赖的运行时；
- Yarn：包管理器，负责把项目依赖装进本地；
- Git：版本控制工具，用来从仓库拉代码。
一条命令验证三件套是否就位：
node --version && yarn --version && git --version能各自输出版本号即可，例如 node 输出v20.11.0、yarn 输出1.22.19，就可以开工了。
🖥️ 分平台安装路径：Windows、macOS、Linux 怎么走
每个平台都有两条路：手动一步步执行，或跑一键脚本。脚本会自动帮你检测并补齐缺失的依赖，再装依赖、起服务，还会顺手打开浏览器。
Windows：PowerShell 手动四连 + 一键脚本
手动路径（在 PowerShell 里依次执行）：
git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner yarn install yarn start一键路径（进入scripts目录后执行）：
.\install.ps1提醒两点：Windows 下请用 PowerShell 而不是 CMD；脚本若走 winget 补装 Node，需要系统自带 winget（Win10/11 均有）。
macOS：终端手动四连 + 一键脚本
手动路径（在终端里依次执行）：
git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner yarn install yarn start一键路径（在项目根目录执行）：
bash scripts/install.sh脚本发现缺 Node 时会通过 Homebrew 自动安装；机器没有 Homebrew 的话，先手动装好 Node 和 Yarn，再走手动四连即可。
Linux：手动四连为主，脚本视环境而定
手动路径（在 shell 里依次执行，与 macOS 一致）：
git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner yarn install yarn start一键入口同为：
bash scripts/install.sh要说明的是：脚本的自动补装依赖 Homebrew，Linux 上通常没有 brew，所以建议先自己装好 Node 和 Yarn，再走手动流程，最稳。
🧰 内置脚本速览：scripts 目录里都有什么
scripts/ 里共 4 个文件、两组分工：pre-check.sh/pre-check.ps1只检查 Node、Git、Yarn 是否安装并报告版本，不做任何改动；install.sh/install.ps1则是一键安装，先检查、缺了就装，然后装依赖并启动。拿不准自己环境时，先跑一次 pre-check 就知道缺什么。
❓ 常见卡点与下一步
依赖安装很慢或报错多半是网络原因，把 registry 换成国内镜像再装一次：
yarn config set registry https://registry.npmmirror.com yarn install端口 5173 被占用Vite 会自动切换下一个可用端口，照抄终端里新打印的地址就行，不用手动改配置。
接下来可以做的：启动后在页面顶部选词库——内置词库相当多，CET-4/6、IELTS、GRE、日语 N1 等都在，选好点 Start 就能开练。想扩充自己的词库，流程写在 docs/CONTRIBUTING.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），仅供参考
