# 10.2 CLI 命令行使用

:::tip 概述
CLI 入口 cmd/generator：`go run ./cmd/generator -tables "表名|注释"`。支持预览（-preview）与批量统计（-batch），读取同一份 config.yaml，产出与 HTTP 入口完全一致。
:::

## 命令格式

```sh
# 一键生成（文件 + 菜单 + 字典 + 路由，全部幂等）
go run ./cmd/generator -tables "goframe_example|案例演示表"

# 多表（逗号分隔）
go run ./cmd/generator -tables "goframe_example|案例演示表,goframe_file_template|文件模板"

# 仅预览（不落盘，打印文件清单）
go run ./cmd/generator -tables "goframe_example|案例演示表" -preview

# 批量统计（逐表输出生成/跳过/覆盖/失败计数）
go run ./cmd/generator -tables "goframe_example|案例演示表" -batch
```

`-tables` 格式：`"表名|表注释"`——注释可省略（`|` 后内容被忽略）；表注释用于模块中文名（日志标题/字典名）。

## 执行流程（CLI 侧）

```text
1. 读取 manifest/config/config.yaml（generator.* 配置）
2. 空白 import internal/logic → 全部服务 init 注册
3. 调用 service.Generator().Preview / Generate / BatchGenerate
   ——与 HTTP 入口同一套核心逻辑
4. 输出分组结果：
   + 生成（Generated）  - 跳过（Skipped）  * 覆盖（Overwritten）  ! 失败（Failed）
5. 提示："下一步: go build ./... 并重启服务"
```

## 生成后必做

```sh
go build ./... && ./bin/admin-server.exe     # 编译并重启（init 注册/路由生效）
```

然后：

```text
1. 登录 → 系统管理 → 角色管理 → 为角色勾选新模块权限节点
2. 访问新菜单验证增删改查
3. 租户级新表：把表名加入 internal/model/hooks 的 tenantTables（重启生效）
```

## CLI 与 HTTP 的选择

| 场景 | 推荐 |
|------|------|
| 批量生成多表 | CLI（命令行批量更顺手） |
| 团队协作/远程环境 | HTTP 管理页（可视化预览） |
| CI 流水线 | CLI |
| 预览确认再生成 | 两者皆可（-preview / preview 接口） |

## 常见问题

| 症状 | 原因 |
|------|------|
| `unknown table` | 表不存在或库连接错（查 config.yaml database） |
| 注释/枚举缺失 | 非 MySQL 库内省不到注释——建议 MySQL 上生成或人工补注释 |
| 提示"路由已存在" | registerRouter 幂等——正常（router.go 已含该注册行） |
| 生成后编译失败 | gofmt 失败会报错中断；查输出 Failed 项 |
| CLI panic 注册冲突 | RegisterJobHandler 重名等 init 冲突——查 internal/task |