# 10.4 表结构解析与渲染引擎

:::tip 概述
生成引擎两段：**内省**（表结构 → 生成模型）与**渲染**（生成模型 + 模板 → 产物）。理解模型字段如何映射到代码，是定制模板与排障的基础。
:::

## 内省

读取目标库的表元数据：

```text
表级：表名、注释、引擎、字符集、自增、记录数
列级：列名、类型、可空、默认值、注释、自增、主键
索引：普通/唯一索引（uk_ 影响 UniqueFields 推断）
```

内省只读——CLI 与 Web 都不写库表结构。

## 生成模型的推断规则

| 表特征 | 推断产物 |
|---|---|
| 列注释含枚举取值（`1-在用 2-停用`） | SerializeMaps 字典声明 + 字典初始化 |
| uk_ 唯一索引 | UniqueFields 唯一性规则 |
| 含 tenant_id 列 | 租户级模块写法 |
| parent_id 自关联列 | 树形模板（ui2 前端 + IsTree 声明） |
| 文件类列（语义注释） | FileFields 声明 |
| del_flag/create_* 等公共列 | 不进业务字段（归钩子） |

**列注释质量直接决定推断质量**——这就是建表规约强调 COMMENT 的原因。

## 渲染

```text
模板（templates/*.tpl，Go text/template 语法）
  × 生成模型（表/列/索引 + 推断结果）
  = 产物文本（dto/repository/service/handler/api.ts/index.vue/...）
```

模板变量集中在模型上，模板内不做业务推断——推断逻辑在引擎，模板只负责排版。

## 幂等落盘

- overwrite=false：目标存在即跳过（保护手写）
- overwrite=true：全部覆盖
- router.go 声明块：按模块标记定位，幂等追加（重复生成不重复插入）

## 相关

- [10.5 模板体系](/zh/generator/templates.html)
- [10.7 实战案例](/zh/generator/demo.html)