1. 开发环境准备从零搭建Jeecg-boot基础支撑第一次接触Jeecg-boot时我花了整整两天时间折腾环境配置。现在回想起来如果能提前知道这些关键点至少能节省80%的时间。下面我会把踩过的坑和最佳实践都告诉你。核心工具清单就像乐高积木的基础零件缺一不可JDK17千万别用旧版本我试过JDK8会直接报错。推荐从Oracle官网下载LTS版本Maven 3.6配置阿里云镜像能加速依赖下载修改settings.xmlmirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirrorNode.js 16建议安装LTS版本装完后记得执行npm config set registry https://registry.npmmirror.comRedis 5Windows用户可以用微软维护的Redis-Windows版本MySQL 5.78.0版本更推荐性能更好环境变量配置是新手最容易出错的地方。以Windows为例JDK配置后要在cmd验证java -version # 应显示类似openjdk 17.0.3 2024-04-16Maven配置完测试mvn -v # 应显示Apache Maven 3.6.3及版本信息Node.js安装后检查node -v npm -v数据库准备有个小技巧Jeecg-boot默认会找名为jeecg-boot的数据库所以建议先创建好CREATE DATABASE jeecg-boot DEFAULT CHARACTER SET utf8mb4;提示Redis服务一定要在启动后端项目前运行否则会报连接错误。Windows下可以写个bat脚本自动启动redis-server.exe redis.windows.conf2. 项目获取与IDE配置高效开发起手式源码获取方式直接影响后续开发效率。推荐直接从GitHub克隆最新稳定版git clone https://github.com/jeecgboot/JeecgBoot.git cd JeecgBoot后端项目导入到IDEA时要注意打开项目选择jeecg-boot目录首次加载会自动下载依赖约5-10分钟必须安装Lombok插件File Settings Plugins前端项目配置在WebStorm/VSCode中打开ant-design-vue-jeecg目录修改.env.development中的接口地址VITE_PROXY[[/jeecg-boot,http://localhost:8080/jeecg-boot]] VITE_GLOB_DOMAIN_URLhttp://localhost:8080/jeecg-bootMaven常见问题解决方案依赖下载失败删除本地仓库的lastUpdated文件后重试编译报错执行mvn clean install -ULombok报错确保IDE插件已启用实测发现用IDEA 2023.3版本启动速度比旧版快40%特别是开启以下配置Settings Build Compiler 勾选Build project automaticallyHelp Edit Custom VM Options 添加-Xms2048m -Xmx4096m3. 关键配置修改打通前后端任督二脉数据库连接配置在application-dev.yml中spring: datasource: url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?useUnicodetruecharacterEncodingUTF-8 username: root password: 123456Redis配置要注意密码和数据库索引redis: host: 127.0.0.1 port: 6379 # 如果有密码需要添加 # password: yourpassword database: 0前端代理配置有个隐藏坑点开发环境下需要修改vite.config.tsserver: { proxy: { /jeecg-boot: { target: http://localhost:8080, changeOrigin: true, rewrite: (path) path.replace(/^\/jeecg-boot/, ) } } }遇到过最头疼的问题是跨域解决方案是在后端添加配置类Configuration public class WebConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(*) .allowedHeaders(*); } }4. 项目启动与验证从理论到实践的临门一脚后端启动的正确姿势找到启动类JeecgSystemApplication先执行Maven install右键Run as Java Application前端启动的三种方式WebStorm右键package.json Show npm Scripts 双击serveVSCode终端执行yarn install yarn serve直接运行npm run dev登录验证时如果遇到验证码错误检查Redis是否正常运行清除浏览器缓存确认系统时间准确我常用的调试技巧后端接口测试访问http://localhost:8080/jeecg-boot/doc.html前端热更新修改代码后会自动刷新页面接口抓包使用Charles或Fiddler监控请求性能优化小贴士后端启动加速mvn spring-boot:run -Dspring-boot.run.jvmArguments-Xms512m -Xmx512m前端编译加速export NODE_OPTIONS--max_old_space_size4096