应使用 html/template 渲染 html 并将可信内容转为 template.html 类型，text/template 仅适用于纯文本且不支持 safehtml；模板需预编译并缓存，避免每次请求解析；嵌套访问应提前扁平化数据以减少反射开销。
模板变量没渲染出来？检查数据传入方式是否合法
Go 的 text/template 不会自动展开局部变量或未导出字段，常见错误是传 nil 或匿名结构体却在模板里写 {{.Name}}——它根本找不到字段。
- 传结构体：字段必须首字母大写（导出），例如
type User { Name string } - 传
map[string]interface{}：键名要和模板中{{.Name}}完全一致 - 传单值（如字符串）：模板里只能用
{{.}}，不能加字段访问
HTML 内容被转义成 ？别用 text/template 做 HTML 渲染
text/template 默认对所有输出做 HTML 实体转义，且不提供 safeHTML 这类函数——它压根不是为 HTML 设计的。试图绕过转义（比如用 {{. | safeHTML}}）会失败，因为该函数只存在于 html/template 包。
- 正确做法：改用
html/template，并把可信 HTML 字符串包装成 template.HTML 类型
- 错误做法：在
text/template 中硬塞 HTML 片段，结果全是 <p></p>
- 如果只是纯文本（日志、邮件正文、配置生成），
text/template 安全又够用
每次请求都 Parse 模板？性能瓶颈就在这儿
模板解析（template.ParseFiles 或 template.New(...).Parse(...)）是 CPU 密集操作，涉及词法分析、AST 构建和函数校验。反复调用会让 QPS 直线下跌。
- 启动时一次性加载：用
template.Must(template.ParseGlob("templates/*.tmpl"))
- 缓存到全局变量或依赖容器里，后续直接
tmpl.Execute(w, data)
- 开发阶段需热更新？自己实现文件监听 + 原子替换，不要在 handler 里
Parse
嵌套结构体 + index + field 访问太多？执行时反射开销会飙升
html/template 和 text/template 在运行时对字段访问、切片索引、接口断言等都依赖反射。越深的嵌套、越动态的访问（如 {{index .Items 0}}、{{.User.Profile.Name}}），越拖慢渲染速度。
- 业务层提前扁平化数据：把
User.Profile.Name 提前赋值给 UserName
- 避免在模板里做计算或条件链：比如
{{if and .A .B}}...{{end}} 比 {{if .A}}{{if .B}}...{{end}}{{end}} 稍快，但最好全移到 Go 层
- 纯变量替换场景（无逻辑）可考虑
fasttemplate：它不解析语法树，直接字符串替换，快一个数量级
模板预编译和数据扁平化这两步，实际项目里最容易被跳过；而 HTML 转义问题，又常被当成“小 bug”临时 patch，结果线上被 XSS 利用。
text/template 默认对所有输出做 HTML 实体转义，且不提供 safeHTML 这类函数——它压根不是为 HTML 设计的。试图绕过转义（比如用 {{. | safeHTML}}）会失败，因为该函数只存在于 html/template 包。
- 正确做法：改用
html/template，并把可信 HTML 字符串包装成template.HTML类型 - 错误做法：在
text/template中硬塞 HTML 片段，结果全是<p></p> - 如果只是纯文本（日志、邮件正文、配置生成），
text/template安全又够用
每次请求都 Parse 模板？性能瓶颈就在这儿
模板解析（template.ParseFiles 或 template.New(...).Parse(...)）是 CPU 密集操作，涉及词法分析、AST 构建和函数校验。反复调用会让 QPS 直线下跌。
- 启动时一次性加载：用
template.Must(template.ParseGlob("templates/*.tmpl")) - 缓存到全局变量或依赖容器里，后续直接
tmpl.Execute(w, data) - 开发阶段需热更新？自己实现文件监听 + 原子替换，不要在 handler 里
Parse
嵌套结构体 + index + field 访问太多？执行时反射开销会飙升
html/template 和 text/template 在运行时对字段访问、切片索引、接口断言等都依赖反射。越深的嵌套、越动态的访问（如 {{index .Items 0}}、{{.User.Profile.Name}}），越拖慢渲染速度。
- 业务层提前扁平化数据：把
User.Profile.Name提前赋值给UserName - 避免在模板里做计算或条件链：比如
{{if and .A .B}}...{{end}}比{{if .A}}{{if .B}}...{{end}}{{end}}稍快，但最好全移到 Go 层 - 纯变量替换场景（无逻辑）可考虑
fasttemplate：它不解析语法树，直接字符串替换，快一个数量级
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
