
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>© 2024</footer>
</body>
</html>index.html:
<main>
<h1>Hello, Martini!</h1>
</main>方案二:修改模板以匹配自定义分隔符
若坚持使用 {[{/}]},则所有模板必须同步更新:
layout.html:
<html>
<body>
<header>My App</header>
{[{ yield }]} <!-- ✅ 注意:不是 {{ yield }} -->
<footer>© 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 配置,验证是否恢复正常;再根据项目规范决定是否引入自定义分隔符——但除非有明确冲突需求(如前端框架也用 {{ }}),否则建议坚守 {{/}} 标准语法,降低维护成本与出错概率。

















