使用Go模板从main.go向HTML传值时页面空白的问题

页面显示空白的核心原因是Go模板无法访问未导出的结构体字段，同时代码还有几处可优化的地方，具体修复方案如下：

1. 导出结构体字段 #

Go的html/template包仅能访问首字母大写的导出字段，你定义的pageDefaults结构体中cssUrl为小写，模板无法读取该值。需修改字段名并同步模板引用：

修改后的结构体 #

type pageDefaults struct {
    CssUrl string // 首字母大写，转为导出字段
}

修改后的HTML模板 #

<link rel="stylesheet" href="{{.CssUrl}}/test.css" />

2. 预解析模板（优化性能） #

每次请求都调用template.ParseGlob会重复解析模板，影响性能，建议在程序启动时一次性完成解析：

新增初始化逻辑 #

var templates *template.Template

func init() {
    // 启动时预解析所有模板，解析失败直接终止程序
    templates = template.Must(template.ParseGlob("templates/*.html"))
}

3. 避免全局变量（保障并发安全） #

全局的pageDefault变量在并发请求时会出现数据竞争，改为在handler内声明局部变量：

修改后的loginHandler #

func loginHandler(w http.ResponseWriter, r *http.Request) {
    pageData := pageDefaults{
        CssUrl: "hello",
    }
    // 执行模板时检查错误，出错时返回500状态码及错误信息
    err := templates.ExecuteTemplate(w, "sample.html", pageData)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
}

完整修复后的main.go代码 #

package main

import (
    "html/template"
    "net/http"
    "strings"
)

var templates *template.Template

type pageDefaults struct {
    CssUrl string
}

func init() {
    templates = template.Must(template.ParseGlob("templates/*.html"))
}

func loginHandler(w http.ResponseWriter, r *http.Request) {
    pageData := pageDefaults{
        CssUrl: "hello",
    }
    err := templates.ExecuteTemplate(w, "sample.html", pageData)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
}

func handler(w http.ResponseWriter, r *http.Request) {
    switch strings.ToLower(r.URL.Path) {
    case "/login":
        loginHandler(w, r)
    default:
        // 处理未匹配路径，返回404
        http.NotFound(w, r)
    }
}

func main() {
    http.HandleFunc("/", handler)
    http.ListenAndServe(":8080", nil)
}

完成上述修改后，模板即可正确渲染样式表路径，页面不再空白。

内容的提问来源于stack exchange，提问作者Pankaj