用 Scoop 快速部署 JeecgBoot 开发环境:从依赖安装到服务管理
JeecgBoot 是一款基于 Spring Boot + Vue 的快速开发平台,搭建其开发环境需要配置 MySQL、Redis、Maven 等依赖。本文将介绍如何通过 Scoop(Windows 包管理工具)一键安装所有依赖,并完成服务配置、镜像加速及环境清理,让你快速投入开发。
一、准备工作:安装 Scoop
若尚未安装 Scoop,先以 管理员身份打开 PowerShell,执行以下命令安装:
# 允许执行脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force# 安装 Scoop
irm get.scoop.sh | iex
安装完成后,验证是否成功:
scoop --version
二、安装 JeecgBoot 依赖项
JeecgBoot 运行依赖如下(参考官方文档):

通过 Scoop 可一键安装所有工具,无需手动配置环境变量。
1. 安装 JDK
JeecgBoot 推荐使用 JDK 11 或 17,这里以 Temurin 为例(开源免费且兼容性优异):
# 安装 JDK 11
scoop install temurin11-jdk# 验证安装结果
java -version # 输出 Java 版本信息即表示安装成功
关于通过 Scoop 实现 Java 多版本管理的详细操作,可参考我的另一篇文章:
《使用 scoop 一键安装 Java 并进行多版本切换——告别繁琐步骤,一行命令行命令搞定》
4. 安装 Maven
用于构建 JeecgBoot 后端项目的依赖管理工具:
# 安装 Maven
scoop install maven# 验证安装结果
mvn -version # 输出 Maven 版本及配置信息即成功
Maven 镜像加速
修改 Maven 配置文件 settings.xml(Scoop 安装路径:C:\Users\<你的用户名>\scoop\apps\maven\current\conf\settings.xml),在 <mirrors> 标签内添加阿里云镜像:
<mirror><id>aliyunmaven</id><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>*,!jeecg,!jeecg-snapshots</mirrorOf></mirror></mirrors>
3. 安装 MySQL(或 MariaDB)
JeecgBoot 需要 MySQL 数据库存储业务数据,此处以 MariaDB 为例(作为 MySQL 的分支,兼容性更佳):
# 安装 MariaDB
scoop install mariadb
注册并启动服务
# 注册为 Windows 服务(仅首次配置时需要)
mysqld --install MariaDB# 启动服务
net start MariaDB# 验证服务状态(返回“正在运行”即成功)
sc query MariaDB
初始化数据库(首次使用)
# 登录数据库(默认无密码,直接按回车即可)
mysql -u root -p# 设置 root 密码(将“你的密码”替换为实际密码)
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的密码';
FLUSH PRIVILEGES;# 创建 JeecgBoot 专用数据库(指定 UTF-8 编码)
CREATE DATABASE jeecgboot CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
EXIT; # 退出数据库命令行
MySQL 连接优化(可选)
若连接数据库时出现中文乱码,修改 MariaDB 配置文件 my.ini(安装目录下),添加:
[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
重启服务生效:
net stop MariaDB
net start MariaDB
4. 安装 Redis
JeecgBoot 使用 Redis 处理缓存和会话管理,安装及配置步骤如下:
# 安装 Redis
scoop install redis
启动服务
# 切换到 Redis 安装目录
cd ~\scoop\apps\redis\current# 指定配置文件启动服务(保持窗口开启以维持服务运行)
redis-server.exe redis.conf# 验证服务可用性(新窗口执行,返回 PONG 即表示成功)
redis-cli.exe ping
5. 安装 Node.js 及 Yarn
JeecgBoot 前端基于 Vue 开发,需 Node.js 环境支持,同时推荐使用 Yarn 作为包管理工具提升依赖安装效率:
# 安装 Node.js(包含 npm 包管理工具)
scoop install nodejs# 验证 Node.js 和 npm 安装结果
node -v
npm -v
安装完成后,建议配置 npm 镜像加速(优化国内网络环境下的依赖下载速度):
npm config set registry https://registry.npmmirror.com
安装 Yarn 包管理工具
# 使用 npm 全局安装 Yarn
npm install -g yarn# 验证 Yarn 安装结果
yarn -v
配置 Yarn 镜像加速
# 设置 Yarn 镜像源为国内镜像
yarn config set registry https://registry.npmmirror.com
Yarn 相比 npm 具有依赖安装更快、缓存机制更优的特点,后续前端项目可通过 yarn install 安装依赖,yarn dev 启动开发服务,与 JeecgBoot 前端工程适配性更佳。
三、部署 JeecgBoot 项目
完成依赖环境配置后,即可开始部署 JeecgBoot 项目,具体步骤如下:
1. 拉取项目代码
通过 Git 克隆官方仓库:
# 克隆代码到本地
git clone https://gitee.com/jeecg/jeecg-boot.git# 进入项目根目录
cd jeecg-boot
然后使用 IDE 打开项目,以下为基于 IntelliJ IDEA 的图形化配置流程。
2. 配置数据库连接
步骤1:添加数据库连接
在 IDEA 右侧边栏打开「Database」面板,点击「+」号添加数据库:

选择 MySQL 数据库类型,填入连接信息,测试连接通过后点击「OK」。
步骤2:执行初始化 SQL
在数据库面板中找到对应 SQL 文件,按照提示,选择数据库并执行:


3. 启动后端服务
修改编译器版本
将 Settings --> Build, Execution, Deployment --> Complier --> Java Complier 配置下的 Project bytecode version 改为 与 项目使用的 JDK 版本一样。
避免报错:【无效的目标发行版:17】

启动后端服务
-
关联 Maven 项目:
在项目目录中找到jeecg-boot/jeecg-module-system/pom.xml,右键选择「Add as Maven Project」,IDEA 会自动加载依赖。 -
运行主类:
定位到启动类JeecgSystemApplication.java(路径:jeecg-boot/jeecg-module-system/jeecg-system-start/src/main/java/org/jeecg/JeecgSystemApplication.java),右键点击该类的代码编辑区域(而非在文件列表中右键),此时会弹出包含 Run 选项的菜单,点击 Run [类名] 即可运行。

4. 启动前端服务
前端基于 Vue 开发(以 jeecgboot-vue3 为例),需先安装依赖再启动:
# 进入前端项目目录(根据实际目录调整)
cd jeecgboot-vue3# 安装前端依赖
yarn install# 启动开发环境(默认端口 3000)
yarn dev
提示:若依赖安装缓慢,可使用国内镜像加速:
yarn install --registry=https://registry.npmmirror.com
常见问题排查
- 后端启动失败:检查 MySQL 和 Redis 服务是否已启动,数据库密码是否与配置一致。
- 前端启动报错:删除
jeecg-ui/node_modules目录后重新执行yarn install,确保 Node.js 版本 ≥ 14.x。 - 接口调用失败:检查前端配置文件
jeecg-ui/.env.development中的VUE_APP_BASE_API是否指向后端地址(默认http://localhost:8080/jeecg-boot)。
总结
通过 Scoop 可以标准化、自动化安装 JeecgBoot 所需的所有依赖,避免手动配置环境变量和服务的繁琐。配合镜像加速,能大幅提升依赖下载速度,让你专注于项目开发而非环境搭建。如需迁移或清理环境,Scoop 的卸载命令也能确保残留文件被彻底删除,保持系统整洁。
