Go模板动态加载与同名文件冲突解决方案

var templates = template.Must(template.ParseFiles(
    "templates/index.html",
    "templates/includes/header.html",
    "templates/includes/footer.html",
))

package main

import (
    "fmt"
    "html/template"
    "io/ioutil" // For Go 1.15 and earlier
    "log"
    "net/http"
    "os"
    "path/filepath"
    "strings"
)

var templates *template.Template

func init() {
    // 创建一个空的模板集合，作为所有子模板的容器
    templates = template.New("master") 

    // 遍历 'files' 目录及其子目录
    err := filepath.Walk("files", func(path string, info os.FileInfo, err error) error {
        if err != nil {
            return err // 处理访问错误
        }
        if info.IsDir() {
            return nil // 跳过目录
        }

        // 检查文件扩展名，确保只处理模板文件（例如 .html）
        if !strings.HasSuffix(path, ".html") {
            return nil
        }

        // 读取文件内容
        content, err := os.ReadFile(path) // Go 1.16+ 推荐使用 os.ReadFile
        // content, err := ioutil.ReadFile(path) // Go 1.15 及更早版本使用 ioutil.ReadFile
        if err != nil {
            return fmt.Errorf("无法读取文件 %s: %w", path, err)
        }

        // 为每个模板文件生成一个唯一的名称
        // 通常使用相对于模板根目录的路径作为名称
        relativePath, err := filepath.Rel("files", path)
        if err != nil {
            return fmt.Errorf("无法获取文件 %s 的相对路径: %w", path, err)
        }
        templateName := relativePath // 例如: "index.html", "subfolder/index.html"

        // 将文件内容解析为一个新的具名模板，并添加到模板集合中
        // templates.New(templateName) 创建一个名为 templateName 的新模板实例
        // .Parse(string(content)) 将文件内容解析到这个新模板中
        _, err = templates.New(templateName).Parse(string(content))
        if err != nil {
            return fmt.Errorf("解析模板 %s 失败 (%s): %w", templateName, path, err)
        }
        log.Printf("已加载模板: %s (源文件: %s)", templateName, path)
        return nil
    })

    if err != nil {
        log.Fatalf("遍历模板目录时发生错误: %v", err)
    }
}

func main() {
    http.HandleFunc("/", homeHandler)
    http.HandleFunc("/subfolder/", subfolderHandler) // 示例：处理子文件夹中的模板
    log.Println("服务器启动在 :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

func homeHandler(w http.ResponseWriter, r *http.Request) {
    // 渲染 "files/index.html" 模板，其名称为 "index.html"
    renderTemplate(w, "index.html")
}

func subfolderHandler(w http.ResponseWriter, r *http.Request) {
    // 渲染 "files/subfolder/index.html" 模板，其名称为 "subfolder/index.html"
    renderTemplate(w, "subfolder/index.html")
}

func renderTemplate(w http.ResponseWriter, tmpl string) {
    // 执行指定名称的模板
    err := templates.ExecuteTemplate(w, tmpl, nil)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        log.Printf("执行模板 %s 失败: %v", tmpl, err)
    }
}

files/
├── index.html
├── includes/
│   └── header.html
└── subfolder/
    └── index.html