首页 > Golang > Go教程

Martini Render {{ yield }} 未替换解决方法

时间：2026-04-03 15:09:45 280浏览收藏

Martini 框架中 `{{ yield }}` 未被替换的常见问题，根源在于 render 中间件自定义模板分隔符（如 `{[{`/`}]}`）与模板中实际使用的 Go 标准语法（`{{`/`}}`）不一致，导致引擎完全忽略 `{{ yield }}` 而将其作为纯文本输出；解决方案简单明确：要么将 Delims 配置恢复为 `"{{"` 和 `"}}"`（推荐，兼容默认习惯、降低维护成本），要么全局统一修改所有模板使用自定义分隔符——关键在于确保配置与模板“说同一种语言”，同时注意 `yield` 的特殊性（仅在 layout 根级有效、需文件名严格匹配）。

Martini Render 中 {{ yield }} 未被替换的解决方案

Martini 的 render 包因自定义模板分隔符与模板中实际使用的分隔符不匹配，导致 {{ yield }} 未被正确解析和替换，需统一分隔符配置与模板语法。

Martini 的 render 包因自定义模板分隔符与模板中实际使用的分隔符不匹配，导致 `{{ yield }}` 未被正确解析和替换，需统一分隔符配置与模板语法。

在使用 Martini 框架配合 render 中间件进行模板渲染时，layout.html 中的 {{ yield }} 占位符未能被子模板内容替换，而是以纯文本形式直接输出到 HTML 页面中——这是典型的模板分隔符（delimiters）配置错误所致。

根本原因在于：你在 render.Renderer 初始化时显式设置了自定义分隔符：

Delims: render.Delims{"{[{", "}]}"},

但 layout.html 和 index.html 中仍沿用 Go 标准模板语法 {{ yield }} 和 {{ .Title }} 等。由于 render 仅识别你指定的 {[{ 和 }]}，它完全忽略 {{/}}，因此 {{ yield }} 不被识别为指令，原样保留输出。

✅ 正确做法有两种（任选其一）：

方案一：恢复默认分隔符（推荐）
将 Delims 改为标准 Go 模板语法：

m.Use(render.Renderer(render.Options{
    Directory:  "templates",
    Layout:     "layout",
    Extensions: []string{".tmpl", ".html"},
    Delims:     render.Delims{"{{", "}}"}, // ← 关键修改
    Charset:    "UTF-8",
    IndentJSON: true,
}))

此时保持模板不变即可正常工作：

layout.html：

<html>
<head><title>{{ .Title }}</title></head>
<body>
    <header>My App</header>
    {{ yield }} <!-- ✅ 将被 index.html 内容替换 -->
    <footer>&copy; 2024</footer>
</body>
</html>

index.html：

<main>
    <h1>Hello, Martini!</h1>
</main>

方案二：修改模板以匹配自定义分隔符
若坚持使用 {[{/}]}，则所有模板必须同步更新：

layout.html：

<html>
<body>
    <header>My App</header>
    {[{ yield }]} <!-- ✅ 注意：不是 {{ yield }} -->
    <footer>&copy; 2024</footer>
</body>
</html>

⚠️ 注意事项：

Delims 配置影响全部模板文件（layout、子模板、partial），务必全局一致；
yield 是 render 包的特殊指令（非 Go 原生），仅在 Layout 模板中有效，且必须位于根级作用域（不可嵌套在 {{ if }} 或 {{ range }} 内）；
确保 Layout 文件名（如 "layout"）与磁盘中 templates/layout.html（或 .tmpl）严格匹配，区分大小写；
若启用 IndentJSON: true，仅影响 rnd.JSON() 输出，对 HTML 渲染无影响，可按需保留。

总结：模板引擎的“语言”由 Delims 定义，模板内容必须说同一种语言。调试时可先移除 Delims 配置，验证是否恢复正常；再根据项目规范决定是否引入自定义分隔符——但除非有明确冲突需求（如前端框架也用 {{ }}），否则建议坚守 {{/}} 标准语法，降低维护成本与出错概率。

理论要掌握，实操不能落！以上关于《Martini Render {{ yield }} 未替换解决方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！

资料下载

编程学习资料下载

精选编程（Golang、Python、Java、C++、JavaScript等）教程、电子书与示例源码，一键打包本地下载学习。

立即下载