news 2026/6/22 21:30:11

JeecgBoot开发环境搭建全攻略：从零配置到项目启动

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
JeecgBoot开发环境搭建全攻略：从零配置到项目启动

1. JeecgBoot开发环境搭建概述

JeecgBoot作为一款基于Spring Boot和Ant Design Vue的企业级低代码开发平台，凭借其强大的代码生成器和丰富的功能组件，已经成为众多开发者快速构建管理系统的首选框架。但很多新手在初次接触时，往往会在环境搭建环节遇到各种"拦路虎"。我曾经带过十几个团队实施JeecgBoot项目，发现90%的启动问题都源于环境配置不当。

不同于简单的单体应用，JeecgBoot需要同时配置前端（Node.js+Yarn+Umi）和后端（JDK+Maven+MySQL）两套环境。就像组装电脑一样，每个配件都要兼容匹配——Node版本不对可能导致前端构建失败，JDK版本过高会引发兼容性问题，MySQL配置不当会影响数据持久化。接下来我会用最直白的语言，带你一步步避开这些坑。

2. 前端开发环境配置

2.1 Node.js环境搭建

Node.js是前端世界的基石，但版本选择有讲究。JeecgBoot官方推荐使用Node 10+版本，但实测发现Node 14.17.0最为稳定。这里强烈建议使用nvm（Node Version Manager）来管理多版本，就像Java开发者用jenv管理JDK一样方便。

安装nvm时有个关键细节：安装路径不要包含中文和空格。我习惯放在D:\Env\nvm目录，同时需要手动添加两个环境变量：

  • NVM_HOME：指向nvm安装目录（如D:\Env\nvm）
  • NVM_SYMLINK：指向nodejs符号链接目录（如D:\Env\nodejs）

配置淘宝镜像能大幅提升下载速度，修改nvm安装目录下的settings.txt文件：

root: D:\Env\nvm path: D:\Env\nodejs node_mirror: https://npm.taobao.org/mirrors/node/ npm_mirror: https://npm.taobao.org/mirrors/npm/

安装完成后，在命令行执行以下命令验证：

nvm install 14.17.0 nvm use 14.17.0 node -v # 应显示v14.17.0 npm -v # 应显示6.14.13

2.2 Yarn包管理工具

Yarn比npm有着更快的下载速度和更可靠的依赖管理，安装非常简单：

npm install -g yarn yarn config set registry https://registry.npmmirror.com # 配置国内镜像 yarn -v # 验证版本，推荐1.22.0+

常见踩坑点：如果遇到权限错误，可能需要以管理员身份运行命令行。在Windows系统下，建议关闭杀毒软件实时防护再进行安装。

2.3 IDE配置建议

虽然可以使用任何文本编辑器开发，但IntelliJ IDEA Ultimate版（配合Vue.js插件）能提供最完整的支持。安装后需要配置两项关键设置：

  1. 在File > Settings > Languages & Frameworks中启用JavaScript和Vue.js支持
  2. 配置Node.js路径：Settings > Languages & Frameworks > Node.js 指定之前安装的Node版本

实测发现，使用WebStorm也能获得不错的开发体验，但社区版的IDEA对前端支持有限。如果团队预算有限，VS Code + Volar插件也是不错的选择。

3. 后端开发环境搭建

3.1 JDK8安装与配置

JeecgBoot对JDK版本有严格要求，必须使用JDK8（推荐jdk1.8.0_281）。高版本JDK会导致编译错误，这是很多新手容易忽略的点。

安装时注意：

  1. 不要使用默认的C:\Program Files路径，建议改为D:\Env\jdk1.8.0_281
  2. 安装过程中会提示安装JRE，同样选择自定义路径（如D:\Env\jre1.8.0_281）

环境变量配置三部曲：

  1. 新建JAVA_HOME：D:\Env\jdk1.8.0_281
  2. 新建CLASSPATH：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
  3. Path中添加：%JAVA_HOME%\bin

验证安装：

java -version # 应显示1.8.0_281 javac -version # 应匹配java版本

3.2 Maven项目构建

Maven是Java项目的构建生命线，建议使用3.5.4版本（与JeecgBoot兼容性最佳）。解压后需要配置：

  1. 环境变量：

    • MAVEN_HOME：D:\Env\apache-maven-3.5.4
    • Path中添加：%MAVEN_HOME%\bin

  2. 修改conf/settings.xml：

<localRepository>D:\Env\maven-repo</localRepository> <mirror> <id>aliyun</id> <mirrorOf>*</mirrorOf> <name>Aliyun Repository</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

验证配置：

mvn -v # 应显示Apache Maven 3.5.4

3.3 Redis安装（可选）

虽然Redis不是必装组件，但建议开发环境一并安装以便测试缓存功能。Windows版直接解压redis-3.2.100.zip即可使用：

  1. 启动服务端：redis-server.exe
  2. 启动客户端测试：redis-cli.exe → 输入ping返回PONG即成功

生产环境建议使用Linux版Redis，Windows版本仅适合开发测试。

4. 数据库环境配置

4.1 MySQL安装与配置

JeecgBoot默认使用MySQL5.7，推荐使用压缩包方式安装（比MSI安装更干净）：

  1. 解压mysql-5.7.26-winx64.zip到D:\Env\mysql-5.7.26-winx64
  2. 创建my.ini配置文件：
[mysqld] port=3306 basedir=D:/Env/mysql-5.7.26-winx64 datadir=D:/Env/mysql-5.7.26-winx64/data max_connections=200 character-set-server=utf8mb4 default-storage-engine=INNODB
  1. 初始化数据库（管理员命令行）：
mysqld --initialize-insecure # 无密码初始化 mysqld -install # 安装服务 net start mysql # 启动服务

常见问题解决方案：

  • 缺少MSVCP120.dll：安装VC++ 2013运行库
  • 服务已存在：执行sc delete mysql清除旧服务

4.2 数据库管理工具

DBeaver是管理MySQL的利器，免费且支持多种数据库。安装后创建连接时：

  • 主机：localhost
  • 端口：3306
  • 用户名：root
  • 密码：（空，如果未设置）

首次使用建议修改root密码：

ALTER USER 'root'@'localhost' IDENTIFIED BY 'newpassword';

5. 项目启动与验证

5.1 后端项目启动

  1. 导入项目到IDEA：

    • File > Open > 选择pom.xml文件
    • 等待Maven依赖下载完成（约5-10分钟）

  2. 修改配置文件： 编辑application-dev.yml：

    datasource: url: jdbc:mysql://localhost:3306/jeecg-boot?useSSL=false username: root password: 123456

  3. 启动主类： 右键JeecgApplication > Run，看到以下日志表示成功：

    Started JeecgApplication in 15.32 seconds

5.2 前端项目启动

  1. 安装依赖：

    cd jeecg-web yarn install

  2. 启动开发服务器：

    yarn run serve

    访问http://localhost:3000应看到登录页面

5.3 常见问题排查

  1. 前端编译报错：检查Node版本是否为14.x，删除node_modules后重新yarn install
  2. 后端连接数据库失败：确认MySQL服务已启动，检查application-dev.yml中的密码
  3. 页面访问空白：检查浏览器控制台报错，可能是跨域问题需配置proxy

完成以上步骤，你就拥有了一个完整的JeecgBoot开发环境。建议首次使用时，先运行官方提供的示例SQL脚本，熟悉系统功能模块后再开始自定义开发。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/18 17:17:35

演讲时间管理神器：PPTTimer悬浮计时器让你的演示不再超时

演讲时间管理神器&#xff1a;PPTTimer悬浮计时器让你的演示不再超时 【免费下载链接】ppttimer 一个简易的 PPT 计时器 项目地址: https://gitcode.com/gh_mirrors/pp/ppttimer 在演讲和演示场景中&#xff0c;87%的演讲者都曾遭遇时间失控的尴尬——要么在重要观点前仓…

作者头像 李华
网站建设 2026/6/13 13:17:40

Windows 10下5分钟搞定ML302 OpenCPU开发环境（含GCC工具链配置）

Windows 10下快速搭建ML302 OpenCPU开发环境全指南 1. 认识ML302 OpenCPU开发的价值与优势 ML302作为中移物联推出的LTE-CAT1模组&#xff0c;其OpenCPU架构为物联网开发者提供了独特优势。传统开发模式通常需要外接主控MCU&#xff0c;而OpenCPU允许开发者直接在模组内部运行自…

作者头像 李华
网站建设 2026/6/18 5:05:25

STM32+MPU6050实战：手把手教你打造老人防摔报警器（附ESP8266联网配置）

STM32MPU6050实战&#xff1a;手把手教你打造老人防摔报警器&#xff08;附ESP8266联网配置&#xff09; 当独居老人在家中意外跌倒时&#xff0c;黄金救援时间往往在最初的几分钟内。传统的手动报警方式存在明显局限——据临床数据显示&#xff0c;约65%的跌倒老人因失去意识或…

作者头像 李华
网站建设 2026/6/12 16:05:49

魔兽争霸III 兼容性修复工具：技术原理与配置指南

魔兽争霸III 兼容性修复工具&#xff1a;技术原理与配置指南 【免费下载链接】WarcraftHelper Warcraft III Helper , support 1.20e, 1.24e, 1.26a, 1.27a, 1.27b 项目地址: https://gitcode.com/gh_mirrors/wa/WarcraftHelper WarcraftHelper是一款针对魔兽争霸III设计…

作者头像 李华
网站建设 2026/6/21 0:17:35

NCM格式高效解密全流程实战指南：从文件解锁到音乐自由

NCM格式高效解密全流程实战指南&#xff1a;从文件解锁到音乐自由 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 你是否曾遇到下载的网易云音乐&#xff08;NCM格式&#xff09;无法在车载音响、MP3播放器等设备播放的问题&#xf…

作者头像 李华
网站建设 2026/6/12 21:36:43

三相桥式全控整流电路仿真进阶：从Matlab参数配置到谐波分析实战

三相桥式全控整流电路仿真进阶&#xff1a;从Matlab参数配置到谐波分析实战 在工业电力电子应用领域&#xff0c;三相桥式全控整流电路作为电能转换的核心拓扑结构&#xff0c;其性能优化直接关系到变频器、新能源并网等关键设备的电能质量。传统教材往往停留在基础原理讲解层面…

作者头像 李华