Go模板渲染报错template "base" not defined问题求助

问题根因 #

构建模板缓存时，每个HTML文件被单独解析为独立的模板集合，页面模板home.gohtml的解析上下文没有包含定义了base模板的base.layout.gohtml，因此渲染时找不到对应模板。

修复步骤 #

1. 调整模板缓存构建逻辑 #

修改CreateTemplateCache函数，解析页面模板时同时加载所有布局模板：

func CreateTemplateCache() (map[string]*template.Template, error) {
    templateCache := map[string]*template.Template{}
    // 先收集所有布局模板路径
    var layouts []string
    err := filepath.Walk("./templates/partials", func(path string, info fs.FileInfo, err error) error {
        if !info.IsDir() {
            layouts = append(layouts, path)
        }
        return err
    })
    if err != nil {
        return templateCache, err
    }

    // 遍历处理所有业务页面模板
    err = filepath.Walk("./templates", func(path string, info fs.FileInfo, err error) error {
        // 跳过布局目录避免重复处理
        if info.IsDir() && info.Name() == "partials" {
            return filepath.SkipDir
        }
        if !info.IsDir() {
            name := filepath.Base(path)
            // 同时解析当前页面 + 所有布局模板
            files := append([]string{path}, layouts...)
            templateSet, err := template.New(name).Funcs(functions).ParseFiles(files...)
            if err != nil {
                return err
            }
            templateCache[name] = templateSet
        }
        return err
    })
    if err != nil {
        return templateCache, err
    }

    return templateCache, nil
}

2. 调整页面模板代码顺序 #

home.gohtml中需要先定义继承的块，再调用父模板，避免父模板渲染时子块未定义：

{{define "content"}}
   <p>hey</p>
{{end}}  

{{template "base" .}}

性能优化建议 #

当前RenderTemplate每次请求都会重新遍历文件生成缓存，性能消耗极高，建议在程序启动时一次性初始化模板缓存，全局复用：

// 全局模板缓存
var tplCache map[string]*template.Template

// 程序启动时初始化缓存
func init() {
    var err error
    tplCache, err = CreateTemplateCache()
    if err != nil {
        log.Fatalf("模板缓存初始化失败: %v", err)
    }
}

func RenderTemplate(w http.ResponseWriter, templateName string) {
    template, ok := tplCache[templateName]
    if !ok {
        log.Fatalf("指定模板%s不存在", templateName)
    }
    err := template.Execute(w, nil)
    if err != nil {
        log.Fatal(err)
    }
}

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