Go-html-template渲染页面的基本流程是：定义模板→解析（template.ParseFiles或Parse）→执行（Execute或ExecuteTemplate）→写入http.ResponseWriter；模板文件须以.html结尾，数据结构字段需首字母大写导出，执行前必须检查err。
Go-html-template 渲染页面的基本流程
Go 的 html/template 不是“模板引擎插件”，而是标准库的一部分，直接 import 就能用，无需额外依赖。它默认启用 HTML 自动转义，这点和 text/template 不同，也意味着你不能靠简单替换函数名就混用。
典型服务端渲染路径是：定义模板 → 解析（template.ParseFiles 或 template.Parse）→ 执行（Execute 或 ExecuteTemplate）→ 写入 http.ResponseWriter。
- 模板文件必须以
.html结尾（否则ParseFiles可能静默跳过） -
Execute第二个参数为数据，类型任意，但字段需导出（首字母大写），否则模板里取不到 - 模板中访问结构体字段用
{{.Name}}，不是{{.name}} - 执行前务必检查
err—— 模板语法错误（比如未闭合的{{）在Parse阶段就报错，但常被忽略
如何正确传递和使用结构体数据
后端传给模板的数据通常是一个结构体，比如用户信息、文章列表。关键点不在“怎么传”，而在于“字段能否被模板访问到”以及“嵌套数据怎么展开”。
- 所有字段必须导出：定义为
Name string，而不是name string - 切片遍历用
{{range .Posts}}...{{end}}，其中.在 range 内代表当前元素，不是外层结构体 - 若需同时访问外层字段（如分页总数），用
{{$total := .Total}} {{range .Posts}} {{$total}} {{end}} - 避免在模板里调用方法以外的逻辑 —— 比如
{{.CreatedAt.Format "2006-01-02"}}可行，但{{len .Tags}}会 panic（len不是模板内置函数，要用len得提前算好传入）
静态资源路径与 base 标签的坑
Go 模板本身不处理静态资源路径，但你在 HTML 中写的 <link href="/static/css/app.css"> 能否加载成功，取决于 HTTP 路由是否注册了 /static/ 的文件服务。
立即学习“go语言免费学习笔记（深入）”；
- 必须显式注册静态文件服务：
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static")))) - 如果页面部署在子路径（如
https://example.com/myapp/），模板里不能硬编码/static/，应传入BaseURL字段，写成<link href="{{.BaseURL}}/static/css/app.css"> - 别依赖
<base href="...">自动修正相对路径 —— 它会影响所有相对 URL（包括<a href="post/123">），且部分浏览器对 base 标签的解析有差异
如何安全插入 HTML 片段
默认情况下，{{.Content}} 会把字符串当作纯文本转义输出（比如 <p>Hello</p> 显示为文字而非段落）。要渲染原始 HTML，必须明确标记为安全。
- 在 Go 代码中用
template.HTML类型包装：Content: template.HTML(rawHTML) - 不要用
{{.Content | safeHTML}}——safeHTML是旧版遗留函数，Go 1.11+ 已弃用，且容易误用（比如对用户输入调用会导致 XSS） - 更安全的做法是：只对可信内容（如 CMS 后台编辑的富文本）转
template.HTML；用户输入一律走转义，或用专门的 Markdown 渲染库（如blackfriday）预处理后再转 - 注意
template.HTML是类型断言，不是函数调用 —— 错写成template.HTML("...")会编译失败，正确写法是template.HTML(someString)
最常被忽略的是模板解析时机 —— 多次调用 ParseFiles 会覆盖已有模板，开发时建议用 template.Must 包裹并尽早初始化，避免运行时因模板未加载而 panic。
