部署前的准备工作，直接决定后续能不能一次成功！本章按「前置自检→工具下载→分系统环境→报错速解」的逻辑梳理，只留核心要点。

一、前置7项硬核自检

1. 硬件要求

项目	最低要求	推荐配置
内存	2GB	4GB+
硬盘	1GB空闲	10GB+（SSD优先）
CPU	x64双核	无特殊要求

检查方法： 右键「此电脑」→「属性」查看内存和磁盘空间。

2. 系统版本

Windows： 10/11 64位（专业版/企业版支持Hyper-V，家庭版用WSL2）

MacOS： 13+（Ventura及以上，Intel/M1/M2/M3均支持）

Linux： Ubuntu 22.04 LTS及以上（推荐）

3. Hyper-V开启（Windows专业版）

方法一（图形化）： 设置 → 系统 → 高级 → 虚拟工作区，勾选全部Hyper-V选项，重启。

方法二（命令行）：

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

4. WSL2安装（Windows家庭版必做）

wsl --install
wsl --set-default-version 2

5. 系统权限

Windows需使用管理员账号，终端/PowerShell右键选择「以管理员身份运行」。

6. 端口检查

确保18789端口未被占用：

netstat -ano | findstr :18789

7. NVM和Node.js

Windows安装NVM：

winget install Core JairSampedro.NVMforWindows
nvm install lts
nvm use lts

验证安装：

node -v
npm -v

二、官方安装方式对比

方式	优点	缺点	推荐场景
Docker	隔离性强，官方推荐	需要Docker基础	新手首选
npm全局安装	简单直接	可能依赖冲突	有经验用户
源码安装	最新功能	配置复杂	开发者

三、常见报错速解

报错信息	解决方案
EACCES permission denied	使用管理员权限运行
Port 18789 already in use	关闭占用端口的进程
WSL2 not installed	运行 wsl --install
node: command not found	重启终端或检查PATH

下一章我们将进入Docker一键部署实操环节。