代码生成（主子表）

主子表生成适用于一张主表关联一张或多张明细表的业务，例如订单与订单明细、入库单与入库项、合同与履约节点。RuoYi Office 代码生成器支持普通、ERP、内嵌等主子表模板类型，对应 CodegenTemplateTypeEnum.MASTER_NORMAL、MASTER_ERP、MASTER_INNER 和 SUB。

适用场景

模式	适用场景
普通主子表	主表表单 + 子表列表/弹窗维护
ERP 主子表	进销存类单据，子表通常包含产品、数量、金额
内嵌主子表	主表编辑页中直接维护子表明细

配置重点

• 主表模板类型：选择主子表对应模式。
• 子表模板类型：子表设置为 SUB。
• 关联字段：子表中指向主表主键的字段，例如 order_id。
• 子表显示字段：明细列表要展示哪些字段，哪些字段参与新增/编辑。

生成链路

合并代码注意事项

• 主子表保存通常需要事务，主表和子表要同时成功或同时回滚。
• 子表更新要明确策略：全删全插、差量更新或按明细 ID 更新。
• 金额、数量类字段要补充精度校验和合计校验。
• ERP 类单据通常还会关联库存、财务、审批状态，生成代码只是起点。

排查清单

现象	优先检查
子表不生成	子表模板类型是否为 SUB；主表是否配置关联子表
保存后子表丢失	关联字段是否赋值；事务中是否写入明细
编辑时明细重复	更新策略是否全删全插；前端是否重复提交旧数据
合计金额不准	前后端是否都做精度处理；是否使用浮点数计算