首页 > Golang > Go教程

Go中传递变量到子模板技巧

时间：2026-02-06 17:00:45 215浏览收藏

积累知识，胜过积蓄金银！毕竟在Golang开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Go 中 html/template 传递变量到子模板的方法》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

如何在 Go 的 html/template 中正确传递变量到被包含的模板

在 Go 的 `html/template` 中，使用 `{{ template "name" }}` 语法引入子模板时，默认不会自动继承当前作用域的数据；必须显式传入上下文（如 `.`）才能使变量在被包含模板中可用。

当你在 index.tpl 中写 {{ template "head" }} 时，Go 模板引擎会以空数据（nil context） 渲染 "head" 模板——即 .Title 在 head.tpl 中求值为 ""，导致空置。而主模板中 {{ .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", ...} 的字段，渲染出 This is title。

⚠️ 注意事项：

{{ template "name" }} 等价于 {{ template "name" nil }}，即显式传入 nil 上下文；
若需传入其他结构体或字段（如 {{ template "header" .User }}），也可灵活指定；
define 定义的模板本身不接收隐式上下文，其数据完全依赖 template 调用时传入的第二个参数；
使用 {{ with .Something }}...{{ end }} 等控制结构时，作用域会临时切换，但 template 调用仍需显式传参。

总结：Go 模板的“包含”不是作用域继承，而是函数式调用——你传什么，子模板就拿到什么。养成 {{ template "xxx" . }} 的习惯，是避免变量丢失最简单、最可靠的实践。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~

前往漫画官网入口并下载 ➜