1. 环境准备与项目初始化
第一次接触JeecgBoot时，我被它"低代码"的宣传语吸引，但真正让我惊艳的是v3.8.3版本对Spring Boot 3和Java 21的全面支持。记得当时为了测试性能，我特意用JDK 21跑了个简单的客户管理模块，启动速度比老版本快了近40%。下面我就带你从零开始搭建开发环境。
基础环境配置是很多新手容易踩坑的地方。我建议直接安装JDK 21而不是17，因为Java 21的虚拟线程特性在处理高并发请求时优势明显。安装完JDK后，记得配置JAVA_HOME环境变量，这个老生常谈的问题至今仍有30%的初学者会忘记检查。MySQL推荐使用8.0以上版本，特别是需要用到JSON字段类型时，5.7版本的功能支持有限。
获取项目源码时有个小技巧：Gitee的仓库通常比Github同步更快。我习惯用这个命令克隆项目：
git clone https://gitee.com/jeecg/JeecgBoot.git --depth=1加上--depth=1参数可以只克隆最新提交，节省下载时间。解压后注意检查目录结构，后端代码在根目录，前端代码在ant-design-vue-jeecg子目录，这是前后端分离项目的典型结构。
2. 数据库与后端服务配置
创建数据库时有个细节容易被忽略：字符集必须用utf8mb4。去年我帮一个团队排查乱码问题，发现他们用的还是老旧的latin1字符集。正确的建库语句应该是：
CREATE DATABASE jeecg_boot DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;修改application-dev.yml配置文件时，建议先备份原始文件。除了基本的数据库连接信息，有几个关键参数需要注意：
spring: redis: database: 0 # 生产环境建议每个模块使用独立db timeout: 3000 # 超时时间单位是毫秒 servlet: multipart: max-file-size: 50MB # 文件上传大小限制启动后端服务时，如果使用IDEA，记得开启注解处理（Annotation Processing）。有次我遇到Lombok注解不生效的问题，排查两小时才发现是这个选项没勾选。控制台看到"Jeecg-Boot startup success"后，别急着关窗口，先访问http://localhost:8080/jeecg-boot/doc.html 确认Swagger文档能正常打开。
3. 前端工程配置技巧
前端项目启动前，建议先清理npm缓存。我遇到过依赖安装失败的情况，执行下面命令就能解决：
npm cache clean --force如果网络不稳定，可以永久切换淘宝镜像：
npm config set registry https://registry.npmmirror.com启动前端服务时，npm run serve默认占用3000端口。如果端口冲突，可以修改vue.config.js里的devServer配置。有个实用技巧：在package.json里添加--open参数能让启动后自动打开浏览器：
"scripts": { "serve": "vue-cli-service serve --open", }4. 低代码核心功能实战
登录系统后第一件事应该是修改默认密码。有次安全测试中，我们用扫描工具发现了大量使用默认密码的JeecgBoot系统，这是个严重的安全隐患。
在线表单开发是低代码的核心。创建客户表示例时，字段设计要注意这些细节：
- 手机号字段建议用varchar(20)而不是11位数字，要考虑国际号码
- 金额字段用decimal(12,2)避免精度丢失
- 每个字段的"控件类型"决定前端表单样式，比如日期选择器、下拉框等
同步数据库前，务必检查字段注释是否完整。生成的CRUD页面中，字段注释会自动转为表单标签。代码生成后下载的zip包，后端代码直接放到对应package，前端代码需要手动合并路由和api文件。
5. 菜单权限配置实战
菜单配置有个隐藏功能：可以设置按钮级权限。比如在客户管理模块，你可以控制哪些角色能看到"导出Excel"按钮。具体操作是在菜单管理的"按钮权限"标签页添加权限标识。
角色授权时建议采用最小权限原则。我见过一个案例，给普通用户授予了系统管理权限，导致误删了重要数据。正确的做法是为每个业务模块创建单独的角色，比如"客户经理"、"订单管理员"等。
6. 常见问题排查指南
启动时报JDK版本错误？检查三处配置：
- pom.xml里的java.version
- IDEA的Project Structure
- 系统环境变量JAVA_HOME
前端页面空白可能是路由问题，尝试清理浏览器缓存或检查vue-router配置。数据库连接超时通常是MySQL的wait_timeout设置过短，可以调整为28800（8小时）。
性能调优方面，我习惯在application.yml中添加这些配置：
spring: jpa: open-in-view: false # 避免性能陷阱 redis: lettuce: pool: max-active: 20 # 连接池大小根据业务调整7. 进阶开发技巧
对于复杂业务逻辑，可以在生成的Service类中添加自定义方法。比如客户管理模块需要统计地区分布：
public Map<String, Integer> getCustomerDistribution() { return customerMapper.selectList(null).stream() .collect(Collectors.groupingBy( Customer::getRegion, Collectors.summingInt(e -> 1) )); }前端二次开发时，可以复用JeecgBoot内置的组件。比如使用JDictSelectTag组件快速实现数据字典下拉框：
<j-dict-select-tag v-model="queryParam.status" dictCode="customer_status" placeholder="请选择客户状态"/>项目打包部署时，前后端分离部署更利于扩展。后端用mvn clean package生成jar包，前端用npm run build生成静态文件。Nginx配置示例：
location / { root /home/www/jeecg; index index.html; try_files $uri $uri/ /index.html; } location /jeecg-boot { proxy_pass http://127.0.0.1:8080; }
