Buffalo 不支持 Vue 的 语法,其“插槽”实为 Go 模板的 {{define}}/{{template}} 区块机制,用于模板继承;主布局需用 {{define "main"}} 等显式声明命名区块,子模板通过同名 {{define}} 覆盖,且名称严格区分大小写、路径必须匹配。

Buffalo 框架不支持 Vue 那样的 <slot></slot> 语法,也没有内置的“命名插槽”或“作用域插槽”机制。它用的是 Go 模板(html/template)体系,所谓“多个动态内容插槽”,实际是靠 {{template}} + {{define}} 组合实现的布局复用,本质是模板继承(template inheritance),不是运行时内容分发。
Buffalo 中怎么定义主布局里的多个可替换区域
主布局(比如 app.html)里不能写 <slot name="header"></slot>,必须用 {{define "name"}} 显式声明命名区块,再用 {{template "name" .}} 引入。每个 define 就是一个“插槽”的等价物。
常见错误现象:直接复制 Vue 写法,比如在布局里写 <div>{{.MainContent}}</div> —— 这会失败,因为 Buffalo 不把内容当变量传,而是靠模板嵌套和区块覆盖。
- 主布局中用
{{define "main"}}定义默认内容(可为空),这是必须存在的、被所有页面继承的根区块 - 额外插槽需显式定义,例如:
{{define "sidebar"}}、{{define "footer"}} - 子模板必须用
{{template "main" .}}调用主布局,并在其中用{{template "sidebar" .}}嵌入对应区块 - 子模板里用
{{define "sidebar"}}覆盖该区块内容;未定义则渲染主布局中{{define "sidebar"}}的默认内容(如果写了的话)
为什么 {{yield}} 或 {{content}} 不起作用
这是常见混淆点:Buffalo 的 html/layout.html 模板里默认只用了 {{template "main" .}},它不识别 Rails 风格的 {{yield}},也不兼容 Laravel 的 @yield。任何非 Go 模板原生命令都会报错 template: ...: unexpected "yield"。
正确做法只有两个:
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 坚持用
{{define}}/{{template}}对,且名称严格一致(区分大小写) - 确保子模板顶部有
{{template "layout" .}}(或你实际命名的主布局文件名),否则根本不会套用布局
如何让某个插槽支持可选渲染或条件 fallback
Go 模板本身不支持“插槽是否存在”的运行时判断,但可以通过传递结构体字段间接控制。比如在 handler 中设置:c.Data["HasSidebar"] = true,然后在主布局中:
{{if .HasSidebar}}
{{template "sidebar" .}}
{{else}}
<div class="sidebar-empty">无侧边栏</div>
{{end}}
注意:不能用 {{if template "sidebar"}} —— template 是动作(action),不是函数,不能出现在条件表达式里。
性能影响很小,但要注意:所有 {{define}} 区块在模板解析阶段就已注册,即使子模板没覆盖,主布局中的默认 define 也会被渲染(除非用 {{if}} 包裹)。
真正容易被忽略的是路径和命名一致性:Buffalo 默认查找 templates/layouts/app.html 作为主布局,而 {{template "layout" .}} 中的 "layout" 必须和文件名(不含扩展名)或 {{define "layout"}} 的名字完全匹配——少一个字母或大小写不对,整个页面就空白且无提示。

















