环境要求总览
在安装 Forge Admin 之前，请确保你的开发环境满足以下要求。
总体要求一览
| 组件 | 最低版本 | 用途 | 是否必须 |
|---|---|---|---|
| 操作系统 | macOS / Windows / Linux | 开发/运行环境 | ✓ |
| JDK | 17 | 后端编译与运行 | ✓ |
| Maven | 3.8+ | 后端依赖管理与构建 | ✓ |
| Node.js | 20+ | 前端构建工具链 | ✓ |
| pnpm | 8+ | 前端包管理 | ✓ |
| MySQL | 8.0+ | 业务数据持久化 | ✓ |
| Redis | 6.0+ | 缓存、Session、分布式锁 | ✓ |
为什么需要这些组件
JDK 17 — Forge Admin 后端基于 Spring Boot 3.2 构建，最低要求 JDK 17。代码中使用了 Java 17 的语言特性（Record、Pattern Matching 等）。
Maven — 后端采用多模块 Maven 项目结构，Maven 负责依赖管理、编译和打包。forge-framework/forge-dependencies 提供统一的 BOM 版本管理。
Node.js 20 + pnpm — 前端基于 Vite 7 构建，要求 Node.js 20+。pnpm 是推荐的包管理器，性能优于 npm 和 yarn。
MySQL 8.0 — 数据存储引擎，要求 utf8mb4 字符集和 InnoDB 引擎。所有业务表包含 id、tenant_id、create_time 等标准字段。
Redis 6.0 — 提供多层缓存能力：接口缓存、数据缓存、会话管理（Sa-Token）、分布式锁（Redisson）。
下一步
根据你的操作系统，选择对应的安装指南：