必须一次性用template.ParseFiles按顺序加载全部模板，layouts目录在前、页面模板在后；多次ParseGlob会覆盖已定义模板导致{{template}}引用失败panic。
直接用 html/template 渲染，别指望 Echo 自带“模板引擎”——它压根没内置，所有渲染逻辑得你自己搭，而且顺序错了立刻 500。
为什么 c.Render() 一调就 panic？
因为你在多次调用 template.ParseGlob，比如先加载 views/layouts/*，再加载 views/users/*。第二次调用会完全丢弃第一次解析的所有 {{define}} 模板（像 "header"、"default"），导致 index.tmpl 里 {{template "default"}} 找不到定义，直接 panic。
-
template.ParseGlob返回的是新*template.Template实例，不是追加到已有实例 - 所有被
{{template}}引用的命名模板，必须在同一个*template.Template中注册 - 布局模板（如
base.tmpl）必须比页面模板（如index.tmpl）更早定义，否则子模板无法继承
怎么一次性加载全部模板文件？
用 template.ParseFiles 显式传入所有路径，确保顺序可控。 layouts 目录必须放在前面，users 放后面：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
func loadTemplates() *template.Template {
layoutFiles, _ := filepath.Glob("views/layouts/*.tmpl")
userFiles, _ := filepath.Glob("views/users/*.tmpl")
allFiles := append(layoutFiles, userFiles...) // layouts 在前！
t := template.Must(template.New("base").ParseFiles(allFiles...))
return t
}
- 不要用
ParseGlob多次；也不要混用ParseFiles和ParseGlob - 文件扩展名统一（比如都用
.tmpl），避免漏匹配 - 如果模板里用了自定义函数（如
urlFor），要在template.New()后立刻用.Funcs()注册
怎么让 Echo 正确调用这个模板？
实现 echo.Renderer 接口，把你的 *template.Template 绑定进去：
e := echo.New()
e.Renderer = &Template{templates: loadTemplates()}
其中 Template 类型要实现 Render 方法：
type Template struct {
templates *template.Template
}
func (t *Template) Render(w io.Writer, name string, data interface{}, c echo.Context) error {
return t.templates.ExecuteTemplate(w, name, data)
}
-
name是模板文件名（不含路径），比如"index.tmpl"，但前提是该文件里有{{define "index.tmpl"}}或默认定义（文件名即模板名） - 如果想用
{{template "header"}}这种命名引用，对应文件里必须有{{define "header"}}，且该文件已被ParseFiles加载 - 不建议在模板里用
{{template "index.tmpl"}}这种带扩展名的写法，容易和定义名混淆；统一用{{define "index"}}更安全
容易被忽略的细节
模板路径是相对进程启动目录的，不是相对于 main.go；filepath.Glob 不会递归匹配子目录；ExecuteTemplate 的第一个参数是模板名（name），不是文件路径——它只从已注册的命名模板中查找，找不到就 panic，不会自动去磁盘读文件。
