go模板仅执行字符串替换，不能将后端Go结构体直接序列化为前端可使用的javaScript对象；需显式jsON编码并安全注入到HTML中。
go模板中无法直接将复杂go对象传递给前端javascript；需显式json编码并安全注入到html中。
在Go Web开发中，一个常见误区是认为html/template能“自动”将后端Go值（如嵌套map、结构体或切片）转换为前端可用的javascript对象。实际上，Go模板不执行任何序列化或类型转换——它仅进行纯文本替换：将模板中的{{.Object}}占位符，替换成该字段调用fmt.sprint()后的字符串表示（即String()方法或默认格式化结果），然后原样写入http响应体。
例如，当Object是一个深层嵌套的map[string]map[string]Struct{…}时：
presentation := &presentationStruct{ Object: object, // 非nil，log确认有效 } template.Execute(writer, presentation)模板中写alert({{.Object}})，Go会尝试将整个object转为字符串（如map[…]），但该字符串不是合法JavaScript语法，导致JS解析失败，alert实际收到的是undefined或引发语法错误——表面看像“变nil”，实则是JS运行时未定义。
✅ 正确做法：在后端显式JSON序列化，并通过template.JS安全注入：
立即学习“Java免费学习笔记（深入）”；
import ( "encoding/json" "html/template" ) // 在handler中 jsonData, err := json.Marshal(object) if err != nil { http.Error(w, "JSON encode failed", http.StatusInternalServerError) return } presentation := struct { Object template.JS // 关键：标记为可信JS内容 }{ Object: template.JS(jsonData), } t.Execute(w, presentation)前端模板中使用：
<script> const obj = {{.Object}}; // 安全注入，生成合法JS对象字面量 console.log(obj); // ✅ 正确解析为JS对象 alert(JSON.stringify(obj)); // 可正常操作 </script>⚠️ 注意事项：
- 绝不可直接使用{{.Object}}输出原始Go值到<script>内</script>——易导致xss或JS语法错误；
- template.JS仅表示“此字符串已由服务端转义/验证为安全JS”，不替代JSON序列化；
- 若数据含用户输入，务必先json.Marshal再template.JS，避免注入风险；
- 对于大型数据，建议通过ajax异步加载（如fetch(‘/api/data’)），而非模板内联，提升首屏性能与缓存灵活性。
总结：Go模板是服务端文本渲染工具，不是前后端数据桥接器。要让前端获得结构化数据，必须显式JSON化 + 安全标记（template.JS）或采用API方式传输。