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插件）能提供最完整的支持。安装后需要配置两项关键设置：

在File > Settings > Languages & Frameworks中启用JavaScript和Vue.js支持
配置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会导致编译错误，这是很多新手容易忽略的点。

安装时注意：

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

环境变量配置三部曲：

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

验证安装：

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

3.2 Maven项目构建

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

环境变量：
- MAVEN_HOME：D:\Env\apache-maven-3.5.4
- Path中添加：%MAVEN_HOME%\bin
修改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即可使用：

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

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

4. 数据库环境配置

4.1 MySQL安装与配置

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

解压mysql-5.7.26-winx64.zip到D:\Env\mysql-5.7.26-winx64
创建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

初始化数据库（管理员命令行）：

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 后端项目启动

导入项目到IDEA：
- File > Open > 选择pom.xml文件
- 等待Maven依赖下载完成（约5-10分钟）

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

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

启动主类：右键JeecgApplication > Run，看到以下日志表示成功：
```
Started JeecgApplication in 15.32 seconds
```

5.2 前端项目启动

安装依赖：
```
cd jeecg-web yarn install
```
启动开发服务器：
```
yarn run serve
```
访问http://localhost:3000应看到登录页面

5.3 常见问题排查

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

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

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