安装与获取工具
本页解决：把 Luban 可执行程序准备好，并能找到官方示例工程。
环境
- 安装 .NET SDK 8.0 或更高版本。
- 克隆或下载示例工程 luban_examples（Gitee 镜像亦可）。
后续快速上手默认以 luban_examples 里的 MiniTemplate 为起点。
获取 Luban
任选其一：
| 方式 | 说明 |
|---|---|
| Release | 从 GitHub Releases 下载已发布包 |
| 示例自带 | luban_examples/Tools/Luban（可能不是最新版） |
| 自编译 | 克隆 luban 源码后按仓库说明编译 |
运行形态一般为：
dotnet <path_to_Luban.dll> --conf ... -t ... -c ... -d ...
Windows 上示例脚本多为 gen.bat，已写好 LUBAN_DLL 路径。
最小工程长什么样
MiniTemplate 典型结构：
MiniTemplate/
luban.conf # 全局配置：groups / targets / schemaFiles / dataDir
Defines/ # 可选 XML schema（如 builtin.xml）
Datas/ # 数据与 Excel schema（__tables__ / __beans__ / __enums__）
gen.bat / gen.sh # 生成脚本
output/ # 生成结果（脚本指定）
常见坑
- Tools/Luban 过旧：生成行为与文档不一致时，先换成最新 Release。
- SDK 版本不够：需 8.0+。
- 路径含空格或未改 LUBAN_DLL：复制模板后检查
gen.bat中的 dll 路径。