Go语言中高效重用HTML模板：避免重复解析的实践指南

t := template.New("welcome")
t, _ = t.ParseFiles("welcome.tpl")
t.Execute(w, data)

// 假设 templateMap 已在应用启动时初始化，例如：templateMap := make(map[string]*template.Template)

tplName := "welcome"
t := templateMap[tplName] // 从map中获取模板实例。如果键不存在，对于指针类型会返回零值nil。
if t == nil {
    t = template.New(tplName)
    // 实际项目中，这里的错误处理非常重要
    var err error
    t, err = t.ParseFiles("welcome.tpl")
    if err != nil {
        // 处理错误，例如记录日志并返回HTTP 500
        http.Error(w, "Error parsing template", http.StatusInternalServerError)
        return
    }
    templateMap[tplName] = t
}
t.Execute(w, data)

package main

import (
    "html/template"
    "log"
    "net/http" // 引入net/http用于示例
)

var templates *template.Template

func init() {
    // template.ParseGlob("templates/*.html") 会解析 "templates" 目录下所有以 .html 结尾的文件，
    // 并将它们作为命名模板添加到 templates 实例中。每个文件的基础名（如 "welcome.html"）
    // 将作为其在容器中的名称。
    // ParseGlob 会返回一个新的 *Template 实例，如果不需要自定义主模板名称，可以直接使用。
    var err error
    templates, err = template.ParseGlob("templates/*.html")
    if err != nil {
        log.Fatalf("Error loading templates: %v", err) // 应用程序启动失败，记录致命错误
    }

    // 如果需要更精细地控制主模板名称或解析特定文件列表，可以使用：
    // templates, err = template.New("app-base").ParseFiles(
    //     "templates/header.html",
    //     "templates/footer.html",
    //     "templates/welcome.html",
    //     "templates/user.html",
    // )
    // if err != nil {
    //     log.Fatalf("Error loading templates: %v", err)
    // }
}

// IndexHandler 处理根路径请求
func IndexHandler(w http.ResponseWriter, r *http.Request) {
    data := struct {
        Title   string
        Message string
    }{
        Title:   "欢迎",
        Message: "这是我的Go Web应用！",
    }

    // 使用 ExecuteTemplate 方法，指定要渲染的模板名称（例如 "welcome.html"）
    // 并传入数据。
    err := templates.ExecuteTemplate(w, "welcome.html", data)
    if err != nil {
        http.Error(w, "Error rendering template: "+err.Error(), http.StatusInternalServerError)
        return
    }
}

// UserProfileHandler 处理用户资料请求
func UserProfileHandler(w http.ResponseWriter, r *http.Request) {
    data := struct {
        Username string
        Email    string
    }{
        Username: "GoDeveloper",
        Email:    "go.dev@example.com",
    }

    // 渲染 "user.html" 模板
    err := templates.ExecuteTemplate(w, "user.html", data)
    if err != nil {
        http.Error(w, "Error rendering template: "+err.Error(), http.StatusInternalServerError)
        return
    }
}

func main() {
    // 假设存在 templates/welcome.html 和 templates/user.html 文件
    // 例如：
    // mkdir -p templates
    // echo '<h1>{{.Title}}</h1><p>{{.Message}}</p>' > templates/welcome.html
    // echo '<h2>User: {{.Username}}</h2><p>Email: {{.Email}}</p>' > templates/user.html

    http.HandleFunc("/", IndexHandler)
    http.HandleFunc("/user", UserProfileHandler)
    log.Println("Server starting on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}