# 2.1 开发环境准备

:::tip 概述
本页列出本地开发所需的软件与版本基线。Redis 为可选依赖——连接失败时缓存自动降级内存模式，不影响启动。
:::

## 版本要求

| 软件 | 版本要求 | 用途 |
|---|---|---|
| Go | 1.27+ | 后端编译运行 |
| Node.js | 18+ | 前端构建 |
| pnpm | 任意近期版本 | 前端包管理 |
| MySQL | 8.0+ | 默认数据库 |
| Redis | 7.x（可选） | 缓存；不装则降级内存 |
| make | 任意（Windows 可用 make.bat） | 命令入口 |

Windows 未安装 make 时，所有 `make <目标>` 命令等价替换为 `make.bat <目标>`，两者目标一致。

## 安装 pnpm（如未安装）

```bash
npm install -g pnpm
```

## 验证环境

```bash
go version      # 期望 go1.27+
node -v         # 期望 v18+
pnpm -v
mysql --version # 8.0+
```

## 可选组件

| 组件 | 说明 |
|---|---|
| Redis | 生产建议安装；开发期缺失时 cache.Init 探测失败自动降级内存并输出告警 |
| Docker | 用于 [2.7 Docker 快速体验](/zh/quickstart/docker.html)，可一键拉起全套依赖 |
| IDE | 后端推荐 GoLand / VS Code + Go 扩展；前端推荐 VS Code + Volar |

## 目录准备

```bash
# 获取代码后进入项目根目录
cd EasyGoAdmin_Gin_EleVue

# 前端依赖安装
cd ui
pnpm install
cd ..
```

## 下一步

→ [2.2 数据库初始化](/zh/quickstart/database-init.html)