
在 Go 的 html/template 中,默认会对变量插值进行 HTML 转义以防止 XSS,但插入内联 JavaScript 对象时需保留原始符号(如 {、}、
在 go 的 `html/template` 中,默认会对变量插值进行 html 转义以防止 xss,但插入内联 javascript 对象时需保留原始符号(如 `{`、`}`、`
Go 的 html/template 包出于安全考虑,会对所有 {{.Field}} 插值自动执行上下文感知转义(context-aware escaping):在 <script></script> 标签内,它会将 转为 \u003c," 转为 \",换行转为 \n 字符串字面量——这导致 JS 对象字面量无法被浏览器正确解析。
✅ 正确做法是显式标记该内容为可信 JavaScript 代码,而非禁用转义(那会引入严重 XSS 风险)。有两种推荐方式:
方式一:结构体字段类型直接使用 template.JS
import "html/template"
type Tmpl struct {
Title string
JS template.JS // ← 关键:类型即语义
}
初始化时需显式转换:
data := Tmpl{
Title: "My Page",
JS: template.JS(`key: "value", count: 42, enabled: true`),
}
tmpl.Execute(w, data)
模板中直接使用:
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
<script>
var options = {
{{.JS}}
};
</script>
方式二:注册自定义函数 toJS(更灵活,适合复用)
func toJS(s string) template.JS {
return template.JS(s)
}
// 注册到模板
tmpl := template.New("page").Funcs(template.FuncMap{"toJS": toJS})
模板中调用:
<script>
var options = {
{{toJS .JS}}
};
</script>
⚠️ 重要注意事项:
-
template.JS仅表示“此字符串已由开发者确认为安全的 JS 片段”,它不会做任何校验。若.JS来自用户输入(如表单、URL 参数),必须先严格清洗、白名单过滤或使用服务端 JSON 序列化(如json.Marshal+template.JS),否则将导致 XSS。 - 切勿使用
{{.JS | safeJS}}或{{.JS | safeHTML}}等非标准写法——html/template不提供safeJS;safeHTML用于 HTML 上下文,在<script></script>内使用会破坏 JS 语法。 - 更健壮的替代方案:服务端生成 JSON 并通过
data-*属性或独立 JS 变量注入,避免模板拼接:// Go data.JSONOptions = template.JS(`"options":` + string(jsonBytes))
<script> const options = JSON.parse('{{.JSONOptions}}'); </script>
总之,template.JS 是 Go 模板系统为 JS 上下文设计的安全出口(escape hatch),合理使用可兼顾功能性与安全性。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










