go中实现类似django的模板继承时，若未正确关联模板（如误用`template.parsefiles()`函数而非`template.parsefiles()`方法），会导致`{{template "content"}}`无法被渲染，最终返回空页面。
在 Go 的 html/template 包中，模板继承依赖于模板间的显式关联——即子模板（如 index.html）必须与基础模板（如 base.html）属于同一个模板集合（*template.Template 实例），才能通过 {{template "NAME" .}} 正确引用已定义的区块（如 "CONTENT"）。你当前代码的核心问题在于：错误地多次调用顶层函数 template.ParseFiles()，导致每次创建完全独立的新模板，彼此失联。
✅ 正确做法：复用同一 *template.Template 实例并调用其方法
将模板解析逻辑从请求处理函数中移出，改为应用启动时一次性完成，并使用 tmpl.ParseFiles()（方法）而非 template.ParseFiles()（函数）：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
var TmplBasePath = "templates/"
var BasePageTmplPath = []string{TmplBasePath + "base.html"}
var IndexTmplPath = TmplBasePath + "index.html"
// 全局变量，存储预解析的模板集合
var tmpl *template.Template
func init() {
// 1. 创建根模板（名称可任意，但需唯一）
tmpl = template.New("root")
// 2. 使用方法 ParseFiles —— 所有解析的模板将关联到 tmpl
tmpl = template.Must(tmpl.ParseFiles(BasePageTmplPath...))
tmpl = template.Must(tmpl.ParseFiles(IndexTmplPath))
// 3. 注册路由
http.HandleFunc("/", home)
}
type Page struct {
Title string
Ctx appengine.Context // 若非 App Engine 环境可省略或替换为 log
}
func NewPage(r *http.Request, title string) *Page {
return &Page{Title: title}
}
func (p *Page) Display(w http.ResponseWriter, tmplName string) {
// 关键：执行指定名称的模板（如 "index.html"），它会自动查找并渲染 "PAGE" 和 "CONTENT"
if err := tmpl.ExecuteTemplate(w, tmplName, p); err != nil {
// 注意：p.Ctx 可能为 nil，建议加判空；生产环境应返回 HTTP 500 并记录日志
http.Error(w, "Template error", http.StatusInternalServerError)
log.Printf("Template execution error: %v", err)
}
}
func home(w http.ResponseWriter, r *http.Request) {
p := NewPage(r, "Home")
p.Display(w, "index.html") // ← 此处传入的是文件名（即模板名），必须与 ParseFiles 中的路径 basename 一致
}⚠️ 关键注意事项
- 命名一致性：template.ParseFiles() 会自动以文件 basename（不含扩展名）作为模板名。因此 index.html 解析后模板名为 "index"，但 ExecuteTemplate(w, "index.html", ...) 仍可工作（Go 会尝试匹配），推荐统一使用 "index" 以避免歧义。
- ExecuteTemplate 而非 Execute：tmpl.Execute(w, data) 会尝试执行根模板（即 New("root") 中指定的名称），但你并未定义名为 "root" 的 {{define "root"}}；而 ExecuteTemplate(w, "index", data) 明确指定入口模板，它会按依赖关系自动展开 {{template "PAGE"}} 和 {{template "CONTENT"}}。
- 性能与内存：切勿在 http.HandlerFunc 中重复 ParseFiles —— 模板解析开销大且产生大量临时对象，严重拖慢响应并增加 GC 压力。务必在 init() 或 main() 中一次性完成。
- 基础模板中的 {{define "PAGE"}}：你当前 base.html 中定义了 "PAGE"，但 index.html 并未 {{template "PAGE"}}，而是期望被 base.html 的 {{template "CONTENT"}} 引用。这是正确的 Django 风格继承逻辑（base.html 定义骨架，index.html 提供内容区块），无需修改。
✅ 验证你的模板结构
确保 base.html 和 index.html 位于 templates/ 目录下，且无拼写错误。运行后访问 /，应看到完整 HTML 结构包裹 <h1>Welcome to Expat Duka</h1>。
? 进阶提示：可进一步封装为 TemplateSet 类型，支持自动发现子目录、热重载（开发期）或嵌套布局（如 base.html → layout.html → index.html），但核心原则始终不变：*所有参与继承的模板必须属于同一个 `template.Template` 实例**。
