Go模板通过define、block和template实现类似继承的效果,先定义基础布局并设置可覆盖区块,子模板重写特定block完成定制,最终渲染时合并所有定义,需注意模板命名唯一及指定根模板名。

在Go语言的html/template包中,虽然没有像Jinja2或Django模板那样直接支持“模板继承”的语法,但通过block、define和template等机制,我们可以实现类似模板继承与组合的效果。理解这些机制,能帮助我们构建结构清晰、可复用的Web前端页面。
模板定义与渲染基础
Go的模板系统以文本为基础,通过Parse或ParseFiles加载模板内容。每个模板可以包含多个命名模板片段,使用{{define "name"}}定义,再通过{{template "name"}}调用。
例如,定义一个基础布局:
{{define "base"}}
{{template "title" .}}
网站头部
{{template "content" .}}
{{end}}
这个base模板定义了整体结构,其中title和content是可被子模板覆盖的区块。
立即学习“go语言免费学习笔记(深入)”;
使用 block 实现可覆盖区域
block是define和template的结合体,允许定义默认内容并支持被重写。它在模板继承中非常关键。
修改基础模板:
{{define "base"}}
{{block "title" .}}
默认标题
{{end}}
公共头部
{{block "content" .}}
默认内容
{{end}}
{{end}}
子模板可以有选择地重写block部分,未重写的保留默认内容。
子模板的组合与重写
创建一个具体页面模板,比如home.tmpl:
{{define "title"}}首页 - 我的网站 {{end}}
{{define "content"}}
欢迎来到首页
这是主页内容。
{{end}}{{template "base" .}}
这里并没有重新定义base,而是定义了两个区块,并最终引用base模板。渲染时,Go模板引擎会合并所有已定义的区块。
在Go代码中加载并执行:
tmpl, err := template.ParseGlob("templates/*.tmpl")
if err != nil {
log.Fatal(err)
}
tmpl.ExecuteTemplate(w, "base", data)
注意:要渲染的是base,但引擎会自动使用home.tmpl中定义的title和content块来覆盖。
嵌套与局部组合:include 模式
对于可复用组件(如导航栏、侧边栏),可以单独拆分为模板文件,然后通过{{template "partial/header"}}引入。
例如创建partials/header.tmpl:
{{define "partial/header"}}
{{end}}
在base中使用:
{{template "partial/header" .}}
...
这种方式实现了模板的横向组合,适合构建模块化UI。
基本上就这些。通过define、block和template的合理搭配,Go模板虽无原生继承语法,却能灵活实现页面结构的继承与内容组合。关键是把基础布局抽象好,再让具体页面有选择地填充或覆盖区块。不复杂但容易忽略细节,比如模板名称必须唯一、执行时要指定根模板名等。掌握这些,就能写出清晰易维护的Golang Web模板。










