1. 开篇为什么选择JeecgBoot以及你需要准备什么大家好我是老张一个在Java后端和前端领域摸爬滚打了十来年的老码农。这些年从手搓Servlet到玩转Spring Cloud从jQuery到Vue3各种框架、工具用了个遍。今天想跟大家聊聊一个在国内企业级开发里特别火的“全家桶”框架——JeecgBoot。如果你是一个刚入行的Java新手或者是从其他技术栈转过来想快速上手全栈开发的朋友那么这篇文章就是为你量身定做的。我会手把手带你在Windows系统上从零开始把JeecgBoot的开发环境给搭起来直到项目成功跑起来。整个过程我会把我自己踩过的坑、绕过的弯都掰开揉碎了讲给你听保证你看完就能动手一次成功。JeecgBoot是个啥简单说它就是一个基于Spring Boot和Vue的低代码开发平台。官方说它能解决项目里70%的重复工作这话不假。它把用户权限、菜单管理、数据字典、在线报表这些后台管理系统必备的“轮子”都给你造好了还配了一个强大的代码生成器。你只需要关注自己的核心业务逻辑用它的在线开发工具或者生成器“画”出页面和接口效率能提升好几倍。对于想快速开发一个后台管理系统、或者接一些中小型企业项目的朋友来说它绝对是个神器。在开始动手之前我们先来盘一盘需要准备哪些“食材”。整个过程分为三大块后端环境、前端环境和数据库环境。后端核心是Java所以你需要JDK和开发工具IDEAJeecgBoot用到了Redis做缓存和会话管理所以它也得装上前端是基于Vue3的所以Node.js跑不掉最后数据得有个地方存MySQL和它的一个可视化工具Navicat或者你喜欢的其他工具也得备上。别怕听起来东西多但咱们一步一步来每一步我都会告诉你最省心、最不容易出错的装法。我的目标就是让你避开所有我当年遇到过的“坑”顺顺利利地把环境搭好。2. 第一步搞定后端运行环境后端环境是JeecgBoot的基石这块稳了后面就轻松一大半。咱们按顺序来先装最基础的JDK。2.1 JDK安装与配置别再为环境变量头疼了很多新手第一关就倒在JDK的环境变量上。咱们这次用JDK 17它是目前的一个长期支持版本既新又稳定对JeecgBoot支持也很好。首先去Oracle官网或者更推荐的AdoptiumEclipse Temurin网站下载安装包。我建议直接下.msi安装包因为它能帮你自动配置一部分系统变量省不少事。安装过程就是一路“Next”但安装路径我强烈建议改一下。别装C盘默认的Program Files下面因为路径里可能有空格有些老工具处理起来会出幺蛾子。我习惯在D盘建个Develop\Java这样的目录把JDK装在这里比如D:\Develop\Java\jdk-17。安装程序如果问你要不要安装JRE可以跳过JDK里已经包含了。装好后重头戏来了配置环境变量。按下Win S搜索“环境变量”选择“编辑系统环境变量”。在“系统变量”里新建一个变量变量名填JAVA_HOME变量值就是你刚才的JDK安装路径比如D:\Develop\Java\jdk-17。这个变量很多Java工具都会认。然后找到系统变量里的Path双击编辑新建一条填入%JAVA_HOME%\bin。这里有个小技巧%JAVA_HOME%就是引用前面你设置的那个路径这样以后你换JDK版本只需要改JAVA_HOME的值就行了Path不用动。验证是否成功打开一个新的命令行窗口一定要新开的这样才能读到刚设置的环境变量输入java -version和javac -version。如果两行命令都正确显示了版本号比如“17.0.x”那么恭喜你JDK配置成功如果提示“不是内部或外部命令”那肯定是Path没设对回去检查一下路径是不是填错了。2.2 IntelliJ IDEA安装你的主力开发武器工欲善其事必先利其器。IDEA是Java开发的事实标准用社区版Community就完全足够我们开发JeecgBoot了免费且功能强大。去JetBrains官网下载最新的安装包。安装过程同样简单注意两个地方一是在选择安装组件时把“.java”关联上二是在选择开始菜单文件夹那一步可以勾选“在右键菜单添加‘作为项目打开’”这个选项以后你右键点文件夹就能直接用IDEA打开了非常方便。安装完成后首次启动它会让你选择主题和进行一些初始设置。这些按喜好来就行。关键一步是配置Maven。IDEA内置了Maven但默认仓库在国外下载依赖慢如蜗牛。我们需要把它换成国内镜像。打开IDEA进入File - Settings - Build, Execution, Deployment - Build Tools - Maven。在User settings file这里点击“Override”然后定位到一个你喜欢的路径比如D:\Develop\apache-maven-3.9.8\conf\settings.xml你需要先下载Maven或者直接用IDEA自带的配置文件的路径。用记事本打开这个settings.xml文件在mirrors标签内添加阿里云的镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror这样以后下载jar包速度就飞起了。IDEA的其他设置比如字体、快捷键你可以慢慢摸索咱们先以能运行项目为目标。2.3 Redis安装与启动内存数据库的极简部署JeecgBoot用Redis来存会话、缓存数据所以它必须跑起来。对于Windows用户最省心的办法是去GitHub上搜索“microsoftarchive/redis”这个仓库在Releases里下载最新的Redis-x64-3.0.504.msi安装包。这个版本是微软维护的稳定兼容Windows。安装就是下一步到底它会自动把Redis安装成Windows服务。安装完后你可以在服务列表Win R输入services.msc里找到一个叫“Redis”的服务确保它的启动类型是“自动”并且已经启动。这样每次开机Redis就自己跑起来了完全不用你操心。如果你想更轻量也可以下载ZIP压缩包版本。解压到一个目录比如D:\Develop\Redis然后直接双击运行里面的redis-server.exe。你会看到一个黑色命令行窗口里面显示着Redis的logo和端口号默认6379最后一行是“Ready to accept connections”这就表示启动成功了。记住这个窗口不能关关了Redis服务就停了。所以还是推荐用安装成服务的方式一劳永逸。3. 第二步配置前端与数据库环境后端基础打好了现在我们来看前端和数据库。前端现在离不开Node.js而数据库我们选择最流行的MySQL。3.1 Node.js与包管理器前端世界的敲门砖去Node.js官网下载LTS长期支持版本的安装包比如20.x。安装过程无脑下一步同样建议修改安装路径到非系统盘比如D:\Develop\nodejs。安装程序会自动帮你把Node.js和npmNode包管理器添加到系统Path里。安装完打开命令行输入node -v和npm -v能看到版本号就说明成功了。但这里有个大坑npm的默认全局包安装目录在C盘的用户目录下时间一长C盘空间会报警。我们必须把它挪走。在你Node.js的安装目录下比如D:\Develop\nodejs新建两个文件夹node_global和node_cache。然后打开命令行管理员权限执行两条命令npm config set prefix D:\Develop\nodejs\node_global npm config set cache D:\Develop\nodejs\node_cache这会把全局安装的包和缓存都指向新目录。接着把D:\Develop\nodejs\node_global这个路径添加到系统的Path环境变量里。这一步很重要不然你全局安装的命令行工具比如后面要用的pnpm会找不到。JeecgBoot-Vue3项目推荐使用pnpm它比npm和yarn更快、更省磁盘空间。我们用刚配置好的npm来安装它npm install -g pnpm。安装完成后输入pnpm -v验证一下。有时候安装全局包会报权限错误如果遇到就用管理员身份打开命令行再执行安装命令。3.2 MySQL与Navicat数据存储和可视化MySQL去官网下载MySQL Installer。运行后选择“Custom”自定义安装。在选组件页面展开“MySQL Servers”选择最新的8.0版本添加到右边。点击那个版本下面会出现“Advanced Options”可以在这里修改安装路径和数据存储路径我都改到了D盘。接下来一路下一步直到“Accounts and Roles”设置root用户的密码。这个密码一定要记住我建议就设成123456本地开发环境简单好记最重要。其他配置全部保持默认尤其是端口3306除非你本机这个端口被占用了。最后执行安装等待完成。安装完后同样需要把MySQL的bin目录比如D:\Program Files\MySQL\MySQL Server 8.0\bin添加到系统的Path变量里。然后打开命令行输入mysql -u root -p回车后输入密码能进入MySQL命令行就说明安装成功了。光有命令行操作数据库太痛苦了我们需要一个图形化工具。Navicat Premium是收费的但有14天试用期对于学习完全够用。你也可以选择它的免费简化版“Navicat Premium Lite”或者完全免费的替代品比如DBeaver、HeidiSQL。安装Navicat就是一路下一步。安装好后打开点击“连接”选择MySQL连接名随便取比如local_mysql主机是localhost端口3306用户名root密码就是你刚才设的。点击“测试连接”成功就能保存了。有了它后面创建数据库、导入SQL文件就都是点点鼠标的事了。4. 第三步拉取并初始化JeecgBoot项目环境齐备现在请出我们今天的主角——JeecgBoot项目本身。4.1 获取项目源码与目录解读去JeecgBoot的官网或GitHub仓库下载最新的Vue3版本源码。如果从GitHub下载慢可以找找国内的码云镜像或者别人分享的网盘链接。下载下来是一个ZIP压缩包解压后你会看到两个主要文件夹jeecg-boot后端Spring Boot项目和jeecgboot-vue3前端Vue3项目。建议你把解压后的整个文件夹放在一个没有中文和空格的路径下比如D:\Projects\JeecgBoot这样可以避免很多潜在的编码和路径问题。用IDEA打开jeecg-boot文件夹。第一次打开IDEA会识别这是一个Maven项目并开始自动下载依赖如果你前面配好了阿里云镜像这会很快。依赖下载完成后先别急着运行我们来看看项目的关键结构。核心代码在jeecg-module-system模块里项目的启动类JeecgSystemApplication也在这里。配置文件在resources目录下我们重点关注application-dev.yml这是开发环境的配置。4.2 数据库创建与数据导入启动项目前必须先把数据库准备好。打开Navicat连接上你的本地MySQL。然后右键点击连接选择“新建数据库”。数据库名填jeecg-boot注意这个名字必须和后面配置文件里的一致字符集选择utf8mb4排序规则选择utf8mb4_unicode_ci。为什么选这个因为utf8mb4才是真正的UTF-8能支持存储表情符号而utf8mb4_unicode_ci排序规则不区分大小写且兼容性好。创建完数据库后它还是空的。我们需要把项目初始化的SQL脚本导入进去。在解压的后端项目目录里找到jeecg-boot\db文件夹里面有一个jeecgboot-mysql-5.7.sql文件或者类似名字的找最新的。在Navicat里右键你刚创建的jeecg-boot数据库选择“运行SQL文件”然后选中这个sql文件点击开始。执行成功后刷新一下你就会看到数据库里多出了几十张表这些都是JeecgBoot框架运行所需要的基础表比如用户表、菜单表、角色表等等。4.3 关键配置修改连接你的数据库现在回到IDEA打开jeecg-boot项目下的application-dev.yml文件。我们需要修改数据库连接配置让项目知道去连我们刚建好的数据库。找到spring.datasource.dynamic.datasource.master这一部分大概在文件中部主要修改这几项url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/Shanghai username: root password: 123456把url里的数据库名jeecg-bootusername和password改成你自己的。127.0.0.1就是本地3306是MySQL默认端口。serverTimezoneAsia/Shanghai这个参数很重要能避免时区错误导致的插入时间不对的问题。改完之后保存文件。5. 第四步前后端项目联调启动万事俱备只欠东风。现在让我们按顺序启动所有服务见证项目跑起来的时刻。5.1 启动后端Spring Boot项目首先确保两件事1. Redis服务已经启动在服务列表里查看2. MySQL服务已经启动。然后在IDEA里找到JeecgSystemApplication这个类通常旁边会有一个绿色的运行小三角图标点击它。或者右键这个类选择“Run ‘JeecgSystemApplication.main()’”。第一次启动可能会慢一点因为要初始化很多内容。请你紧盯IDEA下方的“Run”或“Spring Boot”窗口。如果一切顺利你会看到大量的日志滚动最后会出现几行关键信息一个大大的“Jeecg-Boot”艺术字。类似“Started JeecgSystemApplication in 15.326 seconds (JVM running for 16.785)”的启动成功提示。最重要的Tomcat started on port(s): 8080 (http)。这表示后端服务已经在本地8080端口启动了。如果启动失败最常见的错误是数据库连接不上。请检查1.application-dev.yml里的数据库配置尤其是密码2. MySQL服务是否真的启动了3. 数据库名jeecg-boot是否存在且字符集正确。根据错误日志提示基本都能定位问题。5.2 启动前端Vue3项目后端跑起来后我们另开一个IDEA窗口或者用VSCode等任何你喜欢的编辑器打开jeecgboot-vue3前端项目文件夹。打开后IDEA通常会识别出这是一个Node项目并在右下角提示你安装依赖。直接点“Install dependencies”就行或者自己打开终端Terminal。在项目根目录下打开终端首先确保你安装了pnpmpnpm -v。如果没装就用npm install -g pnpm安装。然后执行pnpm install来安装项目依赖。这个过程可能会遇到网络问题或权限问题。如果下载慢可以配置淘宝镜像pnpm config set registry https://registry.npmmirror.com。如果遇到权限错误特别是在Windows上可以尝试用管理员身份运行IDEA或终端。依赖安装成功后执行启动命令pnpm run dev。这个命令定义在package.json的scripts里意思是启动开发服务器。稍等片刻终端会输出“Local: http://localhost:3100”这样的信息端口号可能是3100或其他看控制台输出。这就说明前端开发服务器也启动成功了。5.3 访问系统与登录现在打开你的浏览器访问前端控制台给出的地址比如http://localhost:3100。你应该能看到JeecgBoot的登录页面。默认的系统管理员账号是admin密码是123456。输入后点击登录。如果登录后页面空白或报错请按F12打开浏览器开发者工具看“Console”控制台或“Network”网络标签页有没有红色报错。最常见的跨域问题JeecgBoot已经配置好了但如果后端不是运行在默认的8080端口就需要去前端项目的环境配置文件如.env.development里修改VITE_PROXY_TARGET等配置将代理目标指向你的后端地址。登录成功后你会进入一个功能丰富的后台管理系统主页。左侧是菜单栏包含了用户管理、角色管理、菜单管理等一系列系统管理功能。到这里恭喜你你已经成功在本地搭建并运行了JeecgBoot项目。你可以随意点击浏览熟悉这个框架提供了哪些开箱即用的功能。接下来你就可以基于这个基础环境开始你的低代码开发之旅了使用它的在线开发功能或者代码生成器来快速创建你自己的业务模块。