开发指南
更新日志

【v2025-11】

# 极大完善 vben5 的 antd、vben 版本的功能，优化整体稳定性

# 📈 Statistic

总代码行数：273342
源码代码行数：170239
注释行数：62167
单元测试用例数：1330

# ⭐ New Features

【优化】Vben5.0 的 antd、ele 的代码生成器，由 @芋道源码 (opens new window)、@FronNia (opens new window) 贡献 6ac6cdd (opens new window)，解决 <>
【优化】增加对 LocalDateTime 类型格式化不生效问题（支持自定义注解），由 @wunai-pl (opens new window) 贡献 #1019 (opens new window)
【优化】selectJoinPage 方法，支持带有排序参数的分页查询，由 @光辉 (opens new window) 贡献 #1454 (opens new window)
【优化】对金蝶、东方通等 war 的兼容，由 @墨轩 (opens new window) 贡献 #208 (opens new window)
【优化】convertor.py 兼容 mall 的转换，由 @芋道源码 (opens new window) 贡献 30c4be1 (opens new window)

Vben5.0 + antd 管理后台专区：

【新增】Description 组件的重构，由 @xingyuv (opens new window) 贡献
【新增】IoT 部分迁移完成，由 @haohaoMT (opens new window)、@huppygo (opens new window)、@xingyuv (opens new window) 贡献 #224 (opens new window)、#230 (opens new window)、#232 (opens new window)、#236 (opens new window)、#245 (opens new window)、#260 (opens new window)、#269 (opens new window)
【新增】Mall 商品等部分迁移与代码优化，由 @puhui999 (opens new window)、@芋道源码 (opens new window) 贡献 #235 (opens new window)、#244 (opens new window)、#277 (opens new window)
【新增】Mall 客服模块的迁移与代码优化，由 @jawe (opens new window)、@xingyuv (opens new window) 贡献 #243 (opens new window)、#250 (opens new window)
【新增】BPM 部分迁移与代码优化，由 @Jason (opens new window)、@芋道源码 (opens new window) 贡献 #246 (opens new window)、#255 (opens new window)、#247 (opens new window)、#259 (opens new window)、#264 (opens new window)、#266 (opens new window)、#280 (opens new window)
【新增】MP 部分迁移与代码优化，由 @hw (opens new window)、@jawe (opens new window)、@dylanmay (opens new window) 贡献 #258 (opens new window)、#252 (opens new window)、#263 (opens new window)、#268 (opens new window)、#271 (opens new window)、#276 (opens new window)、#279 (opens new window)
【完成】ERP 所有迁移与代码优化，由 @芋道源码 (opens new window) 贡献
【完成】CRM 所有迁移与代码优化，由 @芋道源码 (opens new window) 贡献

Vben5.0 + element-plus 管理后台专区：

【新增】Description 组件的重构，由 @xingyuv (opens new window) 贡献
【新增】Mall 部分迁移与代码优化，由 @芋道源码 (opens new window) 贡献
【新增】Mall 客服模块的迁移与代码优化，由 @jawe (opens new window)、@xingyuv (opens new window) 贡献 #243 (opens new window)、#250 (opens new window)
【新增】BPM 部分迁移与代码优化，由 @Jason (opens new window)、@芋道源码 (opens new window) 贡献 #267 (opens new window)、#270 (opens new window)、#280 (opens new window)
【新增】MP 部分迁移与代码优化，由 @hw (opens new window)、@jawe (opens new window)、@dylanmay (opens new window) 贡献 #258 (opens new window)、#252 (opens new window)、#266 (opens new window)、#268 (opens new window)、#276 (opens new window)、#279 (opens new window)
【完成】ERP 所有迁移与代码优化，由 @芋道源码 (opens new window) 贡献
【完成】CRM 所有迁移与代码优化，由 @芋道源码 (opens new window) 贡献

Vue3 + element-plus 管理后台专区：

【优化】使用 wangeditor-next 替换 wangeditor，由 @xingyu (opens new window) 贡献 4e870d6 (opens new window)、9e75e98 (opens new window)
【优化】Tab 支持鼠标中间关闭，由 @DevDengChao (opens new window) 贡献 #189 (opens new window)
【优化】商品发布界面的交互，由 @DevDengChao (opens new window) 贡献 #190 (opens new window)、#194 (opens new window)、#195 (opens new window)
【优化】文件上传进度显示，由 @huchao (opens new window) 贡献 #831 (opens new window)
【优化】字典类型更新时，无需重新点击查询，由 @AKING (opens new window) 贡献 #828 (opens new window)
【优化】表单设计器：部门选择器增加可选返回部门id或者部门名称，由 @zhanglc0618 (opens new window) 贡献 #199 (opens new window)

AI 大模型专区：

【新增】Grok 接入，由 @gezipppp-ux (opens new window) 贡献 #981 (opens new window)

MALL 商城专区：

【优化】uniapp tree-shaking: 按需引入让代码更轻、更清晰、更可维护，由 @爱宇阳 (opens new window) 贡献 #165 (opens new window)
【新增】uniapp 小程序购物订单的兼容，由 @wuKong (opens new window) 贡献 #166 (opens new window)、#221 (opens new window)
【新增】将目录结构改成 vue-cli 可打包的结构使之能脱离 HBuilder打包，由 @云扬四海 (opens new window) 贡献 #168 (opens new window)

MP 公众号专区：

【新增】微信模版消息，由 @wuKong (opens new window) 贡献 #215 (opens new window)、#832 (opens new window)

# 🐞 Bug Fixes

【修复】代码生成模版：重置 currentRow 时没有对模板类型进行判断，由 @DevDengChao (opens new window) 贡献 #1009 (opens new window)
【修复】easy-trans 因为数据权限，导致无法读取的问题，由 @芋道源码 (opens new window) 贡献 24a8805 (opens new window)
【修复】优化 postgresql init script，由 @DevDengChao (opens new window) 贡献 #1023 (opens new window)
【修复】用户角色过滤逻辑，确保当用户不包含当前选中角色时返回空结果而非全部用户，由 @Manumiter (opens new window) 贡献 #1448 (opens new window)
【修复】API 响应加密时添加加密 header 标识不生效的问题，由 @sunguowei (opens new window) 贡献 #1446 (opens new window)
【修复】FileClient 配置未更新，但是重建的问题，由 @芋道源码 (opens new window) 贡献 90a4f56 (opens new window)，解决 https://t.zsxq.com/29wkW (opens new window)

Vue3 + element-plus 管理后台专区：

【修复】导入场景，上传文件后后端报错导致无法再次提交的 bug，由 @局外人 (opens new window) 贡献 #829 (opens new window)

MALL 商城专区：

【修复】找不到所在区域的运费收费模板和运费免费模板时（即：未配置所在区域的运费模板），不把模板对象 put 进 result 中，由 @宝二爷 (opens new window) 贡献 #1441 (opens new window)
【修复】将手机号授权登录提示修改为"手机号快捷登录"，避免微信审核不通过，由 @爱宇阳 (opens new window) 贡献 #162 (opens new window)
【修复】商城系统订单列表中表头未根据表体自适应宽度，由 @芋道源码 (opens new window) 贡献 5ebbc75 (opens new window)
【修复】修正分销提现时，金额计算逻辑带上手续费，确保转账金额与实际提现金额一致，由 @芋道源码 (opens new window) 贡献 3aa9ea9 (opens new window)
【修复】调整佣金计算逻辑，确保佣金乘以购买数量，由 @芋道源码 (opens new window) 贡献 5c4fedb (opens new window)，解决 https://gitee.com/yudaocode/yudao-mall-uniapp/issues/ICY7SJ (opens new window)
【修复】快递鸟、快递 100 的查询报错，由 @芋道源码 (opens new window) 贡献 a0b7777 (opens new window)，解决 https://gitee.com/zhijiantianya/yudao-cloud/issues/ICY7H3 (opens new window)
【修复】纯积分商品的售后流程，由 @芋道源码 (opens new window) 贡献 887594e (opens new window)，解决 https://t.zsxq.com/AQEvL (opens new window)
【修复】优惠劵用户领取数量校验逻辑，确保用户领取时剩余数量充足，由 @芋道源码 (opens new window) 贡献 073ffb5 (opens new window)，解决 https://t.zsxq.com/mElGQ (opens new window)、https://t.zsxq.com/6pLzr (opens new window)

BPM 工作流专区：

【修复】BpmProcessInstanceCopyServiceImpl 抄送时参数顺序错误的问题，由 @cetuer (opens new window) 贡献 #273 (opens new window)
【修复】流程表单编辑打开直接保存 js 丢失问题修复，由 @aho (opens new window) 贡献 #834 (opens new window)、500705d (opens new window)
【修复】流程操作时，增加数据权限的忽略，由 @芋道源码 (opens new window) 贡献 fe186da (opens new window)、d34dd35 (opens new window)，解决 https://gitee.com/zhijiantianya/yudao-cloud/issues/ID1UYA (opens new window)
【修复】BPMN 设计器的各种边界情况，由 @芋道源码 (opens new window) 贡献 33e489e (opens new window)、b666e1b (opens new window)、c568d45 (opens new window)、9f1c4f2 (opens new window)

IoT 物联网专区：

【修复】xxl job 任务名称重复导致服务启动报错，由 @huppygo (opens new window) 贡献 #211 (opens new window)

Pay 支付专区：

【修复】微信支付 V3 的公钥错误地被设置为私钥证书路径，由 @芋道源码 (opens new window) 贡献 #1013 (opens new window)
【修复】一些 pay 相关的界面 bug，由 @DevDengChao (opens new window) 贡献 #186 (opens new window)、#187 (opens new window)

# 🔨 Dependency Upgrades

【升级】spring-boot from 3.5.3 to 3.5.8
【升级】flowable from 7.0.1 to 7.2.0
【升级】spring-ai from 1.0.1 to 1.1.0

← 配置读取【v2025-10】→