模板的本质

Go 的模板是「数据 + 模板 + 函数映射」三者结合的结果,渲染过程就是一次受控的求值。

三个核心概念

  • define:声明一个具名模板
  • template:在当前位置插入另一个模板
  • FuncMap:注册自定义函数
tmpl := template.Must(template.New("index").
    Funcs(funcMap).
    ParseFS(fs, "theme/*.tmpl"))

上下文是一个 map

主题拿到的上下文通常是 map[string]interface{},所以访问不存在的键不会报错,只会输出空值。

{{ if .prevPost }}上一篇{{ end }}

安全与转义

默认情况下所有输出都会被 HTML 转义,需要输出富文本时必须显式声明:

{{ noescape .post.Content }}

这也是主题开发中最容易踩的坑:正文被转义成一片乱码。

小结

理解了模板的求值方式,读懂任何 Go 博客主题都不难。