5分钟跑通Qwerty Learner新手完整部署手册【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerQwerty Learner 是一款把单词记忆和英语打字肌肉记忆训练结合的开源工具背单词的同时用键盘实拼解决提笔忘字和英语输入卡顿的痛点。这份部署手册覆盖环境自检、依赖安装到启动验证照做 5 分钟就能在浏览器里开始练习。2分钟环境自检项目基于 React Vite 开发运行只依赖 Node.js 环境。打开终端执行node --version git --version yarn --version三条命令都能输出版本号即可开工缺哪样Windows 走 winget、macOS 走 Homebrew 补装。也可以直接跑仓库自带的自检脚本它会检测并自动安装缺失组件Windows 依赖 wingetmacOS 依赖 brew./scripts/pre-check.sh 脚本路径在scripts/目录下Windows 对应pre-check.ps1。三步跑起来拉代码、装依赖、启服务第一步获取代码git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner要完整克隆仓库因为public/dicts/下内置了 CET-4/6、GRE、雅思、程序员 API 等大量词库缺了就没法正常练习。第二步安装依赖yarn install这一步会装齐 React 全家桶和构建工具链。网络慢的话可配置 npm 镜像源仓库的一键脚本用的就是国内镜像。第三步启动服务yarn startWindows 用户可以省掉后两步在 PowerShell 里执行.\scripts\install.ps1一键装依赖并启动macOS/Linux 对应./scripts/install.sh。确认部署成功首启该看到什么Vite 启动后浏览器打开http://localhost:5173/能看到左侧词库选择、中间单词拼写输入区、底部速度统计的主界面即部署成功。打不开时先看终端输出5173 被占用时 Vite 会自动跳到下一个端口以终端打印的地址为准。环境层面仍有问题参考 README.md 的运行项目章节逐条比对。4个高频坑位速查终端提示node: command not found原因Node.js 未安装或未加入 PATH。 解决winget install OpenJS.Nodejs或brew install node然后重开终端。提示 5173 端口被占用原因其他服务占着端口。Vite 会自动换端口直接打开终端里的新地址。 手动排查macOS/Linux 用lsof -i :5173Windows 用netstat -ano | findstr :5173。yarn install中途报错失败原因网络中断或本地缓存损坏。 解决yarn cache clean yarn install清缓存重装。浏览器打开白屏原因缓存旧资源或 dev server 未完全就绪。 解决CtrlShiftR 强刷仍不行就 CtrlC 停掉服务重新yarn start。⚠️ 词库导入、数据结构等进阶细节以仓库实际内容为准README、导入词典指南。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
