html/template 渲染空字符串或 nil 会 panic，因其默认对 nil、未导出字段、不存在 map key 等直接 panic 以防止 XSS；需用 {{with}} 或 {{if}} 判断，字段首字母大写，并用 template.HTML 安全渲染 HTML。
为什么 html/template 渲染空字符串或 nil 会 panic？
因为 html/template 默认对 nil 值、未导出字段、不存在的 map key 等情况直接 panic，而不是静默跳过。这不是 bug，是安全设计——防止意外输出未过滤的数据。
- 常见错误现象：
template: xxx:12: nil pointer evaluating interface {}.Name - 使用场景：渲染用户数据时，
user可能为nil，或结构体字段未导出（首字母小写） -
解决方法：用
{{with .User}}或{{if .User}}{{.User.Name}}{{end}}显式判断；确保结构体字段首字母大写（如Name而非name） - 别依赖
text/template替代——它不转义 HTML，有 XSS 风险
如何安全传入并渲染动态 HTML 片段？
直接用 {{.Content}} 会自动转义尖括号，显示为纯文本；想渲染真实 HTML，必须显式标记为安全。
- 正确做法：在 Go 后端用
template.HTML类型包装字符串，例如：data := struct { Content template.HTML }{ Content: template.HTML(`Hello`), } - 绝对不要用
{{.Content | safeHTML}}或自定义函数绕过转义——这等于放弃模板引擎的安全护栏 - 如果内容来自用户输入，先用
bluemonday等库净化，再转成template.HTML - 注意：
template.HTML是类型断言，不是函数调用；写成template.HTML(s)即可，无需 import 额外包
如何复用 HTML 片段（如页头、页脚）？
用 {{define}} + {{template}} 是标准方案，但路径和执行顺序容易出错。
- 关键规则：所有
{{define}}必须在主模板中（或通过ParseFiles一次性加载），不能跨文件隐式引用 - 推荐做法：用
template.New("base").Funcs(...).ParseFiles("base.html", "home.html")，确保所有子模板被解析进同一*template.Template实例 - 常见坑：
{{template "header" .}}中的.是当前作用域数据，若子模板需要不同数据，得显式传参：{{template "header" dict "Title" "Home" "User" .User}}（需提前注册dict函数） - 避免嵌套过深：超过 3 层
{{template}}调用时，建议合并逻辑或改用组件化思路（如预渲染成字符串再注入）
为什么修改模板文件后页面没更新？
开发时用 template.ParseFiles 或 template.ParseGlob 加载模板，默认只加载一次，后续修改不会自动重载。
立即学习“go语言免费学习笔记（深入）”；
- 调试阶段：每次请求前重新
ParseFiles（仅限开发环境） - 生产环境：用
http.FileSystem包裹os.DirFS，配合template.Must(template.New("").ParseFS(...))实现热重载（Go 1.16+） - 更稳妥的做法：把模板编译进二进制（
go:embed+embed.FS），避免运行时 I/O 和路径错误 - 注意：
ParseFS的模式匹配路径区分大小写，templates/*.html不会匹配TEMPLATES/
