使用Go的html/template时，移除template.New()为何能正常运行？

问题场景 #

用html/template解析结构体JSON时，最初代码通过template.New("template01").ParseFiles("template01.tmpl")创建模板，SearchIssues函数能正常转换流为JSON，但访问本地服务时触发错误：XXX is an incomplete or empty template。移除New("template01").，直接调用template.ParseFiles("template01.tmpl")后，程序正常运行。

问题原因 #

template.New("name")会生成一个空的、名为name的模板实例。后续调用ParseFiles时，虽然会解析指定的模板文件，但这个空模板并不会被覆盖——ParseFiles会将每个文件解析为独立模板，模板名称默认为文件名（不含路径），也就是template01.tmpl。此时如果尝试渲染最初用New创建的template01模板，它依然是空的，自然会触发“不完整或空模板”的错误。

而直接调用template.ParseFiles("template01.tmpl")时，函数会自动将解析后的模板以template01.tmpl作为名称，并返回这个包含有效内容的模板实例，渲染时就能正常找到模板内容。

解决办法 #

方法1：直接使用template.ParseFiles（推荐）

这是你已经验证有效的方式，代码示例：

tpl, err := template.ParseFiles("template01.tmpl")
if err != nil {
    // 错误处理逻辑，比如log.Fatal(err)
}
// 渲染模板到响应流
err = tpl.Execute(w, yourDataStruct)

方法2：保留template.New但指定正确的渲染模板

如果必须使用template.New，需要确保渲染的是ParseFiles生成的有效模板（即文件名对应的模板），代码示例：

// 创建空模板实例
tpl := template.New("template01")
// 解析模板文件，返回包含多个模板的集合
tpl, err := tpl.ParseFiles("template01.tmpl")
if err != nil {
    // 错误处理
}
// 查找文件名对应的有效模板
actualTemplate := tpl.Lookup("template01.tmpl")
if actualTemplate == nil {
    // 模板不存在的错误处理
}
// 渲染有效模板
err = actualTemplate.Execute(w, yourDataStruct)

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