在 Go Web 应用中集成 Jade（Pug）模板引擎的完整指南-Golang-PHP中文网

在 Go Web 应用中集成 Jade（Pug）模板引擎的完整指南

Go 原生仅支持 html/template 和 text/template，但可通过第三方 Go 实现（如 github.com/Joker/jade）无缝使用 Jade（现称 Pug）语法编写模板，无需 Node.js 编译服务。

go 原生仅支持 `html/template` 和 `text/template`，但可通过第三方 go 实现（如 `github.com/joker/jade`）无缝使用 jade（现称 pug）语法编写模板，无需 node.js 编译服务。

Go 语言标准库提供的模板引擎功能强大且安全，但其语法相对 verbose，缺乏现代前端模板引擎（如 Pug）的简洁性与表达力。幸运的是，社区已提供纯 Go 实现的 Jade/Pug 解析器——Joker/jade，它完全兼容 Pug 语法规范（v2.0+），支持继承、混入（mixins）、条件渲染、循环、变量插值等核心特性，且零依赖、纯 Go 编写、编译时解析、运行时高效。

快速上手：安装与基础用法

go get github.com/Joker/jade

在 HTTP 处理函数中直接使用：

package main

import (
    "net/http"
    "github.com/Joker/jade"
)

func handler(w http.ResponseWriter, r *http.Request) {
    // 从字符串解析 Jade 模板（生产环境建议预编译或从文件加载）
    tmpl, err := jade.ParseString(`
doctype html
html
  head
    title= pageTitle
  body
    h1 Welcome to #{siteName}!
    if user
      p Hello, #{user.Name}!
    else
      p Please log in.
`)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    // 渲染数据
    data := map[string]interface{}{
        "pageTitle": "My App",
        "siteName":  "GoPug",
        "user":      struct{ Name string }{"Alice"},
    }

    w.Header().Set("Content-Type", "text/html; charset=utf-8")
    tmpl.Execute(w, data)
}

func main() {
    http.HandleFunc("/", handler)
    http.ListenAndServe(":8080", nil)
}

推荐生产实践：预编译与文件加载

为提升性能与可维护性，建议将 .jade 文件存于 templates/ 目录，并预编译：

// 初始化模板集合（推荐在 init 或 main 中一次性完成）
var templates = jade.New()

func init() {
    // 自动加载并编译所有 .jade 文件（支持嵌套目录）
    if err := templates.AddDir("templates", ".jade"); err != nil {
        panic(err)
    }
}

func handler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "text/html; charset=utf-8")
    // 按文件名（不含扩展名）渲染，自动查找 templates/layout.jade
    if err := templates.Execute(w, "layout", map[string]string{
        "Title": "Home Page",
        "Body":  "<p>Rendered via Jade!</p>",
    }); err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

注意事项与最佳实践

✅ 语法兼容性：Joker/jade 支持绝大多数 Pug 语法（包括 extends、block、include、mixin），但部分高级特性（如过滤器 :markdown）需自行扩展。
⚠️ 安全性：与 html/template 一致，Jade 模板默认对变量输出进行 HTML 转义；若需原始 HTML，使用 !{unsafeHTML}（务必确保内容可信）。
? 不支持运行时编译：所有模板必须在启动前完成解析，不支持热重载（开发期可借助 fsnotify + 重启实现）。
? 无 Node.js 依赖：整个流程完全在 Go 运行时内完成，部署轻量、跨平台友好。