html/template 不能直接替换纯字符串是因为默认启用html自动转义，所有数据被视为文本而非原始html；需用template.html类型或safehtml函数标记可信html才能原样输出。
Go html/template 为什么不能直接替换纯字符串？
因为 html/template 默认启用 HTML 自动转义，它把所有传入的数据当作文本内容处理，而不是原始 HTML 片段。如果你用 {{.Content}} 渲染一段含 <div> 的字符串，结果会变成被转义的 <code><div>，页面显示为文字而非结构。
常见错误现象：模板里写 {{.HTML}}，但浏览器源码看到的是转义后的字符，DOM 没有生效。
- 必须显式告诉模板“这段是可信 HTML”，用
{{.HTML | html}}或更安全的{{.HTML | safeHTML}} -
html/template不支持“全局字符串替换”式操作（比如正则替换{{name}}），它只认{{.Field}}这类结构化数据绑定 - 若原始 HTML 是静态字符串（如从文件读取的模板片段），需先解析成
*template.Template，再执行Execute；不能用strings.ReplaceAll混合处理
如何让 template.Parse 正确加载含占位符的 HTML 文件
直接用 template.ParseFiles("index.html") 可以，但要注意路径和编码。Windows 下路径分隔符、BOM 头、UTF-8 无 BOM 是高频出错点。
- 确保 HTML 文件保存为 UTF-8 无 BOM（VS Code 默认可能带 BOM，会导致
ParseFiles报unexpected EOF） - 路径用正斜杠
/，避免 Windows 反斜杠引发 panic：template.ParseFiles("templates/index.html") - 如果 HTML 中有嵌套模板（
{{define "header"}}），必须用template.New("").ParseFiles(...)，否则ParseFiles会忽略define块 - 调试时加
log.Fatal(t.Execute(w, data))，别忽略 error，否则空白页且无提示
动态注入非结构化 HTML 片段的正确姿势
比如后端生成一段带样式的 <span class="tag">go</span>，想插入到模板中某处——这不是字段映射，而是“信任该 HTML 并原样输出”。
- 定义 struct 字段时用
template.HTML类型：Content template.HTML，而不是string - 赋值前手动转义不必要，但必须确保内容可信（比如来自配置或白名单生成，而非用户输入）：
data.Content = template.HTML(rawHTML) - 模板中写
{{.Content}}即可，无需管道符；若字段是string类型，则必须写{{.Content | safeHTML}} - 注意：
safeHTML是函数名，不是方法，不能写成{{.Content.safeHTML}}
想实现类似 {{name}} 占位符替换？别硬套 html/template
html/template 的语法是 {{.Name}}，不是 {{name}}。强行用正则预处理 HTML 字符串再交给模板，会破坏安全性机制，也绕过上下文感知（如在 <script></script> 内自动 JS 转义）。
- 真要兼容旧占位符风格，先用
strings.ReplaceAll把{{name}}替成{{.Name}}，再交给template.Must(template.New("").Parse(...)) - 但更推荐统一改前端：用
{{.User.Name}}显式指定层级，避免歧义（比如{{id}}和{{.ID}}容易混淆） - 如果数据结构不确定（map[string]interface{}），用
{{index . "key"}}，但无法触发类型安全检查，容易静默失败
最易被忽略的是：模板执行失败时不会报错，只是输出空字符串。务必检查 Execute 返回的 error，哪怕只是 log.Println(err)。
