在Go语言的代码生成场景中，我们经常需要根据不同的配置或上下文，输出不一样形态的函数声明。借助标准库text/template里的if-else控制结构，可以把函数签名中的可变部分交由模板在渲染时决定，而不是在Go代码里用字符串拼接硬凑。这样做既减少了出错概率，也让生成规则一目了然。
一、Go模板条件语法基础
Go模板的if-else和其他模板引擎类似，但更强调上下文数据的传递。模板中的点号（.）代表当前传入的数据对象，我们可以通过结构体字段在条件中做判断。if动作支持管道和比较函数，比如eq、ne、lt等，用来控制代码块是否输出。
在生成函数签名时，通常会定义一个描述函数的结构体，把返回类型、是否可变参数、接收者类型等字段放进去。模板根据字段值选择不同的文本片段。注意模板只负责文本渲染，不会做Go语法检查，因此条件逻辑必须写得严谨，否则生成的代码可能无法编译。
type FuncMeta struct {
Name string
HasError bool
IsVariadic bool
Receiver string
}
func Render(meta FuncMeta) (string, error) {
tpl := `{{if .Receiver}}func ({{.Receiver}}) {{.Name}}(){{else}}func {{.Name}}(){{end}}{{if .HasError}} error{{end}}`
t := template.Must(template.New("sig").Parse(tpl))
var buf bytes.Buffer
if err := t.Execute(&buf, meta); err != nil {
return "", err
}
return buf.String(), nil
}
二、用if-else动态拼接参数与返回值
真实的函数签名往往比无参无返回值复杂。我们可以利用if-else分别控制参数列表和返回值部分。例如当方法需要暴露为包级函数时，不输出接收者；当接口要求返回错误时，自动追加error。可变参数则通过判断IsVariadic字段来决定写普通类型还是省略号加类型。
下面示例展示了一个更完整的模板：根据元数据输出带接收者、参数及错误返回的函数头。可以看出，条件分支把“变化点”收敛在模板内，调用方只需准备数据，不用关心字符串怎么拼。若以后要支持多返回值，只需在模板里增加对应的if块即可。
const tpl = `{{if .Receiver}}func ({{.Receiver}}) {{.Name}}({{if .IsVariadic}}args ...interface{{else}}args interface{{end}}){{else}}func {{.Name}}({{if .IsVariadic}}args ...interface{{else}}args interface{{end}}){{end}}{{if .HasError}} (err error){{end}}`
func BuildSignature(meta FuncMeta) string {
t := template.Must(template.New("f").Parse(tpl))
var b bytes.Buffer
_ = t.Execute(&b, meta)
return b.String()
}
三、避免常见陷阱
一个容易忽略的问题是模板中的空白处理。Go模板默认会保留换行和缩进，如果直接把if-else写在多行，生成的函数签名可能夹杂多余空格，虽不影响编译但不够整洁。可以使用{{- 和 -}}来裁剪左右空白，让输出更紧凑。
另一个陷阱是字段命名与Go导出规则。模板只能访问结构体的导出字段（首字母大写），若把Name写成name，模板会取不到值而输出空串，导致生成func ()这样的非法签名。建议在构造元数据时用单元测试覆盖几种典型组合，确保渲染结果符合预期。
| 场景 | 模板条件 | 生成结果示例 |
|---|---|---|
| 包级函数无错误 | 无Receiver，HasError false | func Do(args interface) |
| 方法有错误返回 | 有Receiver，HasError true | func (s Server) Do() (err error) |
| 可变参数函数 | IsVariadic true | func Log(args ...interface) |
四、结合代码生成实践
在编写ORM或RPC框架时，常需为结构体批量生成增删改查方法。把这些方法的差异抽象成FuncMeta切片，循环执行同一个模板，就能得到一整套动态签名。相比手写，维护成本显著降低，且重构时只改模板不碰逻辑。
如果签名规则进一步复杂，比如依据标签（tag）决定是否生成指针接收者，也可以在结构体里加字段，然后在模板中用嵌套if判断。总之，把“是否”“怎样”写进模板的if-else，是Go模板动态生成函数签名的核心思路，既清晰又不易遗漏边界情况。