如何在 Golang 框架中整合 HTML 视图并在其中安全渲染并执行指定的 JS 代码

先说一句容易被忽略但必须记住的结论：html/template 不是用来“跑”JS 的，它只管把内容安全地送到浏览器。真正执行 JS 是浏览器的事。所以所谓“整合 HTML 视图并执行 JS”，本质上就是一件事——安全地在模板里输出 JS 代码或数据，让浏览器加载后顺理成章地运行。这里的关键不在“执行”，而在“安全输出”。

为什么直接写 {{.JSCode}} 会失效

很多新手踩坑，原因就出在这里。Go 的 html/template 默认会对所有动态变量做 HTML 转义。你传进去的字符串如果是 alert(1)，模板渲染出来就变成了 alert(1)，浏览器看到的是纯文本，当然不会执行。

• 这其实是安全机制：防止用户输入的恶意脚本被直接渲染执行
• 但如果你明确知道这段 JS 是可信的——比如服务端生成的初始化逻辑——就需要绕过这个转义
• 错误做法：用 template.HTML(userInput) 包一下 —— 用户可控的内容绝对不能这么干，这是 XSS 的后门

安全注入 JS 代码的两种可靠方式

需要先区分场景：是注入一段可执行的 JS 脚本（比如 ），还是注入 JSON 数据供已有的 JS 代码使用（比如 data-config='{"x":1}'）。

• 注入完整 script 块：在 Go 中构造 template.JS 类型返回值，模板里直接写 {{.Script}}
• 注入 JSON 到 data-* 属性或内联 script：先用 encoding/json 序列化，再用 template.JS 或 template.HTML 包装，具体用哪个看上下文
• 要特别留意的是：千万别用 template.HTML 去包裹原始 JS 字符串——它只适用于 HTML 片段，不保证 JS 上下文的安全；template.JS 才是专为 JS 场景设计的类型

实际示例：在模板中安全输出初始化配置

假设你现在有个 Go 结构体 Config{Title: "Dashboard", Timeout: 5000}，要把它的内容传给前端的 JS 变量 config。来看正确做法：

// Go handler
type Config struct {
    Title   string `json:"title"`
    Timeout int    `json:"timeout"`
}

func handler(w http.ResponseWriter, r *http.Request) {
    cfg := Config{Title: "Dashboard", Timeout: 5000}
    data, _ := json.Marshal(cfg)
    tmpl.Execute(w, map[string]interface{}{
        "ConfigJS": template.JS(data), // ← 关键：用 template.JS，不是 template.HTML
    })
}

模板中这样写：

这里有几个要点需要拎出来说清楚：
- 用 template.JS 告诉模板：“这段内容将用于 JS 上下文，不要做 HTML 转义，但要按 JS 语法做安全处理”
- 如果写成 template.HTML(data)，虽然也能绕过 HTML 转义，但缺少对 JS 上下文的感知——比如单引号、反斜杠这些特殊字符就可能出问题
- 绝对不要在模板里手动拼接 JS 字符串。比如 这种写法，即使 .Title 是可信数据，也应该走 JSON 序列化的路径，否则迟早出事

真正需要 Go 执行 JS 的场景怎么办

如果你的需求是“在 Go 进程里运行 JS 代码”——比如服务端渲染、规则引擎、模板预处理——那 html/template 根本管不了这事，得请专门的 JS 引擎：

• otto：纯 Go 实现，轻量级，支持 ES5，适合处理简单的逻辑判断
• goja：更现代，支持部分 ES6+，性能更好，新项目推荐这个
• chromedp：不是跑 JS，而是控制真实 Chrome 实例去执行 JS——常用于爬虫、E2E 测试等场景，开销大，不适合常规 Web 渲染

这类引擎和 html/template 是完全解耦的。它们生成的结果（比如渲染后的 HTML 字符串）可以再交给模板去输出，但 JS 执行本身不在模板层发生——这一点从一开始就要分清楚。