go 的 `html/template` 包支持直接向模板传入基础类型（如 string、int、bool）或 map，只需在模板中通过 `.key` 语法访问 map 中的字段即可。
在 Go 模板中，.（点号）代表当前作用域的数据上下文（即传入 ExecuteTemplate 的数据）。当传入的是一个 map[string]interface{} 时，模板可通过 {{.keyName}} 的形式访问其键值——这是最常用且推荐的方式，无需封装为结构体。
以下是一个完整可运行的示例：
package main
import (
"html/template"
"log"
"net/http"
"os"
)
func main() {
// 方式一：从字符串解析模板（适合演示）
tmplString := `{{define "index"}}
{{.var1}} is equal to {{.var2}}
{{end}}`
tmpl, err := template.New("index").Parse(tmplString)
if err != nil {
log.Fatal(err)
}
// 构造纯变量映射
data := map[string]interface{}{
"var1": "value",
"var2": 100,
"isActive": true,
}
// 输出到标准输出（演示用）
err = tmpl.ExecuteTemplate(os.Stdout, "index", data)
if err != nil {
log.Fatal(err)
}
// 方式二：Web 服务中实际使用（搭配 http.Handler）
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/html; charset=utf-8")
if err := tmpl.ExecuteTemplate(w, "index", data); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
}
})
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}✅ 关键要点说明：
- 模板中必须使用 {{.var1}} 而非 {{var1}} —— 缺少前导 . 将导致模板编译失败或渲染为空（因未找到根作用域下的变量名）；
- . 可嵌套使用，例如 {{.User.Name}}（当 data["User"] 是结构体或 map 时）；
- 若需传入单个基础值（如仅一个字符串），可直接传 "hello"，并在模板中用 {{.}} 访问其本身（此时 . 即该字符串）；
- 所有传入数据均需满足 Go 模板的安全规则（如自动 HTML 转义），敏感内容可使用 {{.RawHTML | safeHTML}}（需提前调用 template.HTML 类型转换）。
⚠️ 注意事项：
立即学习“前端免费学习笔记（深入）”；
- 避免在模板中硬编码未声明的 key（如 {{.missing}}），会导致运行时静默为空，建议配合 template.Must() 和单元测试验证；
- 使用 map[string]interface{} 灵活但缺乏类型安全；对复杂场景，建议定义明确结构体并导出字段（首字母大写）以提升可维护性与 IDE 支持。
掌握 . 的作用域机制，是高效使用 Go 模板的基础——它让变量传递简洁直观，无需冗余包装。
