golang template模板 template: xxx.html is an incomplete or empty template 解决方法

当我们在使用go语言中的template渲染多个模板文件时，如果我们使用的模板文件没有使用 ParseFiles方法进行解析就直接在模板里面使用 template进行嵌套的话就会出现 template: xxx.html is an incomplete or empty template 的异常。

解决方法：在我们使用的时候先将可能用到的模板文件全部扫描后用ParseFiles进行解析以下即可。

tplFile = "index.html"
wr := bytes.NewBufferString("")
data:= make(map[string]interface{})


// 先获取所有待使用的模板文件列表
var tplFiles []string
filepath.WalkDir("templates", func(path string, d fs.DirEntry, err error) error {
	if !d.IsDir() && strings.HasSuffix(d.Name(), ".html") {
		// 非目录,且是.html结尾的文件加入到模板文件列表
		tplFiles = append(tplFiles, path)
	}
	return nil
})


t := template.New("") // 获取Template对象，注意这里名称 可为空，也可以指定名称

tpl, err := t.ParseFiles(tplFiles...) // 解析所有的模板文件

tpl.ExecuteTemplate(wr, tplFile, data) // 渲染指定的模板文件

//tpl.Execute(buf,data) // 渲染template.New("xxx.html")这里指定的模板文件

核心问题就是将所有可能用到的模板在模板渲染之前都解析以下。 tpl, err := t.ParseFiles(tplFiles...) // 解析所有的模板文件

ParseFiles方法原型定义和说明

func (t *template.Template) ParseFiles(filenames ...string) (*template.Template, error)

ParseFiles parses the named files and associates the resulting templates with t. If an error occurs, parsing stops and the returned template is nil; otherwise it is t. There must be at least one file.

When parsing multiple files with the same name in different directories, the last one mentioned will be the one that results.

ParseFiles returns an error if t or any associated template has already been executed.