Go模板渲染是类型安全的数据绑定而非字符串拼接；结构体字段必须首字母大写才可被模板访问，小写字段如name静默不可见；nil指针访问不panic但输出空，应配合{{with}}使用；HTML内容需用template.HTML类型标记以避免转义。
Go 的 html/template 渲染不是字符串拼接，而是类型安全的数据绑定；不导出字段、路径错、类型没标 template.HTML，都会导致空白输出或 panic。
结构体字段必须首字母大写才能被模板访问
Go 模板通过反射读取字段，只认导出（public）字段。小写开头的字段如 name、email 在模板里完全不可见，{{.name}} 不报错也不渲染，直接静默为空。
- 正确写法：
type Page struct { Title string; Content template.HTML } - 嵌套也一样：
User struct{ Name string }→ 模板中用{{.User.Name}}，不能写{{.User.name}} - 如果字段是 nil 指针（比如
*User为 nil），{{.User.Name}}也不会 panic，但输出空字符串 —— 建议用{{with .User}}{{.Name}}{{end}}包一层
template.ParseFiles 找不到文件？工作目录不是源码目录
template.ParseFiles("templates/index.html") 是按当前进程工作目录（cwd）找文件，不是 main.go 所在目录。你在项目外执行 go run ./cmd/server，它就去你终端所在的路径下翻 templates/，自然报 open templates/index.html: no such file or directory。
- 推荐方案：用
embed.FS打包（Go 1.16+），避免路径歧义var templates embed.FS<br>t := template.Must(template.New("").ParseFS(templates, "templates/*.html")) - 次选：用
filepath.Join拼绝对路径，比如filepath.Join(filepath.Dir(os.Args[0]), "..", "templates", "index.html") - 别用
os.Chdir切工作目录 —— 影响其他 goroutine 或第三方库行为
想渲染真实 HTML 却被转义？必须显式标记 template.HTML
html/template 默认把所有 {{.X}} 当纯文本处理，防止 XSS。哪怕你传了 "<strong>hi</strong>"，页面也只显示字面量，不会加粗。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：字段类型声明为
template.HTML，值用template.HTML(...)构造type Page struct { Content template.HTML }<br>t.Execute(w, Page{Content: template.HTML(`<p>ok</p>`)}) - 错误做法：
Content: "<p>ok</p>"（string 类型）、strings.ReplaceAll(...)拼完再塞进去（类型还是 string） - 千万别换
text/template来绕过转义 —— 它不防 XSS，用户输入一进模板就等于开了前端执行任意 HTML 的后门
自定义函数注册失败？两个硬性条件缺一不可
往 template.FuncMap 里塞函数，模板里却提示 function "xxx" not defined，大概率卡在这两点：
- 函数本身必须首字母大写（即导出），比如
FormatTime✅，formatTime❌ - 函数签名要合规：常见的是
func(string) string或func(interface{}) (interface{}, error)；返回多个值但没声明error类型，template会拒绝注册 -
FuncMap的 key 可以小写（比如"time"），但 value 必须是那个导出的、签名正确的函数变量
最常被忽略的点：嵌套模板传参时 . 是当前上下文，不是全局数据；子模板里想用父级字段，得显式传 {{template "sub" .}}，而不是假设它自动继承。另外，ParseGlob 和 ParseFiles 对同名模板的覆盖逻辑容易误用，多模板场景建议统一用 template.New + ParseFS 管理命名空间。
