17370845950

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