安装开发环境(Windows)
推荐直接在 Windows 上开发:软件装在 Windows 里,命令在 Windows 终端(Windows Terminal)或 VS Code 的终端里执行,使用系统自带的 Windows PowerShell 5.1。
| 软件 | 干什么用 |
|---|---|
| Git for Windows | 提供 git 命令,用来管理代码版本 |
| Node.js 22 | 运行 JavaScript / TypeScript 程序 |
| pnpm | 下载和管理项目依赖 |
| MySQL | 数据库 |
| Memurai(Redis 兼容) | 缓存 |
| VS Code | 写代码的编辑器 |
已经验证的范围
Windows 11 + 自带的 Windows PowerShell 5.1 已经完整验证过:安装依赖、启动开发、初始化数据库、pnpm verify、全部测试和完整检查 pnpm ci:local 都能正常运行,不需要 WSL 或 Git Bash;在 cmd 命令提示符里也能安装依赖和运行 pnpm verify。验证时用的是 MySQL 8.4 和 Memurai 8.2。
还有几点限制:
- 没有创建文件符号链接(symlink,类似快捷方式)的权限时(没有开启“开发者模式”就是这种情况),少数检查符号链接防护的测试会自动跳过,不算失败;
- 把服务部署到 Windows 服务器,以及在 Windows 上发布 App 和小程序,还没有验证过。
1. 打开 PowerShell
Windows 11 自带 Windows 终端,在开始菜单里搜索并打开“终端”,选择 Windows PowerShell 标签页。Windows 10 如果没有 Windows 终端,可以在开始菜单里搜索并打开 Windows PowerShell。
你应该看到类似 PS C:\Users\你的用户名> 的提示符。输入下面的命令,按回车:
$PSVersionTable.PSVersion你应该看到 Major 为 5、Minor 为 1。后面的命令都在这个窗口里执行;日常开发不需要以管理员身份运行。
2. Git for Windows
- 打开 Git 官网,下载 Windows 版并安装;安装时保留让命令行和其他软件使用 Git 的选项;
- 装好后,关闭终端,再重新打开 PowerShell,让新安装的命令生效。
检查:
git --version你应该看到 git version 2.x.x.windows.x。
设置你的名字和邮箱:
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"成功时没有输出,再用 git config --global user.name 可以看到刚才填写的名字。
3. Node.js 22
- 打开 Node.js 官网,选择 22 版本的 Windows 安装包(
.msi),版本不能低于22.22.1,安装时保持默认选项; - 安装完成后,关闭终端,再重新打开 PowerShell。
先检查 Node.js:
node --version你应该看到 v22.xx.x,并且不低于 v22.22.1。
需要同时使用多个 Node 版本?
可以改用 nvm-windows(在 GitHub 上搜索 nvm-windows)。安装它之前,先在“设置 → 应用”里卸载上面安装的 Node.js;装好后执行 nvm install 22、nvm use 22(nvm use 可能会弹出管理员授权,点“是”)。
4. 允许运行脚本
Windows 客户端默认的执行策略禁止运行 .ps1 脚本;npm 全局安装的 pnpm 会提供 pnpm.ps1,不调整策略就可能无法运行。
在 PowerShell 里执行:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned如果询问是否更改执行策略,输入 Y,按回车。这允许本机生成的脚本运行,从网上下载的脚本仍需满足签名要求;CurrentUser 表示只影响当前用户,不需要管理员权限。详见 PowerShell 执行策略说明。
检查:
Get-ExecutionPolicy -Scope CurrentUser
npm --version你应该看到 RemoteSigned 和 npm 的版本号。
不想修改执行策略
也可以照仓库的做法用 npm 自带的 .cmd 入口:安装写 npm.cmd install -g pnpm@11.28.3,之后把命令里的 pnpm 写成 pnpm.cmd,见仓库的入门指南 · Windows。
5. pnpm
npm install -g pnpm@11.28.3
pnpm --version等安装成功后再执行第二行,你应该看到 11.28.3。
6. MySQL
- 打开 MySQL 下载页,进入 MySQL Community Server,选择 8.4 LTS 或更高版本,下载 Windows 的 MSI 安装包并安装;
- 安装结束后会打开 MySQL Configurator,按提示配置服务器,过程中会让你设置 root 用户的密码,请记下来;
- 在 MySQL Configurator 里把 MySQL 配置为 Windows 服务,并设置开机自动启动,记下服务名(MySQL 8.4 的默认服务名是
MySQL84,以实际安装为准); - 在同一个下载页单独下载并安装 MySQL Workbench,它是一个图形界面工具,后面建数据库时会用到。
检查:打开 MySQL Workbench,用 127.0.0.1、端口 3306、用户名 root 和刚才的密码连接本地数据库。能连上就说明 MySQL 正常运行。
SQL 在哪里执行?
后续教程中,Windows 用户在 MySQL Workbench 的查询窗口里粘贴 SQL,点击执行按钮。mysql 命令默认不在 Windows 的 PATH 里,不需要为了教程手动修改 PATH;也可以打开开始菜单里的 MySQL Command Line Client,输入 root 密码后执行 SQL。
7. Redis:安装 Memurai
Redis 官方没有 Windows 原生版本。Memurai 是兼容 Redis 的 Windows 原生软件,开发者版可以用于本机开发:
- 打开 Memurai 官网,下载 Memurai Developer 4.x 或以上版本并安装;
- 安装时选择作为 Windows 服务运行,保留默认的
6379端口。
需要兼容 Redis 7.0 或以上的版本
项目用到了 Redis 7.0 才支持的命令选项(比如登录时 PEXPIRE 的 NX、GT、XX 选项),验证码还用到了 GETDEL。请安装 Memurai 4.x 或以上版本;Memurai 3.x 和网上一些很旧的“Redis for Windows”(3.x、5.x 版本)不能用,登录会失败。
检查(在 PowerShell 里):
memurai-cli ping你应该看到 PONG。如果提示找不到命令,在文件资源管理器里打开 Memurai 的实际安装目录,在地址栏输入 powershell 并按回车,然后执行:
.\memurai-cli.exe ping你应该看到 PONG;这里的 .\ 表示运行当前目录里的程序。
再确认内存满时的处理方式(maxmemory-policy)。项目的任务队列把排队中的任务存在 Memurai 里,这一项必须是 noeviction(内存满时不删数据)。执行:
memurai-cli config get maxmemory-policy如果上面要用 .\memurai-cli.exe 才能运行,这里也一样,在 Memurai 安装目录里执行:
.\memurai-cli.exe config get maxmemory-policy你应该看到两行:maxmemory-policy 和 noeviction。如果第二行不是 noeviction,用记事本打开 Memurai 安装目录里的配置文件,加一行 maxmemory-policy noeviction 并保存,再在“服务”里重启 Memurai 服务(见下面的提示)。
启动或停止数据库和缓存
按 Win + R,输入 services.msc,按回车打开“服务”。找到安装时配置的 MySQL 服务和 Memurai 服务,右键选择启动或停止。检查时,它们的状态应为“正在运行”;服务名以实际安装为准。
8. VS Code
- 打开 VS Code 官网,下载 Windows 版并安装。安装时勾选“添加到 PATH”;
- 打开 VS Code,在左侧“扩展”中安装:Vue - Official、ESLint、Prettier - Code formatter,以及可选的 Chinese (Simplified) Language Pack;
- 菜单“终端 → 新建终端”,Windows 上默认使用 PowerShell。若不是 Windows PowerShell,按
Ctrl + Shift + P,执行Terminal: Select Default Profile,选择 Windows PowerShell,再新建一个终端。
你应该看到 PS 开头的提示符;用第 1 步的版本检查命令确认是 5.1。以后推荐在这里执行项目命令,写代码和看输出都在同一个窗口里。
最后检查一遍
在 PowerShell 里依次执行:
git --version
node --version
pnpm --version常见问题
报“无法加载文件 …pnpm.ps1,因为在此系统上禁止运行脚本”
执行第 4 步的 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned,确认后再运行 pnpm --version。如果 npm.ps1 报同样的错误,也用这个办法。如果提示策略被组织的组策略覆盖,需要联系学校或公司的电脑管理员。公司或学校的电脑不允许改策略时,改用 pnpm.cmd(见第 4 步的提示)。
安装后仍然提示找不到 git、node 或 pnpm
先关闭终端,再重新打开;如果用的是 VS Code,关闭并重新打开 VS Code。仍然找不到时,检查对应软件是否安装成功;Memurai 的命令还可以按第 7 步从安装目录运行。
MySQL Workbench 连不上,或 Memurai 没有返回 PONG
在“服务”里检查对应服务是否正在运行,再检查连接的端口和密码。后续教程里的数据库操作用 MySQL Workbench 执行。
全部装好了?下一步:第一次把项目跑起来。
可选:使用 WSL2
WSL2 是 Windows 的 Linux 子系统,可以让你在 Windows 里运行 Linux 开发环境。如果你已经熟悉 Linux,也可以选择它,但完成本教程不需要安装它。选择 WSL2 后,把项目和开发软件放在 Linux 环境里,后续命令照 macOS 那一栏执行;共用命令也在 Linux 终端里运行。Linux 的软件安装和服务管理方式与 macOS、Windows 都不同(例如常见问题里给 Mac 用的 brew services start … 在 Linux 上不能用),请参考所选发行版的说明。