Go中使用ParseFiles加载双模板时数据传递失败及执行报错问题

第一个代码的问题（能生成页面但无法传递数据） #

你的config.html里的{{.}}拿不到数据，核心原因是布局模板template.html调用子模板时没有传递数据。

假设你的template.html是类似这样的结构：

<!DOCTYPE html>
<html>
<head>
    <title>{{template "title"}}</title>
</head>
<body>
    {{template "body"}}
</body>
</html>

这里调用{{template "title"}}和{{template "body"}}时没有传递当前上下文（即.)，导致子模板里的{{.}}无法获取到你传入的vd数据。

修复方法 #

修改template.html，在调用子模板时加上数据传递：

<!DOCTYPE html>
<html>
<head>
    <title>{{template "title" .}}</title>
</head>
<body>
    {{template "body" .}}
</body>
</html>

然后保留第一个代码的逻辑（解析两个模板文件，执行template.html），就能正常传递数据了。

第二个代码的错误（报错template: no template "config.html" associated with template "config.html"） #

你用template.New("config.html").ParseFiles(...)的写法完全没必要，反而会导致模板集混乱：

1. ParseFiles方法会自动根据文件名创建模板，你提前New的模板名会和文件生成的模板名冲突。
2. config.html里全是{{define}}块，没有主模板内容，就算你能执行它，也只会输出空内容。
3. 你执行tmpl.ExecuteTemplate(w, tmpl.Name(), vd)时，tmpl.Name()是你New的config.html，但这个模板本身没有任何可执行内容，所以触发错误。

修复方法 #

直接删掉多余的New调用，回到第一个代码的解析逻辑，同时确保布局模板正确传递数据即可。

最终正确代码 #

func config(w http.ResponseWriter, r *http.Request) {
    fpTemplate := filepath.Join("static", "template.html")
    fpPage := filepath.Join("static", "config.html")

    // 解析两个模板文件，模板集包含template.html和config.html两个模板
    tmpl, err := template.ParseFiles(fpTemplate, fpPage)
    if err != nil {
        log.Println("webserver.config: " + err.Error())
        http.Error(w, "Internal Server Error", http.StatusInternalServerError)
        return
    }

    vd := ViewData{&Settings}

    // 执行布局模板template.html，它会自动引用config.html里定义的title和body块
    err = tmpl.ExecuteTemplate(w, "template.html", vd)
    if err != nil {
        log.Println("webserver.config: " + err.Error())
        http.Error(w, "Internal Server Error", http.StatusInternalServerError)
    }
}

另外，建议在错误处理时加上http.Error，让客户端能收到正确的错误响应，而不是只打日志。

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