讲师中心 微信公众号
AI工具推荐 视频效率加速

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

胖枫吖_6664

胖枫吖_6664

发布时间:2026-01-13 19:57:02

|

956人浏览过

|

来源于php中文网

原创

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

在 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>。

html-to-pptx-converter
html-to-pptx-converter

使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。

下载

立即学习“前端免费学习笔记(深入)”;

⚠️ 注意事项:

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

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

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
typedef和define区别
typedef和define区别

typedef和define区别在类型检查、作用范围、可读性、错误处理和内存占用等。本专题为大家提供typedef和define相关的文章、下载、课程内容,供大家免费下载体验。

313

2023.09.26

define的用法
define的用法

define用法:1、定义常量;2、定义函数宏:3、定义条件编译;4、定义多行宏。更多关于define的用法的内容,大家可以阅读本专题下的文章。

619

2023.10.11

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

4774

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

4931

2025.07.04

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

20

2026.10.21

Playwright 页面操作指南
Playwright 页面操作指南

Playwright页面操作专题汇集元素定位、点击与输入、等待响应、多页面切换、Iframe、事件监听及文件处理的已审核文章,便于按操作场景查阅示例与常见问题。

0

2026.10.21

Playwright 入门教程
Playwright 入门教程

Playwright入门专题汇集测试框架安装、VS Code配置、录制脚本、编写首个用例、运行调试及查看报告的已审核文章,帮助初学者搭建端到端测试流程。

0

2026.10.21

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

120

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

80

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 224人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn