Buffalo框架不支持局部组件概念，其“局部模板复用”依赖partial+render+显式传参实现；因plush引擎服务端单次渲染、无响应式、作用域隔离，必须用render传入所需数据，否则变量未定义。
Buffalo 框架本身不支持“局部组件”概念，它没有类似 Vue 的 <slot> 或 React 的 children 透传机制；所谓“局部模板复用”，实际靠的是 partial（局部模板）+ render 调用 + 正确的数据作用域传递来模拟。
为什么直接传组件会失败：Buffalo 的模板渲染是服务端单次求值
Buffalo 使用 plush 模板引擎，所有模板在服务端完成渲染后才返回 HTML。你无法像前端框架那样把一个组件实例“挂载”到某处再动态更新——partial 只是文本拼接，不保留状态、不支持响应式、不自动继承父作用域变量（除非显式传入）。
- 常见错误现象：
partial("components/button.html")渲染时提示undefined variable "title"，因为子模板没收到数据 - 根本原因：
plush默认只暴露当前模板上下文，partial是独立作用域 - 正确做法：必须用
render显式传参，例如render("components/button.html", {title: "提交", type: "primary"})
如何安全复用带逻辑的局部模板（如表单字段）
避免把业务逻辑塞进 partial，而是用 Go 函数封装行为，模板只负责结构。例如字段校验提示，不应在 HTML 里写 if .Errors.Has "email"，而应由 Go 层预计算好 .FieldErrors 结构体并传入。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 推荐结构：
app/views/components/input_field.html接收name、value、error、label四个字段，不读取.Errors全局对象 - Go 层准备数据示例：
c.Render(200, r.HTML("form.html").With("EmailField", map[string]interface{}{"name": "email", "value": user.Email, "error": errors.Get("email"), "label": "邮箱"})) - 模板内调用：
render("components/input_field.html", .EmailField)—— 注意是点号加变量名，不是字符串
嵌套 partial 的坑：循环中丢失数据引用
在 range 循环里调用 partial，容易误以为当前 . 会自动透传给子模板，实际不会。尤其当子模板依赖 .ID 或 .CreatedAt 时，必须手动绑定。
- 错误写法：
{{range .Posts}} {{partial "post/card.html"}} {{end}}→ 子模板拿不到当前.Post - 正确写法：
{{range .Posts}} {{render "post/card.html" .}} {{end}}（此时.指向当前 Post） - 更稳妥写法：
{{range .Posts}} {{render "post/card.html" (dict "post" . "currentUser" $.CurrentUser)}} {{end}}，用dict显式控制传入字段，避免意外污染 - 性能注意：频繁
render不影响服务端性能，但会增加模板解析开销；若卡片结构极简单（如仅显示标题），直接内联更轻量
真正难处理的不是语法，而是数据流设计——Buffalo 的模板层没有“组件生命周期”或“props 更新”概念，所有“局部复用”本质都是服务端的一次性数据快照。一旦你需要点击展开、异步加载、表单联动，就得切到 HTMX 或前端框架，Buffalo 模板只适合静态结构复用。
