Go 的 text/template 不具备自动转义等高级功能，需注意字段导出规则：仅首字母大写的结构体字段可被模板访问，小写字段会触发 reflect.Value.Interface panic；html/template 则默认启用 HTML 转义。
Go 标准库的 text/template 不是“模板引擎”意义上的黑盒工具，它没有自动转义、继承、宏、缓存管理等高级功能；直接当类 Jinja/Django 模板用，会踩坑。
为什么 template.Execute 总是报 reflect.Value.Interface: cannot return value obtained from unexported field or method
这是最常卡住新手的错误——Go 的模板只能访问结构体的导出字段（首字母大写）。哪怕你写了 type User struct { Name string; age int }，age 在模板里就是不可读的，连 {{.age}} 都会触发这个 panic。
- 检查所有被传入模板的数据结构，确保要渲染的字段名首字母大写
- 不要依赖 IDE 自动生成的 struct 字段命名（比如从 JSON 反序列化时用了
json:"age"但字段仍是小写） - 临时调试可用
fmt.Printf("%#v", data)看实际反射可见的字段 - 如果必须用小写字段，改用 map[string]interface{} 或加 Getter 方法（如
Age() int { return u.age }），并在模板中调用{{.Age}}
text/template 和 html/template 到底该用哪个？
二者 API 几乎一致，核心区别只在默认转义行为：html/template 对 {{.}} 插值自动做 HTML 转义（把 变成 ），而 text/template 完全不处理。
- 生成 HTML 页面？必须用
html/template，否则 XSS 风险直线上升 - 生成纯文本、JSON、SQL、邮件正文、配置文件？用
text/template更干净，避免多余转义干扰格式 - 别混用：用
html/template渲染 Markdown 或 SQL 会导致内容被破坏；反过来用text/template渲染用户输入的 HTML 字段，等于裸奔 - 两者不能互相替换 import，类型不兼容——
html.Template和text.Template是不同类型
{{range}} 里怎么安全取数组/切片长度或判断空？
range 本身不提供 “当前集合是否为空” 的快捷判断，也不能在 range 块外直接用 .Len（除非是 slice 类型且字段导出）；常见误写 {{if .Items}}{{range .Items}}...{{end}}{{else}}空{{end}} 有问题——如果 .Items 是 nil，{{if .Items}} 为 false，但 {{range .Items}} 却会 panic。
- 正确做法：先用
{{if .Items}}判断非 nil，再用{{if len .Items}}判断长度（len是模板内置函数，对 slice/map/channel 都有效） - 更稳妥：统一用
{{with .Items}}{{if .}}{{range .}}...{{end}}{{else}}空{{end}}{{end}}，with既判 nil 也判零值 - 注意：
len对 map 返回键数量，对 channel 返回当前缓冲长度，对 string 返回 UTF-8 字节数（不是 rune 数）
模板定义和解析的时机影响性能和并发安全
template.Parse 是昂贵操作，涉及词法分析、语法树构建；而 template.Execute 是轻量级的。很多人在 HTTP handler 里每次请求都 Parse 同一个模板字符串，白白拖慢吞吐。
- 模板内容不变？启动时一次性
Parse并复用*template.Template实例（它是并发安全的） - 需要动态加载文件？用
template.ParseFiles或template.New(...).Funcs(...).ParseFiles(...)，但别在热路径反复调用 - 模板含自定义函数？务必在
Parse前通过Funcs注册；Parse后注册无效 - 调试时加
Err检查：t, err := template.New("x").Parse(src); if err != nil { log.Fatal(err) }，忽略错误会导致静默失败
真正难的不是语法，而是想清楚「谁控制数据结构导出性」「谁负责转义边界」「模板生命周期由谁管理」——这些决定比 {{if}} 多嵌套一层更影响项目长期可维护性。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
