Go的html/template用于安全渲染结构化数据，需注意模板路径、Content-Type设置、字段导出、range遍历、template复用及XSS防护。
Go 的 html/template 不是用来“学语言”的工具，而是用来把结构化数据（比如单词表、例句、语法点）安全地塞进 HTML 页面里——只要数据组织得当，渲染多语言对照、带音标/音频按钮的词卡、可折叠的语法说明，都不需要 JS 介入。
模板路径找不到？别靠相对路径硬写
运行 go run main.go 时 ParseFiles("templates/index.html") 成功，换到其他目录或用二进制部署就报 open templates/index.html: no such file or directory，是因为 Go 默认按当前工作目录找文件，不是按源码位置。
- 用
os.Executable()+filepath.Dir()拼出二进制所在目录下的templates/路径，最稳 - 开发期可临时用
ParseGlob("templates/*.html")，但注意它不递归子目录 -
ParseFiles返回的 error 必须检查，漏判会导致 panic，不是静默失败
中文乱码、页面空白？Content-Type 和字段导出缺一不可
浏览器显示方块字、或者整个页面白屏没报错，八成是这两处漏了：
- HTTP 响应头没设
Content-Type: text/html; charset=utf-8，加在tpl.Execute(w, data)前：w.Header().Set("Content-Type", "text/html; charset=utf-8") - 结构体字段首字母小写，比如
type Word { word string }，模板里写{{.word}}永远为空，且不报错——Go 模板只认导出字段，必须写成Word string - 嵌套结构如
Word.Example.Sentence，要求Example和Sentence都大写
想渲染动态词表或例句列表？用 {{range}}，别手写循环
语言学习页面常要渲染未知长度的单词数组、例句切片、同义词组，硬编码 HTML 行数既难维护又容易漏数据。
立即学习“go语言免费学习笔记（深入）”；
- 传入数据用
[]struct{ Word string; IPA string; Example string }这类切片，模板里用{{range .Words}}<li>{{.Word}} [{{.IPA}}] — {{.Example}}</li>{{end}} -
{{range}}自动处理空切片，不用额外{{if .Words}}判断 - 如果某条例句含
<audio>标签，不能直接放字符串里传进去——会被转义成纯文本。得在 handler 里提前转成template.HTML(rawHTML)类型
多个模板共用页头页脚？define + template 是标准解法
语言学习站通常有统一导航栏、侧边词典入口、底部版权信息，每个页面重复写一遍 HTML 不现实，也不利于后期改版。
- 主模板里用
{{define "base"}}<html>...{{template "content" .}}{{end}} - 内容页用
{{define "content"}}<h1>{{.LessonTitle}}</h1>...{{end}}，再通过ParseFiles("base.html", "lesson.html")一起加载 - 别用
text/template替代html/template来绕过转义——XSS 漏洞立刻出现，可信 HTML 必须走template.HTML类型转换
最易被忽略的是：模板中访问未定义字段（比如 {{.Transliteration}} 但结构体没这个字段）不会报错，只是输出空字符串；而传入 nil 数据给 Execute 会直接 panic。调试时用 {{printf "%#v" .}} 看实际传入的数据结构，比猜快得多。
