当前位置：首页 > 文章列表 > Golang > Go教程 > Go embed.FS 配合 fs.Glob 怎么批量加载模板

Go embed.FS 配合 fs.Glob 怎么批量加载模板

来源：17golang原创 2026-09-10 10:18:14 0浏览收藏

如果模板已经随程序一起发布，推荐把目录交给 embed.FS，再用 fs.Glob 收集匹配文件，最后一次性传给 html/template。关键点有两个：//go:embed templates 负责把目录树放进二进制，fs.Glob 负责运行时按模式找文件；它不会把 ** 当成任意层级通配符。

要点速览

用 //go:embed templates 嵌入整个模板目录，路径使用正斜杠。
fs.Glob 找不到文件时返回空列表；模式写错才返回 path.ErrBadPattern。
单层目录用 templates/*.tmpl，多层目录不要写 **，任意深度改用 fs.WalkDir。

先把模板目录嵌入成一个只读文件系统

embed.FS 实现了 io/fs.FS，因此它可以交给标准库中接受 fs.FS 的 API。嵌入目录时，//go:embed templates 会把该目录下的文件树放进程序；它与开发机上的工作目录无关，部署时不会因为当前目录变化而找不到模板。

下面的目录假设为 templates/home.tmpl、templates/layout.tmpl 和 templates/admin.tmpl：

package main

import (
    "embed"
    "fmt"
    "html/template"
    "io/fs"
    "log"
)

// 把 templates 目录作为只读文件系统嵌入二进制。
//go:embed templates
var templateFS embed.FS

func loadTemplates() (*template.Template, error) {
    // 只匹配 templates 目录这一层的 .tmpl 文件。
    matches, err := fs.Glob(templateFS, "templates/*.tmpl")
    if err != nil {
        return nil, fmt.Errorf("匹配模板模式失败: %w", err)
    }
    if len(matches) == 0 {
        return nil, fmt.Errorf("没有找到模板: templates/*.tmpl")
    }

    // matches 是嵌入文件的完整 fs 路径，直接批量解析。
    parsed, err := template.New("site").ParseFS(templateFS, matches...)
    if err != nil {
        return nil, fmt.Errorf("解析模板失败: %w", err)
    }
    return parsed, nil
}

func main() {
    if _, err := loadTemplates(); err != nil {
        log.Fatal(err)
    }
}

这里没有把 templateFS 转成操作系统路径。fs.Glob 返回的正是 io/fs 里的逻辑路径，后续交给 ParseFS 时应保持同样的斜杠和目录前缀。

fs.Glob 的返回值要分成三种情况

不要只写 matches, _ := fs.Glob(...)。这个函数的返回值包含重要边界：

情况	matches	err	处理建议
找到文件	非空路径列表	nil	交给 ParseFS 批量解析
没有匹配	nil 或空列表	nil	按必选模板或可选模板决定是否报错
模式非法	通常为空	path.ErrBadPattern	修正模式，不要当成“目录为空”

fs.Glob 会忽略遍历目录时遇到的普通文件系统错误，唯一可能返回的错误是非法模式。因此生产代码仍应检查 err，并对空列表做业务判断，否则模板漏打包时可能直到请求到达页面才暴露问题。

Go embed.FS、fs.Glob 与模板解析之间的嵌入资源边界和匹配关系框图 — 图1：嵌入资源边界中，embed.FS 提供文件树，fs.Glob 产出匹配路径，模板解析只消费已确认的文件集合。

批量解析时，模式范围决定了模板集合

templates/*.tmpl 中的星号不跨越斜杠，所以它只匹配 templates 根目录下的模板。若有一层子目录，例如 templates/admin/user.tmpl，可以显式使用 templates/*/*.tmpl，也可以分两次收集后合并：

// 先匹配根目录，再匹配固定的一层子目录。
rootMatches, err := fs.Glob(templateFS, "templates/*.tmpl")
if err != nil {
    return nil, fmt.Errorf("匹配根模板失败: %w", err)
}

adminMatches, err := fs.Glob(templateFS, "templates/admin/*.tmpl")
if err != nil {
    return nil, fmt.Errorf("匹配后台模板失败: %w", err)
}

allMatches := append(rootMatches, adminMatches...)
if len(allMatches) == 0 {
    return nil, fmt.Errorf("模板集合为空")
}

// 传入具体文件名，避免 ParseFS 再次扩大匹配范围。
parsed, err := template.New("site").ParseFS(templateFS, allMatches...)
if err != nil {
    return nil, fmt.Errorf("批量解析模板失败: %w", err)
}

不要把 templates/**/*.tmpl 当作递归写法。Go 的 path.Match 没有 globstar 规则，它不会像某些 shell 工具那样自动遍历任意层级。目录深度不固定时，应使用 fs.WalkDir 收集后缀为 .tmpl 的文件，再把收集到的具体路径交给解析器。