根本原因是调用顺序错误：必须先 parsefiles() 或 parseglob() 加载模板，再 execute()；若先 execute()，模板未定义则报 “index.html is undefined”。
为什么 template.ParseFiles() 总是报 template: "index.html" is undefined
根本原因不是文件没找到，而是调用顺序错了：你得先 ParseFiles() 或 ParseGlob()，再用 Execute()；如果反着来，模板树里压根没加载任何定义，Execute() 就找不到 index.html 这个模板名。
常见错误场景：在 main() 里直接 t := template.New("t"); t.Execute(...)，但没调用 ParseFiles() —— 这时 t 是空的，连默认模板都没注册。
- 正确做法：用
template.ParseFiles("templates/index.html", "templates/base.html")，返回值才是可执行的 *template.Template - 如果模板之间有
{{define}}和{{template}}调用，所有被引用的文件必须一次性传给ParseFiles()，不能分两次加载 - 路径是相对于
os.Getwd()的，不是相对于源文件位置；建议用filepath.Join("templates", "index.html")显式拼接，避免隐式依赖工作目录
如何让 Go 模板支持 Markdown 渲染（比如把 content.md 渲染成 HTML）
Go 标准库的 text/template 不解析 Markdown，它只做字符串替换。你需要在 Go 代码里先用第三方库（如 goldmark）把 Markdown 转成 HTML 字符串，再作为字段传入模板上下文 —— 否则直接 {{.Content}} 只会输出原始 Markdown 文本。
典型踩坑：在模板里写 {{.Content | markdown}}，但没注册自定义函数，结果报错 function "markdown" not defined。
立即学习“go语言免费学习笔记（深入）”；
- 推荐方案：用
goldmark+ 自定义模板函数，例如：t.Funcs(template.FuncMap{"md": func(s string) template.HTML { return template.HTML(goldmark.Convert([]byte(s), &bytes.Buffer{})) }}) - 注意返回类型必须是
template.HTML，否则模板会自动转义<p></p>成<p> - 别在模板里反复调用耗时操作（比如每次
{{md .RawContent}}都重新 parse），应该提前在数据准备阶段完成转换
生成静态文件时，如何处理嵌套目录结构（比如 posts/hello-world/index.html）
os.Create() 不会自动创建父目录，直接写 os.Create("public/posts/hello-world/index.html") 会因 posts/hello-world/ 不存在而失败，报错 no such file or directory。
这不是模板问题，是文件系统操作的前置条件没满足。
- 必须先调用
os.MkdirAll(filepath.Dir(path), 0755)，例如：os.MkdirAll("public/posts/hello-world", 0755) - 路径拼接别用字符串拼接，用
filepath.Join("public", "posts", "hello-world", "index.html")，否则 Windows 下反斜杠会导致路径失效 - 如果批量生成，建议统一用
filepath.Walk()扫描源内容目录，按相对路径映射到输出目录，避免硬编码层级逻辑
为什么本地跑得通，部署后 template.Execute() 突然 panic： reflect.Value.Interface(): cannot return value obtained from unexported field or method
这个 panic 和模板无关，是传给 Execute() 的 struct 字段没导出（首字母小写），比如 type Page struct { title string } —— Go 的 reflect 包无法访问未导出字段，模板引擎就炸了。
静态站点生成器常把元信息封装进 struct，容易忽略大小写规则。
- 所有要被模板读取的字段，必须首字母大写：
Title string、Content string、Date time.Time - 如果要用 map，key 必须是 string 类型，且 map 本身不能是
map[string]interface{}里嵌套未导出 struct，否则深层反射仍会失败 - 调试技巧：在
Execute()前加一句fmt.Printf("%#v", data)，看是否能正常打印出字段值 —— 打印不出来基本就是导出问题
模板只是数据管道，它不关心你内容多酷炫，只认导出字段和合法类型。路径、渲染、嵌套目录这些事，全是 Go 运行时和操作系统的事，别指望模板引擎替你兜底。
