Golang中sprig与html/template解析模板失效问题求助

错误原因1：ParseFiles结合New("test")导致执行空模板 #

当你调用htmlTemplate.New("test").Funcs(...).ParseFiles(tempPath)时：

• New("test")创建了一个空的、名为"test"的模板
• ParseFiles(tempPath)会解析指定文件，并在模板集合中新增一个以文件基名为名称的模板（比如tempPath是template.html，新增的模板名就是template.html）
• 此时模板集合里有两个模板：空的"test"和有内容的文件基名模板
• 当你执行模板时（比如tmpl.Execute(w, data)），默认会执行你最初创建的"test"模板，自然输出空白

错误原因2：Parse方法直接解析了路径字符串 #

Parse方法的参数是模板内容字符串，你传入tempPath（文件路径），它会把路径本身当成模板内容解析，所以PDF里显示的就是路径文本。

正确解决方案 #

方案1：修正ParseFiles的使用方式 #

不需要手动指定初始模板名，让ParseFiles自动处理，同时绑定sprig函数：

import "path/filepath"

// 先创建空模板，绑定sprig函数，再解析文件
tmpl := htmlTemplate.Must(htmlTemplate.New("").Funcs(sprig.FuncMap()).ParseFiles(tempPath))
// 执行时，因为只有一个模板，直接调用Execute即可
err := tmpl.Execute(w, yourData)
// 或者明确指定文件基名作为模板名
err := tmpl.ExecuteTemplate(w, filepath.Base(tempPath), yourData)

方案2：读取文件内容后用Parse解析 #

先读取模板文件的内容，再传入Parse方法，同时指定模板名：

import "os"

// 读取模板文件内容
content, err := os.ReadFile(tempPath)
if err != nil {
    // 处理错误，比如返回500
    http.Error(w, err.Error(), http.StatusInternalServerError)
    return
}
// 创建模板、绑定sprig函数、解析内容
tmpl := htmlTemplate.Must(htmlTemplate.New("test").Funcs(sprig.FuncMap()).Parse(string(content)))
// 执行模板
err := tmpl.Execute(w, yourData)

方案3：将文件内容解析到指定模板名 #

如果你想保留指定的模板名，可以先创建模板，绑定函数，再读取文件内容并解析到该模板：

import "os"

tmpl := htmlTemplate.New("test").Funcs(sprig.FuncMap())
content, err := os.ReadFile(tempPath)
if err != nil {
    http.Error(w, err.Error(), http.StatusInternalServerError)
    return
}
tmpl = htmlTemplate.Must(tmpl.Parse(string(content)))
tmpl.Execute(w, yourData)

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