Qwerty Learner 安装部署教程5分钟跑通单词记忆与打字训练【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerQwerty Learner 把单词记忆和键盘打字训练合并在同一个练习界面里你看着单词逐个敲击它在后台同时统计你的速度、输入数与正确率。本文带你完成 Qwerty Learner 安装与部署——脚本、手动、Docker 三条路径任选其一5 分钟把应用跑起来附端口占用等常见问题的排查命令。图1装好后的首屏长这样确认右上角词库选择与底部统计面板是否齐全前置一步一条命令验完环境这一步解决动手之前先确认电脑上有什么。Qwerty Learner 是 Node 项目只需三样Node.jsLTS 版本、Git、Yarn。打开终端一条命令验完node -v git --version yarn -v 缺什么装什么macOS 用 Homebrewbrew install node git yarnWindows 用 winget。三条命令都输出版本号就可以进入下一章了。图2练习用的标准指法参考对照确认你的手指是否落在对应按键上三条安装路径怎么选跟哪份走这一步解决从哪儿开始动手。三条路径只选一条跑通即可脚本安装最快3-5 分钟适合大多数人的首次 Qwerty Learner 安装手动安装每步自己可控适合想看清依赖装了什么、或要换源的用户Docker 部署免装 Node适合部署到服务器或做演示环境。脚本安装。macOS / Linux 在项目根目录执行./scripts/install.shWindows 用 PowerShellcd scripts .\install.ps1脚本会自动检测并补齐缺失的依赖装完直接尝试打开浏览器。手动安装。四步走完git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner yarn install yarn start浏览器打开 http://localhost:5173 就能看到页面。图3确认左侧词库章节列表可正常加载、底部统计面板就绪再点 Start 开始Qwerty Learner Docker 部署两行命令起服务这一步解决不想在本机装 Node 环境怎么办。在仓库根目录执行docker build -t qwerty-learner . docker run -p 5173:5173 qwerty-learner容器内是 Nginx监听 5173 端口宿主同样映射到 5173起容器后直接访问 http://localhost:5173。项目根目录已备好 docker-compose.yaml也可以直接docker compose up它把端口映射到宿主机的 8990访问 http://localhost:8990 即可。⚠️ 5173 被开发服务器占用时Docker 方式请改映射端口别先杀开发进程。跑起来之后确认它真的在跑这一步解决页面打开了但怎么判断一切正常。打开 http://localhost:5173按图1对照四个点顶部是 Qwerty Learner 标识界面可正常渲染没有白屏中央显示第一个待拼写单词下方是释义右上角能切换词库与章节内置 CET-4/6、GRE、TOEFL 等还能切换发音方式底部是实时统计条时间、输入数、速度、正确数、正确率。点 Start开始逐词输入。底部数字开始跳动、正确率开始变化说明 Qwerty Learner 部署完整成功可以正式用了。卡住了怎么办端口占用、依赖失败、白屏这一步解决跑不起来时的自救。按现象对照执行端口被占用启动报错现象启动时提示 5173 端口已被占用。 命令macOS / Linux 执行lsof -i :5173Windows 执行netstat -ano | findstr :5173记下 PID 后执行kill -9 PIDWindows 用taskkill /PID PID /F。 验证重新执行yarn start能正常访问即恢复。依赖安装失败现象yarn install中途报错、依赖树不完整。 命令yarn cache clean yarn install。 验证install 正常结束yarn start后页面可访问。浏览器白屏现象地址栏能打开但一片空白。 命令rm -rf node_modules dist yarn install yarn startWindows 手动删除 node_modules 和 dist 目录后再装。 验证刷新浏览器图1界面出现即恢复。装完之后首次配置与进阶动作这一步解决跑通之后怎么把它调成自己的样子。环境变量。项目根目录新建.env文件可写入VITE_API_URLhttp://localhost:3000 VITE_DEFAULT_DICTIONARYCET4⚠️ 改完 .env 必须重启开发服务器才生效。数据备份与迁移。练习数据存在浏览器本地IndexedDB。需要备份或换机器时用应用内的数据导出功能拿到 JSON 文件换设备后再导入即可无需依赖命令行。开发模式。yarn dev与yarn start等价启动 Vite 开发服务器改动代码后页面热更新适合在本地二次开发。打开右上角设置面板挑一套词库、关掉发音试听、调好音量然后点 Start 完成你的第一次拼写练习。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/24 21:14:03 · 阅读 1.2k Qwerty Learner 安装部署教程：5分钟跑通单词记忆与打字训练
Qwerty Learner 安装部署教程5分钟跑通单词记忆与打字训练【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerQwerty Learner 把单词记忆和键盘打字训练合并在同一个练习界面里你看着单词逐个敲击它在后台同时统计你的速度、输入数与正确率。本文带你完成 Qwerty Learner 安装与部署——脚本、手动、Docker 三条路径任选其一5 分钟把应用跑起来附端口占用等常见问题的排查命令。图1装好后的首屏长这样确认右上角词库选择与底部统计面板是否齐全前置一步一条命令验完环境这一步解决动手之前先确认电脑上有什么。Qwerty Learner 是 Node 项目只需三样Node.jsLTS 版本、Git、Yarn。打开终端一条命令验完node -v git --version yarn -v 缺什么装什么macOS 用 Homebrewbrew install node git yarnWindows 用 winget。三条命令都输出版本号就可以进入下一章了。图2练习用的标准指法参考对照确认你的手指是否落在对应按键上三条安装路径怎么选跟哪份走这一步解决从哪儿开始动手。三条路径只选一条跑通即可脚本安装最快3-5 分钟适合大多数人的首次 Qwerty Learner 安装手动安装每步自己可控适合想看清依赖装了什么、或要换源的用户Docker 部署免装 Node适合部署到服务器或做演示环境。脚本安装。macOS / Linux 在项目根目录执行./scripts/install.shWindows 用 PowerShellcd scripts .\install.ps1脚本会自动检测并补齐缺失的依赖装完直接尝试打开浏览器。手动安装。四步走完git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner cd qwerty-learner yarn install yarn start浏览器打开 http://localhost:5173 就能看到页面。图3确认左侧词库章节列表可正常加载、底部统计面板就绪再点 Start 开始Qwerty Learner Docker 部署两行命令起服务这一步解决不想在本机装 Node 环境怎么办。在仓库根目录执行docker build -t qwerty-learner . docker run -p 5173:5173 qwerty-learner容器内是 Nginx监听 5173 端口宿主同样映射到 5173起容器后直接访问 http://localhost:5173。项目根目录已备好 docker-compose.yaml也可以直接docker compose up它把端口映射到宿主机的 8990访问 http://localhost:8990 即可。⚠️ 5173 被开发服务器占用时Docker 方式请改映射端口别先杀开发进程。跑起来之后确认它真的在跑这一步解决页面打开了但怎么判断一切正常。打开 http://localhost:5173按图1对照四个点顶部是 Qwerty Learner 标识界面可正常渲染没有白屏中央显示第一个待拼写单词下方是释义右上角能切换词库与章节内置 CET-4/6、GRE、TOEFL 等还能切换发音方式底部是实时统计条时间、输入数、速度、正确数、正确率。点 Start开始逐词输入。底部数字开始跳动、正确率开始变化说明 Qwerty Learner 部署完整成功可以正式用了。卡住了怎么办端口占用、依赖失败、白屏这一步解决跑不起来时的自救。按现象对照执行端口被占用启动报错现象启动时提示 5173 端口已被占用。 命令macOS / Linux 执行lsof -i :5173Windows 执行netstat -ano | findstr :5173记下 PID 后执行kill -9 PIDWindows 用taskkill /PID PID /F。 验证重新执行yarn start能正常访问即恢复。依赖安装失败现象yarn install中途报错、依赖树不完整。 命令yarn cache clean yarn install。 验证install 正常结束yarn start后页面可访问。浏览器白屏现象地址栏能打开但一片空白。 命令rm -rf node_modules dist yarn install yarn startWindows 手动删除 node_modules 和 dist 目录后再装。 验证刷新浏览器图1界面出现即恢复。装完之后首次配置与进阶动作这一步解决跑通之后怎么把它调成自己的样子。环境变量。项目根目录新建.env文件可写入VITE_API_URLhttp://localhost:3000 VITE_DEFAULT_DICTIONARYCET4⚠️ 改完 .env 必须重启开发服务器才生效。数据备份与迁移。练习数据存在浏览器本地IndexedDB。需要备份或换机器时用应用内的数据导出功能拿到 JSON 文件换设备后再导入即可无需依赖命令行。开发模式。yarn dev与yarn start等价启动 Vite 开发服务器改动代码后页面热更新适合在本地二次开发。打开右上角设置面板挑一套词库、关掉发音试听、调好音量然后点 Start 完成你的第一次拼写练习。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考