go的html/template需显式加载文件（ParseFiles/ParseGlob）或字符串（New().Parse），默认HTML转义，原样输出需template.HTML类型+safeHTML；执行失败多因字段未导出或数据为空，嵌套模板需注意作用域与循环引用。
模板文件怎么加载和解析
Go 的 html/template 不会自动读取磁盘文件，必须显式调用 template.ParseFiles() 或 template.ParseGlob()。直接传字符串要用 template.New().Parse()。
-
ParseFiles()接收多个文件路径，返回 *template.Template；若文件不存在或语法错误，会返回非 nil Error，但不会 panic - 多个模板文件里定义同名
{{define "name"}}会覆盖，后加载的生效；想共存得用template.New("name").ParseFiles(...)分开实例 - 路径必须是相对运行时工作目录（不是源码目录），建议用
os.DirFS("templates")+ParseFS()（Go 1.16+）避免路径错乱
怎么安全地渲染变量和 HTML 片段
html/template 默认对所有 {{.}} 和 {{.Field}} 做 HTML 转义，这是它和 text/template 的核心区别。想原样输出 HTML，必须显式标记为安全：
- 用
{{.HTMLContent | safeHTML}}，前提是.HTMLContent是template.HTML类型（不是 String） - 不能靠
strings.Replace拼接 HTML 后塞进去——会被全转义；必须在 Go 层先转成template.HTML -
url.QueryEscape和html.EscapeString不要混用：前者用于 URL 查询参数，后者用于纯文本插入 HTML 属性或内容，而模板已内置处理
常见执行失败原因和 debug 方法
调用 tmpl.Execute(w, data) 返回 error 时，90% 是数据结构不匹配或字段未导出，不是模板语法错（语法错在 Parse 阶段就报了）：
- Struct 字段没大写首字母 → 模板访问不到，输出空字符串且无提示；加
-gcflags="-m"看编译器是否提示 “field is unexported” - map key 是 string 但模板写
{{.["key"]}}，实际要{{index . "key"}}；.key只对 struct 有效 - nil Interface{}、nil slice 传入会导致
Executepanic：“reflect: Call of method on nil interface value”，需提前判空或用{{with .Data}}{{end}}
嵌套模板和布局复用怎么组织
用 {{define}} + {{template}} 实现布局复用，但注意执行顺序和作用域：
立即学习“go语言免费学习笔记（深入）”；
-
{{template "header" .}}中的.是当前上下文，不是被 include 模板的局部变量；想传额外数据得用{{template "sidebar" dict "User" .User "Active" "posts"}}（需导入text/template的dict函数） - 主模板
ParseFiles("layout.html", "page.html")后，ExecuteTemplate(w, "page.html", data)才能正确找到{{define "main"}}；只传"layout.html"会找不到 named template - 避免循环引用：
A.tmpl{{template "B"}}，B.tmpl又{{template "A"}}→ 运行时报 “template: loop detected”
最易被忽略的是：模板函数（如 date、printf）不支持自定义方法绑定到任意类型，只能通过 FuncMap 注册全局函数；且 FuncMap 必须在 Parse 前设置，否则无效。