用 Scoop 快速部署 JeecgBoot 开发环境：从依赖安装到服务管理

JeecgBoot 是一款基于 Spring Boot + Vue 的快速开发平台，搭建其开发环境需要配置 MySQL、Redis、Maven 等依赖。本文将介绍如何通过 Scoop（Windows 包管理工具）一键安装所有依赖，并完成服务配置、镜像加速及环境清理，让你快速投入开发。

一、准备工作：安装 Scoop

若尚未安装 Scoop，先以 管理员身份打开 PowerShell，执行以下命令安装：

powershell 复制代码

# 允许执行脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

# 安装 Scoop
irm get.scoop.sh | iex

安装完成后，验证是否成功：

powershell 复制代码

scoop --version

二、安装 JeecgBoot 依赖项

JeecgBoot 运行依赖如下（参考官方文档）：

通过 Scoop 可一键安装所有工具，无需手动配置环境变量。

1. 安装 JDK

JeecgBoot 推荐使用 JDK 11 或 17，这里以 Temurin 为例（开源免费且兼容性优异）：

powershell 复制代码

# 安装 JDK 11
scoop install temurin11-jdk

# 验证安装结果
java -version  # 输出 Java 版本信息即表示安装成功

关于通过 Scoop 实现 Java 多版本管理的详细操作，可参考我的另一篇文章：
《使用 scoop 一键安装 Java 并进行多版本切换------告别繁琐步骤，一行命令行命令搞定》

4. 安装 Maven

用于构建 JeecgBoot 后端项目的依赖管理工具：

powershell 复制代码

# 安装 Maven
scoop install maven

# 验证安装结果
mvn -version  # 输出 Maven 版本及配置信息即成功

Maven 镜像加速

修改 Maven 配置文件 settings.xml（Scoop 安装路径：C:\Users\<你的用户名>\scoop\apps\maven\current\conf\settings.xml），在 <mirrors> 标签内添加阿里云镜像：

xml 复制代码

    <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 的分支，兼容性更佳）：

powershell 复制代码

# 安装 MariaDB
scoop install mariadb

注册并启动服务

powershell 复制代码

# 注册为 Windows 服务（仅首次配置时需要）
mysqld --install MariaDB

# 启动服务
net start MariaDB

# 验证服务状态（返回"正在运行"即成功）
sc query MariaDB

初始化数据库（首次使用）

powershell 复制代码

# 登录数据库（默认无密码，直接按回车即可）
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（安装目录下），添加：

ini 复制代码

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci

重启服务生效：

powershell 复制代码

net stop MariaDB
net start MariaDB

4. 安装 Redis

JeecgBoot 使用 Redis 处理缓存和会话管理，安装及配置步骤如下：

powershell 复制代码

# 安装 Redis
scoop install redis

启动服务

powershell 复制代码

# 切换到 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 作为包管理工具提升依赖安装效率：

powershell 复制代码

# 安装 Node.js（包含 npm 包管理工具）
scoop install nodejs

# 验证 Node.js 和 npm 安装结果
node -v
npm -v

安装完成后，建议配置 npm 镜像加速（优化国内网络环境下的依赖下载速度）：

powershell 复制代码

npm config set registry https://registry.npmmirror.com

安装 Yarn 包管理工具

powershell 复制代码

# 使用 npm 全局安装 Yarn
npm install -g yarn

# 验证 Yarn 安装结果
yarn -v

配置 Yarn 镜像加速

powershell 复制代码

# 设置 Yarn 镜像源为国内镜像
yarn config set registry https://registry.npmmirror.com

Yarn 相比 npm 具有依赖安装更快、缓存机制更优的特点，后续前端项目可通过 yarn install 安装依赖，yarn dev 启动开发服务，与 JeecgBoot 前端工程适配性更佳。

三、部署 JeecgBoot 项目

完成依赖环境配置后，即可开始部署 JeecgBoot 项目，具体步骤如下：

1. 拉取项目代码

通过 Git 克隆官方仓库：

powershell 复制代码

# 克隆代码到本地
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 为例），需先安装依赖再启动：

powershell 复制代码

# 进入前端项目目录（根据实际目录调整）
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 的卸载命令也能确保残留文件被彻底删除，保持系统整洁。