html/template不能替代Vue/React，因其无响应式更新、不支持表达式计算与组件嵌套，仅专注安全插值；正确场景是静态内容拼接、邮件模板等一次渲染需求。
Go 的 html/template 不适合做“动态页面生成”意义上的全栈模板渲染（比如替代 Vue 或 React），它本质是服务端安全插值工具，用错场景会卡在 XSS 防御、数据绑定、状态同步这些根本没设计支持的地方。
为什么 html/template 不能当“前端模板引擎”用
它没有响应式更新、不解析表达式（{{ .User.Name }} 可以，{{ if .Count > 5 }} 行，但 {{ .Items | sort }} 这类管道链需手动注册函数）、不支持组件嵌套语法（无 <slot></slot> 或 v-for 等抽象机制）。它的目标很窄：把 Go 结构体安全地转成 HTML 字符串，仅此而已。
常见错误现象：template: "list.html":12: function "sort" not defined、页面改了数据但刷新才变、想传函数进模板结果 panic。
- 所有逻辑必须在 Go 层处理完再传入，模板里只做展示分支和循环
- 自定义函数必须用
FuncMap显式注册，且不能带闭包或上下文 - 对 slice 或 map 做排序、过滤、分页，得在
http.HandlerFunc里做完，再塞进data结构体
html/template 正确的使用姿势
适合静态内容拼接、邮件模板、管理后台简单列表页、CLI 输出 HTML 报告这类“一次渲染、无交互”的场景。
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
实操建议：
- 用
type PageData struct { Title string; Users []User }明确结构，避免map[string]interface{}导致运行时 panic - 循环用
{{ range .Users }}{{ .Name }}{{ end }}，别写{{ range $i, $u := .Users }}除非真需要索引 - 防止 XSS：内置自动转义，但
{{ .SafeHTML | safeHTML }}这种需配合template.HTML类型，不是字符串强转 - 子模板用
{{ define "header" }}...{{ end }}+{{ template "header" . }}，别试图用include模拟组件复用
遇到 template: ... undefined field 怎么快速定位
这是字段不可导出（小写开头）或结构体没嵌入、指针解引用失败导致的。Go 模板只访问导出字段（首字母大写），且不自动解指针。
典型场景：
- 传了
&data但data是匿名 struct，字段未导出 → 改成type Data struct { Name string } - 用了
{{ .Profile.Age }}，但Profile是 nil 指针 → 模板里加判断{{ if .Profile }}{{ .Profile.Age }}{{ end }} - 嵌套结构没导出内层字段，比如
type User struct{ addr address }（address小写）→ 改为Addr Address并确保Address字段也导出
真正复杂的动态页面，该用 HTMX + Go API + 纯前端框架；而 html/template 的价值，在于极简、零依赖、开箱 XSS 安全——但它从没打算帮你管 DOM 更新或用户输入状态。
