Go 的 html/template 本身不支持模板内直接赋值（如 {{.output = "val"}}），但可通过为传入的结构体定义可变方法，在模板执行过程中修改其字段，从而实现“从模板中提取多个计算结果”的效果。
go 的 `html/template` 本身不支持模板内直接赋值（如 `{{.output = "val"}}`），但可通过为传入的结构体定义可变方法，在模板执行过程中修改其字段，从而实现“从模板中提取多个计算结果”的效果。
在 Go 模板开发中，一个常见需求是：既要生成 HTML 输出，又希望在模板执行过程中同步收集或计算若干中间值（如标题、状态码、元数据等），供主程序后续使用。由于 template.Execute() 接口仅返回 error，且模板语法禁止直接修改传入的数据对象（例如 {{.Foo = "bar"}} 是非法语法），因此必须借助 Go 语言特性实现“副作用式”数据捕获。
✅ 推荐方案：使用带方法的结构体（指针接收）
核心思路是——将需要被模板“写入”的状态封装在结构体中，并为其定义指针接收的方法。该方法可在模板中被调用，修改结构体字段，而这些修改在模板执行完毕后仍保留在原始变量中。
以下是一个完整、可运行的示例：
package main
import (
"html/template"
"os"
)
type TemplateContext struct {
Title string
Content string
StatusCode int
Tags []string
// 可扩展任意字段用于“收集”模板内逻辑结果
}
// SetTitle 在模板中调用，用于设置标题（同时可触发其他逻辑）
func (c *TemplateContext) SetTitle(t string) string {
c.Title = t
return "" // 方法必须有返回值，但模板中通常忽略其输出
}
// SetStatus 同理，用于设置 HTTP 状态码
func (c *TemplateContext) SetStatus(code int) string {
c.StatusCode = code
return ""
}
// AddTag 向标签列表追加元素
func (c *TemplateContext) AddTag(tag string) string {
c.Tags = append(c.Tags, tag)
return ""
}
func main() {
const tmplStr = `
<!DOCTYPE html>
<html>
<head><title>{{.SetTitle "用户仪表盘"}}{{.Title}}</title></head>
<body>
<h1>{{.Title}}</h1>
<p>{{.Content}}</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/1208" title="Logomaster.ai"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680120446209.jpg" alt="Logomaster.ai" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1208" title="Logomaster.ai">Logomaster.ai</a>
<p>Logo在线生成工具</p>
</div>
<a href="/ai/1208" title="Logomaster.ai" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
{{.SetStatus 200}}
{{.AddTag "dashboard"}}
{{.AddTag "user"}}
</body>
</html>
`
ctx := &TemplateContext{
Content: "欢迎回来！",
}
t := template.Must(template.New("page").Parse(tmplStr))
if err := t.Execute(os.Stdout, ctx); err != nil {
panic(err)
}
// 模板执行完毕后，ctx 中已包含被模板“写入”的值
println("\n=== 模板执行后捕获的值 ===")
println("Title:", ctx.Title)
println("Status Code:", ctx.StatusCode)
println("Tags:", ctx.Tags)
}✅ 输出说明：HTML 被正常渲染到 stdout，同时 ctx.Title、ctx.StatusCode 和 ctx.Tags 均被模板内的方法调用成功更新。
⚠️ 注意事项与最佳实践
- 必须使用指针接收器：只有 *TemplateContext 类型的方法才能修改原始结构体字段；值接收器（func (c TemplateContext)）会操作副本，无效。
- 方法必须有返回值：Go 模板要求所有函数/方法调用必须返回某个值（即使为空字符串 ""），否则编译失败。
- 避免副作用混淆：建议方法名语义清晰（如 SetTitle、RecordMetric），并在文档中明确说明其副作用行为。
- 不推荐 FuncMap 方案（已弃用）：早期有开发者尝试通过 FuncMap 注入闭包来修改外部变量，但这破坏了模板数据隔离性，且无法在多个并发执行中安全复用；结构体方法更类型安全、可测试、易维护。
- 线程安全提示：若模板被并发执行（如 Web 服务中），每个请求应使用独立的 *TemplateContext 实例，避免共享状态竞争。
✅ 总结
Go 模板虽无原生“多返回值”机制，但凭借结构体方法的副作用能力，可优雅实现“渲染 + 数据采集”一体化。这一模式广泛应用于：
- 动态 SEO 元信息注入（）
- 页面级错误/告警收集
- A/B 测试分组标识记录
- 渲染耗时埋点
只要合理设计上下文结构体及其方法集，单个 .tmpl 文件即可同时服务于呈现逻辑与业务逻辑提取，真正达成“一份模板，双重价值”。
