
在 Go 的 html/template 中,默认会对变量内容进行 HTML 转义,导致 JavaScript 代码中的 , ", 换行符等被编码为 \u003c、\"、\n 等,破坏脚本执行。正确方式是使用 template.JS 类型或自定义 toJS 函数显式声明内容为可信 JS。
在 go 的 `html/template` 中,默认会对变量内容进行 html 转义,导致 javascript 代码中的 ``, `"`, 换行符等被编码为 `\u003c`、`\"`、`\n` 等,破坏脚本执行。正确方式是使用 `template.js` 类型或自定义 `tojs` 函数显式声明内容为可信 js。
Go 的 html/template 包出于安全考虑,默认对所有 .String() 类型插值执行自动转义(HTML/JS/CSS 上下文敏感),防止 XSS 攻击。但当你明确控制 JavaScript 内容(如动态生成配置对象),且该内容来自可信后端逻辑时,需主动告知模板引擎:“这段字符串是合法、已清理的 JavaScript 代码,无需转义”。
✅ 正确做法一:字段类型直接使用 template.JS
在数据结构中,将字段类型声明为 template.JS(而非 string):
import "html/template"
type TmplData struct {
Title string
JS template.JS // ← 关键:类型即语义
}
初始化时直接赋值原始字符串(无需额外转换):
data := TmplData{
Title: "My App",
JS: `baseUrl: "https://api.example.com", timeout: 5000`,
}
模板中照常使用 {{.JS}},模板引擎会识别其类型并跳过转义:
<script>
var options = {
{{.JS}}
};
</script>
✅ 正确做法二:注册 toJS 辅助函数(适合复用或无法改结构场景)
若无法修改数据结构(如字段必须为 string),可定义一个安全转换函数并注册到模板:
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
func toJS(s string) template.JS {
return template.JS(s)
}
// 注册到模板
t := template.Must(template.New("page").Funcs(template.FuncMap{
"toJS": toJS,
}))
模板中调用:
<script>
var options = {
{{toJS .JS}}
};
</script>
⚠️ 注意事项:
- 永远不要对用户输入或未经校验的数据使用
template.JS—— 这会绕过所有转义保护,引入严重 XSS 风险;template.JS仅适用于完全由服务端可控、静态或经严格白名单过滤的 JS 片段;- 避免使用
{{.JS | safeJS}}或{{.JS | safeHtml}}等非标准写法(safeHtml属于text/template,不适用于html/template);- 若需插入完整
<script></script>块,推荐优先使用template.JS+ 外层<script></script>标签,而非尝试注入整个标签字符串。
通过类型约束或显式函数标记,你既能保留 Go 模板的安全默认行为,又能精准释放可信 JS 的表达能力——这是安全与灵活性的平衡关键。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










