
在 go 的 `html/template` 中,使用 `{{ template "name" }}` 语法引入子模板时,默认不会自动继承当前作用域的数据;必须显式传入上下文(如 `.`)才能使变量在被包含模板中可用。
当你在 index.tpl 中写 {{ template "head" }} 时,Go 模板引擎会以空数据(nil context) 渲染 "head" 模板——即 .Title 在 head.tpl 中求值为 "",导致 <title></title> 空置。而主模板中 {{ .Title }} 能正常显示,是因为 Index 函数调用 t.ExecuteTemplate(..., index) 时,index 结构体作为根数据传入了整个模板执行上下文。
✅ 正确做法是:显式将当前数据(.)作为参数传递给被包含模板:
{{ template "head" . }}修改后的 index.tpl 片段如下:
{{ define "index" }}
<html lang="en">
{{ template "head" . }} <!-- ✅ 关键:传入当前上下文 -->
<body>
<h1>Main info:</h1>
Title: {{ .Title }}
Desc: {{ .Desc }}
</body>
</html>
{{ end }}此时 head.tpl 中的 {{ .Title }} 将能正确访问 Page{Title: "This is title", ...} 的字段,渲染出 <title>This is title</title>。
立即学习“前端免费学习笔记(深入)”;
⚠️ 注意事项:
- {{ template "name" }} 等价于 {{ template "name" nil }},即显式传入 nil 上下文;
- 若需传入其他结构体或字段(如 {{ template "header" .User }}),也可灵活指定;
- define 定义的模板本身不接收隐式上下文,其数据完全依赖 template 调用时传入的第二个参数;
- 使用 {{ with .Something }}...{{ end }} 等控制结构时,作用域会临时切换,但 template 调用仍需显式传参。
总结:Go 模板的“包含”不是作用域继承,而是函数式调用——你传什么,子模板就拿到什么。养成 {{ template "xxx" . }} 的习惯,是避免变量丢失最简单、最可靠的实践。










