Buffalo 框架硬编码集成 Plush 模板引擎，不提供入门教程；模板须用 buffalo generate 命令生成，路径/命名/结构固定；c.Render() 调用 Plush 渲染，c.HTML() 仅输出字符串；partial 需显式传参；无法替换为 html/template，因渲染逻辑深度耦合框架源码。

Buffalo 框架不提供“Plush 入门教程”这个东西——它只提供 plush 这个模板引擎的默认集成，而你用不用、怎么用、能不能换，全由框架硬编码逻辑决定。想上手，得先看清边界。

Plush 模板文件怎么生成才有效

Buffalo 不允许你手动创建空 .html 文件然后指望 c.Render() 自动识别。模板必须由框架命令生成，否则路径、命名、上下文注入全失效。

• buffalo generate resource users name:string 是唯一可靠方式：它会在 templates/users/ 下生成 index.html、show.html 等全套文件，且已预置 {{ yield }}、{{ partial }} 和 render("shared/errors.html", {errors: errors}) 结构
• buffalo generate action users#new 也能建 templates/users/new.html，但仅限非 API 场景；加了 --api 就不生成任何模板
• 所有模板路径固定为 templates//.html，不能改目录、不能换后缀（比如 .gohtml），改了就得绕过 c.Render() 手动执行 template.ParseFiles

c.Render() 和 c.HTML() 的区别不是语义，是执行路径

c.HTML() 完全跳过 Plush，只做字符串响应；c.Render() 才真正调用 plush.Render 并注入数据。错用就等于白写模板。

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

• c.HTML(200, "

  {{ .Name }}

  ") → 页面原样输出 {{ .Name }}，变量不会被替换
• 正确写法：c.Render(200, r.HTML("users/show.html"), User{Name: "Alice"})，模板里才能用 {{ .Name }}
• 结构体字段必须首字母大写（Name string ✅，name string ❌），否则 Plush 读不到；传 map[string]interface{} 也行，但 key 必须是 string 且拼写一致（"Name" 对应 .Name）

partial 怎么传参？别指望自动继承

Plush 的 partial 不共享父模板的 .data，每个 partial 都要显式构造独立上下文，漏传字段就会渲染失败。

• 错误写法：{{ partial "nav.html" }} → nav.html 看不到 .CurrentUser 或 .Flash
• 正确写法：{{ html.Partial "partials/_nav.html" (dict "User" .CurrentUser "Active" "home") }}，dict 是内置 helper，不能用 Go 原生 map 字面量
• 如果 partial 里还要嵌套另一个 partial（比如 _nav.html 调 _avatar.html），必须显式把需要的字段再传一遍：(dict "User" .User "Size" "small")，不能假设“上游有我就有”

想换 html/template？不是语法问题，是框架锁死

Buffalo 的 app.Renderer 字段私有，c.Render() 底层硬编码调用 plush.Render，连中间件拦截都不可靠。所谓“接入自定义模板引擎”，实际只有两条路：

• 放弃 c.Render()：在 handler 里手动用 template.ParseFiles("templates/home.html") + t.Execute(c.Response(), data)，但会丢掉 partial、layout、block、CSRF、Flash 等全部 Buffalo 渲染链功能
• 接受 Plush：它本就兼容 {{ .Name }} 语法，只需初始化时加 plush.WithDelims("{{", "}}")；需要日期格式化等函数，直接 plush.RegisterFunc("format_date", ...) 注册即可
• 真正卡住你的从来不是 Plush 语法，而是 Buffalo 把渲染深度耦合进了整个请求生命周期——这不是配置项，是源码级硬编码