Go 的 html/template 不能直接渲染 React/Vue 组件，因其仅做字符串替换与转义，不执行 JS 或解析 script；SSR 必须用框架官方服务端渲染（如 react-dom/server），再将结果作为 template.HTML 插入模板。
Go 的 html/template 为什么不能直接渲染 React/Vue 组件
它压根不执行 JavaScript，也不解析 script 标签里的逻辑——只做字符串替换和安全转义。你传进去一个 {{.ComponentHTML}}，它就原样吐出来，不会触发组件挂载或状态初始化。
常见错误现象：document.getElementById("root") 返回 null，控制台报错“Cannot set property ‘innerHTML’ of null”，但 HTML 看起来“已经渲染了”。
- SSR 的目标不是“把前端代码塞进后端模板”，而是“提前生成首屏完整 HTML 字符串”
- 若用 React/Vue，必须走它们官方的 SSR 能力（如
react-dom/server或@vue/server-renderer），再把结果传给html/template做外层布局嵌入 -
html/template的{{template "name" .}}只能复用 Go 模板片段，不能加载或执行前端框架模板
如何让 html/template 正确插入动态 HTML 而不被转义
默认所有 {{.X}} 都会 HTML 转义，防止 XSS；但 SSR 场景下，你常需要把已信任的 HTML 字符串（比如前端框架 renderToString 的结果）原样插入。
使用 template.HTML 类型强制绕过转义：
立即学习“go语言免费学习笔记（深入）”；
type PageData struct {
Title string
BodyHTML template.HTML // 注意类型
}
data := PageData{
Title: "Home",
BodyHTML: template.HTML(`<div id="root"><h1>Hello</h1></div>`),
}
t.Execute(w, data)
- 别用
string强转：template.HTML(myString)是安全的，(template.HTML)(myString)在类型不匹配时可能 panic - 仅对明确由服务端可控、无用户输入拼接的 HTML 使用
template.HTML；混入用户评论内容？必须先过滤或保留转义 - 如果用
text/template，没有template.HTML类型，它会无条件转义——必须换回html/template
静态资源路径在 SSR 中为何总 404
Go 服务默认不自动提供 /static/ 或 /assets/ 下的文件，模板里写 <script src="/js/app.js"></script>，浏览器发请求，但 http.ServeFile 没配，自然 404。
- 必须显式注册静态路由：
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static/")))) - 路径前缀要和模板中写的完全一致：模板写
/static/css/main.css，就要用/static/作 Handle 前缀，不能是/assets/ - 开发时容易忽略
./static/目录是否真实存在，或文件权限问题——检查os.Stat("./static/js/app.js")是否返回 nil error
并发渲染多个模板时，template.ParseFiles 为什么总 panic
template.Template 实例不是 goroutine 安全的，但很多人在 handler 里反复调用 ParseFiles，以为“每次新建模板就没事”。其实 ParseFiles 会复用内部缓存，且解析过程本身有竞态。
- 正确做法：启动时一次性解析好，全局复用同一个
*template.Template实例 - 不要在
http.HandlerFunc里调用ParseFiles或New().ParseFiles()—— 这是性能杀手，也是 panic 温床 - 如果模板需运行时热更新（如 CMS 场景），用
template.Clone()+ 单独锁保护Parse，而不是直接操作原模板
复杂点在于：模板嵌套层级深、有自定义函数、又依赖运行时数据结构时，Clone() 后注册函数容易漏；最容易被忽略的是——忘了在 Clone() 后重新注册所有 FuncMap。
