环境安装

本文档指导你搭建直播电商管理系统的完整开发环境。

环境要求

基础依赖

依赖项	最低版本	推荐版本	说明
Java JDK	1.8	1.8 (LTS)	后端运行环境
MySQL	8.0	8.0.x	主数据库
Redis	6.0	6.x	缓存与会话管理
Node.js	16.0	18.x (LTS)	前端构建环境
Maven	3.6	3.9.x	Java 依赖管理
Git	2.30	最新	版本控制

可选依赖

依赖项	说明
Docker + Docker Compose	容器化一键部署（推荐体验环境）
HBuilderX	uni-app 官方 IDE，App/小程序调试
IntelliJ IDEA	Java 后端开发 IDE
VS Code	前端开发 IDE

安装步骤

1. Java JDK 8

Windows：

1. 下载 JDK 8（或 OpenJDK 8）
2. 安装并配置环境变量：

# 系统环境变量
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_xxx
PATH=%JAVA_HOME%\bin;%PATH%

3. 验证安装：

java -version
# 输出: java version "1.8.0_xxx"

2. MySQL 8.0

Windows：

1. 下载 MySQL 8.0 安装包
2. 安装时设置 root 密码（开发环境建议设为 123456，与项目默认配置一致）
3. 创建数据库：

CREATE DATABASE `ruoyi-vue-pro` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

4. 导入初始化 SQL：

mysql -u root -p ruoyi-vue-pro < sql/mysql/ruoyi-vue-pro.sql

初始化 SQL 文件位于后端项目 sql/mysql/ 目录下，包含完整的表结构和初始数据。

验证：

mysql -u root -p -e "SELECT VERSION();"
# 输出: 8.0.xx

3. Redis 6.x

Windows：

1. 下载 Redis for Windows
2. 启动 Redis 服务：

redis-server.exe redis.conf

macOS / Linux：

# 使用 Homebrew
brew install redis
brew services start redis

# 或使用 Docker
docker run -d --name redis -p 6379:6379 redis:6-alpine

验证：

redis-cli ping
# 输出: PONG

4. Node.js

1. 下载 Node.js 18.x LTS
2. 安装后验证：

node -v   # v18.x.x
npm -v    # 9.x.x

3. 建议使用 pnpm 作为包管理器（可选）：

npm install -g pnpm

5. Maven

1. 下载 Maven 3.9.x
2. 解压并配置环境变量：

MAVEN_HOME=C:\apache-maven-3.9.x
PATH=%MAVEN_HOME%\bin;%PATH%

3. 配置国内镜像加速（conf/settings.xml）：

<mirrors>
  <mirror>
    <id>aliyun</id>
    <mirrorOf>central</mirrorOf>
    <url>https://maven.aliyun.com/repository/central</url>
  </mirror>
</mirrors>

4. 验证：

mvn -v
# 输出: Apache Maven 3.9.x

6. Git

1. 下载 Git 并安装
2. 配置用户信息：

git config --global user.name "你的名字"
git config --global user.email "your@email.com"

Docker 一键部署（推荐）

如果你只是想快速体验系统，推荐使用 Docker Compose 一键启动所有服务：

# 进入 Docker 部署目录
cd script/docker

# 构建并启动所有服务
docker compose --env-file docker.env up -d

启动后各服务端口：

服务	地址
后端 API	http://localhost:48080
管理后台	http://localhost:8080
MySQL	localhost:3306（root/123456）
Redis	localhost:6379

详细 Docker 部署步骤参见 Docker 容器化 文档。

第三方服务配置

系统集成了以下第三方服务，开发前需要在管理后台配置相关参数：

服务	用途	配置位置
腾讯云 IM	即时通讯	字典管理 → im_settings
腾讯云直播	直播推拉流	字典管理 → 直播相关配置
阿里云 OSS	文件存储	基础设施 → 文件管理
阿里云快递 API	物流查询	application.yaml → yudao.trade.express
短信服务	验证码发送	系统管理 → 短信管理

下一步

环境准备就绪后，进入 快速开始 章节启动项目。