模板性能优化关键在于避免耗时逻辑、复用实例、减少嵌套与上下文拷贝，并预加载模板。需提前准备数据、轻量自定义函数、启动时Parse、用with缩小作用域、go:embed加载模板。
避免在 template 中执行耗时逻辑
Go 的 html/template 和 text/template 在执行时是同步阻塞的，模板内任何函数调用都会拖慢整个渲染过程。常见错误是把数据库查询、HTTP 调用、加密解密等操作直接写进自定义函数里，比如：
func getUserByID(id string) *User {
// ❌ 不要在模板中调用这种函数
return db.QueryRow("SELECT * FROM users WHERE id = ?", id).Scan(...)
}正确做法是提前准备好所有数据，只在模板中做简单取值或格式化：
- 将
user.Name、user.AvatarURL等字段预先计算好，避免模板内调用.User.GetDisplayName() - 如需格式化时间，用
time.Format预处理成字符串，而非在模板里调用.CreatedAt.Format "2006-01-02" - 自定义函数应仅做轻量操作：字符串截断、布尔转文本、简单 map 查找等
复用 template.Template 实例，别每次 template.New
反复调用 template.New + Parse 会重复解析模板字符串，产生大量临时对象并触发 GC。生产环境必须复用已解析的 *template.Template。
典型错误写法：
立即学习“go语言免费学习笔记（深入）”；
func handler(w http.ResponseWriter, r *http.Request) {
t := template.New("page").Parse(pageTpl) // ❌ 每次请求都 Parse
t.Execute(w, data)
}正确方式：
- 在程序启动时一次性
Parse（支持嵌套模板，用ParseFiles或ParseGlob） - 全局变量或依赖注入持有
*template.Template，并发安全 - 若需动态子模板，用
t.Lookup("sub.html")而非重新New
慎用 {{template}} 和 {{define}} 嵌套层级
深层嵌套（如 >5 层）会让 Go 模板引擎递归调用变多，同时增加作用域查找开销。更严重的是，每次 {{template "name" .}} 都会复制当前上下文（.），对大结构体造成隐式内存拷贝。
优化建议：
- 用
{{with}}缩小作用域，减少字段查找深度，例如{{with .User}}{{.Name}}{{end}}比{{.User.Name}}更快（尤其当.User是指针时） - 避免在循环内反复
{{template "item" .}}传整个大数据结构，改用{{template "item" $.ItemData}}显式传精简字段 - 静态内容尽量内联，少用
{{define}}分离——除非真需要复用或按条件加载
启用 html/template 的预编译与缓存（Go 1.21+）
Go 1.21 引入了 template.Must 的底层优化，并支持将模板编译为字节码缓存。虽然没有显式 API，但可通过构建时预处理提升冷启动性能：
- 使用
go:embed加载模板文件，避免运行时读磁盘（io/fs本身有缓存） - 配合
template.Must(template.New("").ParseFS(templatesFS, "*.html"))提前解析全部模板 - 禁用调试信息：确保未设置
template.Debug()，它会插入额外跟踪逻辑 - 注意：Go 尚未提供 JIT 编译模板能力，所以“编译”仍指 AST 解析阶段，但复用和 embed 已足够覆盖绝大多数瓶颈
真正卡住性能的，往往不是模板语法本身，而是数据准备方式和实例生命周期管理。模板只是最后一步，别让它替上游背锅。
