如何在 Go 的 html/template 中正确传递并使用基础变量

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 模板的基础——它让变量传递简洁直观，无需冗余包装。