📄️ Excel 定义 Schema
用 tables.xlsx / beans.xlsx / enums.xlsx(文件名以工程为准)在表格里维护结构定义。适合业务表频繁加字段、希望策划也能看到结构表的场景。
📄️ XML Schema
XML 适合程序维护的稳定类型(基础库、复杂继承树),与 Excel schema 可并存。一个 XML 文件里可同时写 enum / bean / table,不必像 Excel 那样拆三种文件。
📄️ 类型系统速查
类型写在 bean 字段的 type、Excel ##type 行,或校验标签里。本页给可直接套用的写法;单元格怎么填见 Excel 基础。
📄️ 外部类型映射(TypeMapper)
有时你希望生成代码直接使用项目里已有的类型,而不是 Luban 生成的类型。例如配置里定义了 vector3,希望 C# 里用 UnityEngine.Vector3,而不是生成的 vector3 类。
📄️ 多态与抽象 bean
把基类做成抽象类型(有子类),数据里用类型名(或 alias)区分实现;生成代码用继承表达,加载时得到具体子类实例。
📄️ 导入表与模块组织
本页解决:命名空间怎么划、一张逻辑表多个文件、公共类型复用,以及(可选)按文件名自动导入 table。