Node.js 与 pnpm 安装准备

Forge Admin 前端需要 Node.js 20+ 和 pnpm 8+。推荐使用 nvm 管理 Node.js 版本。

安装 nvm（Node Version Manager）

使用 nvm 可以在同一台机器上安装和切换多个 Node.js 版本。

macOS / Linux

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载 shell 配置
source ~/.zshrc  # 或 ~/.bashrc

# 安装 Node.js 20 LTS
nvm install 20
nvm use 20
nvm alias default 20

Windows

下载安装 nvm-windows，然后：

nvm install 20
nvm use 20

安装 pnpm

# 使用 npm 全局安装（推荐）
npm install -g pnpm

# 或使用 corepack（Node.js 16.9+ 内置）
corepack enable
corepack prepare pnpm@latest --activate

验证安装

# 验证 Node.js
node -v
# 期望输出: v20.x.x

# 验证 npm（随 Node.js 附带）
npm -v

# 验证 pnpm
pnpm -v
# 期望输出: 9.x.x 或 8.x.x

配置 pnpm 国内镜像（可选）

如果你在国内，建议配置 pnpm 使用阿里云镜像加速：

# 设置淘宝镜像
pnpm config set registry https://registry.npmmirror.com

版本要求说明

组件	最低版本	推荐版本	说明
Node.js	20	20 LTS	Vite 7 最低要求
pnpm	8	9	替代 npm，节省磁盘空间

下一步

继续安装 MySQL 与 Redis 准备。