Go标准库text/template实战：自动化生成前端CRUD代码

核心思路与准备工作

代码生成的本质是寻找重复模式的规律，将变动部分抽象化。本方案旨在替代人工拷贝和修改代码的操作，防止因疏忽导致的拼写错误或冗余代码残留。整个过程依赖两个核心要素：

1. JSON 配置文件：定义数据模型结构，包括字段名称、类型、必填性（IsRequired）、是否作为搜索条件（IsSearch）等业务属性。
2. Go 模板引擎：使用 text/template 解析上述配置，结合预定义的 Go 数据结构，输出目标格式的代码文件。

第1步：定义类型声明 (Type Definitions)

类型定义是前后端交互的基础。根据 JSON 中的字段列表，自动生成 TypeScript 的 namespace 或 interface 定义。这一步通常用于约束 API 的请求参数和响应结果。

在模板中，主要应用以下语法：

• {{- with .Model.Fields}}...{{- end}}：限定操作范围，避免在每个变量前重复书写长路径。
• {{- range .}}...{{- end}}：遍历字段数组，逐个生成属性行。
• {{- if .IsRequired}}...：进行条件判断，区分必填字段与可选字段（后者带 ?）。
• 自定义函数：如 ConvertTypeForTs，负责将底层类型转换为 TS 对应的类型（例如数据库 UUID 转为 String），保持模板逻辑简洁。

const TypeDTmpl = `// @ts-ignore
/* eslint-disable */
declare namespace API {
  type {{.Model.Name}}Item = {
    {{- with .Model.Fields}}
    {{- range .}}
    {{- if .IsRequired}}
    {{.Name}}: {{.ConvertTypeForTs}};
    {{- else}}
    {{.Name}}?: {{.ConvertTypeForTs}};
    {{- end}}{{- /* end for if .IsRequired */}}
    {{- end}}{{- /* end for range */}}
    {{- end}}{{- /* end for with .Model.Fields */}}
  };
  // ...其他返回类型定义
}`

第2步：生成 API 请求层

该步骤基于 GraphQL 规范生成查询语句与封装好的异步函数。模板不仅处理查询语句本身，还负责构建符合前端调用习惯的 TypeScript 函数外壳。

关键逻辑包括：

• 动态参数拼接：利用循环判断 .IsSearch，为 GraphQL Query/Mutation 动态追加搜索过滤条件或插入/更新字段。
• 返回值处理：函数内部解析前端传入的分页参数（limit/offset）及搜索词，并通过通用方法 Graphql<Result> 发起请求。
• 辅助函数：GenGraphqlSearchWhere 等方法用于生成复杂的 WHERE 子串或参数定义。

// 获取列表函数生成片段
export async function get{{.Model.Name}}List(params: API.{{.Model.Name}}Item & API.PageInfo) {
  const gqlVar = {
    limit: params.pageSize ? params.pageSize : 10,
    offset: params.current && params.pageSize ? (params.current - 1) * params.pageSize : 0,
    {{- with .Model.Fields}}
    {{- range .}}
    {{- if .IsSearch}}
    {{.Name}}: params.{{.Name}} ? '%' + params.{{.Name}} + '%' : '%%',
    {{- end}}
    {{- end}}
    {{- end}}
  };
  return Graphql<API.{{.Model.Name}}ListResult>(gqlGet{{.Model.Name}}List, gqlVar);
}

第3步：构建页面组件

最终阶段生成列表页、新增弹窗及编辑弹窗。此过程需处理较为复杂的 JSX 结构。

列表页生成逻辑：

• 集成 Ant Design Pro 组件，自动生成 ProTable 列配置。columns 数组通过遍历 JSON 字段生成标题和 dataIndex。
• 渲染操作列，包含编辑和删除按钮，绑定对应的增删改函数。

新增/编辑页生成逻辑：

• 遍历字段生成对应的表单控件（如 Input, Select）。通过调用自定义函数 GenPageCtrl 将简单的文本描述转化为具体的 <Form.Item /> 代码。

⚠️ 注意事项：转义双大括号
在 React JSX 模板字符串中直接写 {props} 会与 Go Template 的 {{ }} 语法冲突。若需在输出文件中显示单个大括号，可使用 {{"{{"}} 形式；若需传递对象展开语法 {...props}，需注意转义层级。在此示例中，Ant Design 的 submitter={{ render: ... }} 写法在模板中被处理为 {{"{{"}} render... 以确保正确输出。

<Modal destroyOnClose title="新增" footer={null}>
  <{{.Model.Name}}Add onFinish={addItem} />
</Modal>

完成判断与总结

当 JSON 配置解析完毕且模板执行成功后，检查生成的目录下是否出现了对应的 .ts (或 .tsx) 文件。文件内容应包含完整的接口定义、网络请求方法以及开箱即用的管理界面组件。运行项目验证各页面功能是否正常。

这种基于模板的自动生成方案，显著降低了前后端联调时的样板代码工作量。它不仅适用于当前场景，也可推广至任何遵循结构化数据的重复代码生成场景中。以上就是Go标准库template在自动化代码生成方面的详细内容，更多关于text/template高级用法的资料请关注本站其它相关文章！