必须检查 template.Execute 的返回 error，它包含带行号和模板名的详细错误信息，而非依赖 panic 堆栈；自定义函数应避免返回 error，或用双值返回配合模板判断；嵌套模板需用 template.New 显式命名以精确定位错误。
模板执行时 panic 了，怎么抓到具体哪行出错
Go 的 template.Execute 和 template.ExecuteTemplate 在遇到数据类型不匹配、字段不存在、函数调用失败时，**默认直接 panic**，不会返回错误。你看到的堆栈里只有 template.(*Template).Execute 这一层，根本看不出是 {{.User.Name}} 还是 {{index .Items 100}} 搞的鬼。
关键做法：别等 panic，改用 template.Execute 的返回值——它其实**总是返回 error**，只是很多人忽略它：
err := t.Execute(w, data)
if err != nil {
// 这里就能拿到带行号和模板名的错误，比如：
// template: user.html:12:23: executing "body" at <.User.Name>: can't evaluate field Name in type *main.User
log.Printf("render error: %v", err)
http.Error(w, "Internal Error", http.StatusInternalServerError)
return
}常见踩坑点：
- 在
http.HandlerFunc里只写了t.Execute(w, data)，没接err，结果 panic 后 500 页面连日志都看不到 - 用
template.Must包裹Parse是对的，但它**不处理执行期错误**，执行时照样崩 - 错误信息里的行号是模板文件内的物理行号，不是 Go 源码行号，查错时务必打开对应
.html文件定位
模板里调用自定义函数出错，为什么 error 被吞了
当你注册了类似 func(s string) string 这样的函数到模板，但函数内部 panic 或返回 error，而你又没在模板里显式检查，Go 模板引擎会静默丢弃错误，甚至渲染出空字符串或零值，而不是报错。
立即学习“go语言免费学习笔记（深入）”；
正确姿势：自定义函数**不要直接返回 error**，而是把错误转成可渲染的提示（开发环境）或兜底值（生产环境）：
func formatTime(t time.Time) string {
if t.IsZero() {
return "(invalid time)"
}
return t.Format("2006-01-02")
}
// 注册
t.Funcs(template.FuncMap{"formatTime": formatTime})如果真需要暴露错误（比如调试），就让函数返回两个值：string, error，然后在模板里用 with 或 if 判断：
{{with $result, $err := .FormatTime .Time}}
{{if $err}}[ERR: {{$err}}]{{else}}{{$result}}{{end}}
{{else}}(no result){{end}}注意：template.FuncMap 的函数签名必须是导出的、参数类型明确的，且**不能有未导出参数或返回未导出类型**，否则 Parse 阶段就 panic。
嵌套模板（define / template）出错，错误定位难怎么办
用 {{define "header"}}...{{end}} 和 {{template "header" .}} 时，一旦子模板出错，错误信息里显示的行号是**被 include 的那个文件的行号**，但你可能根本不知道当前执行到了哪个 template 调用链。
解决方法很实在：给每个 template 调用加命名空间前缀，或者用 template.New 显式创建子模板实例：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
// 不推荐：所有模板共享一个 *template.Template 实例
t, _ := template.ParseFiles("base.html", "user.html")
<p>// 推荐：为每个页面单独 New，出错时名字更清晰
t := template.New("user<em>page").Funcs(funcs)
t, </em> = t.ParseFiles("base.html", "user.html")这样错误信息会变成 template: user_page:15:...，而不是模糊的 template: base.html:15:...。
另一个实用技巧：开发期临时在关键 {{template}} 前后加注释，比如：
<!-- START: header -->
{{template "header" .}}
<!-- END: header -->
{{template "content" .}}出错时看错误消息里的模板名 + 行号，再结合注释，能快速圈定范围。
HTML 模板里输出 JSON 数据，引号被转义导致 JS 报错
这是高频隐形坑：你想在模板里内联一段 JSON 给前端 JS 用，写成 {{.Config}}，但 Go 模板默认对所有输出做 HTML 转义，" 变成 "，JS 解析直接 SyntaxError。
根本原因：Go 模板根据上下文自动判断转义策略，{{.Config}} 在 HTML 标签属性或文本中，就被当 HTML 内容处理。
解法只有两个，且必须明确选一个：
- 用
{{.Config|safeJS}}—— 先确保.Config是template.JS类型（比如template.JS(b, _ := json.Marshal(v))），再用safeJS函数绕过转义 - 用
{{printf "%s" .Config}}—— 强制走字符串格式化，不触发上下文转义（但仅限纯字符串内容，不含 HTML 标签）
千万别用 {{.Config|safeHTML}}，那是给 HTML 片段用的，JSON 里带引号和花括号会被浏览器当成标签解析，XSS 风险拉满。
顺带一提：template.HTML、template.JS、template.CSS 这些类型本质是空 struct + 方法，它们只是告诉模板引擎“这段内容我已经自己处理过安全性了”，引擎就不会再动它。
事情说清了就结束。最麻烦的永远不是语法，而是错误发生时你根本不知道它发生在哪一层模板、哪一个函数调用、哪一次数据访问——所以从第一行 Execute 就要接 error，每个自定义函数都要想好失败路径，每次 template 调用都要能被独立识别。
