Buffalo默认启用HTML模板渲染，但需确保templates/目录存在、文件命名规范（如users/show.html对应路径"users/show"）、扩展名为.html或.plush.html，且r.HTML()调用路径能正确解析；否则易报"template not found"。
模板渲染默认启用但需确认路径和扩展名
Buffalo 默认启用 HTML 模板渲染，但前提是 templates/ 目录存在、文件命名符合约定，且 r.HTML() 调用时传入的路径能被正确解析。常见错误是返回 "template not found"，实际原因往往不是模板没写，而是路径拼错或后缀没匹配。
- 模板文件必须放在
templates/下，子目录会被自动识别为命名空间，例如templates/users/show.html对应路径"users/show" - 文件扩展名必须是
.html（默认）或显式注册的其他类型，如.plush.html；Buffalo 不识别.gohtml或纯.html.plush -
r.HTML("home")会按顺序查找：templates/home.html→templates/home.plush.html→templates/home/index.html - 若用
buffalo new --api创建项目，templates/目录默认被删掉，此时调用r.HTML()必然 panic，需手动补回目录并确保app.Use(plugins.Static())未被误删（否则render无法加载模板）
自定义模板函数必须在 app.go 中注册
Buffalo 的模板引擎基于 Plush，支持自定义函数，但这些函数不会自动生效——必须在 app.go 的初始化阶段通过 plush.RegisterFunc 注册，否则模板里调用会静默失败或报 "function not defined"。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 在
app.go的func App() *buffalo.App函数内、app = buffalo.New(...)之后添加注册代码 - 示例：注册一个校验空值的函数
required：plush.RegisterFunc("required", func(s string) bool { return s != "" }) - 函数签名必须是可序列化的 Go 类型（不能含指针、channel、func），且参数数量固定；Plush 不支持变参或泛型推导
- 避免在模板中做复杂逻辑，比如数据库查询或 HTTP 调用——这些应该在 handler 里完成，再把结果传给模板
HTML 渲染与 JSON 渲染共存时注意 Content-Type 自动推断
Buffalo 的 r.Auto() 会根据请求头 Accept 自动选择 HTML 或 JSON 渲染，但这个行为容易引发意料外的响应格式，尤其在前后端分离场景下。
-
r.Auto(c, data)在Accept: text/html时走r.HTML()，在Accept: application/json时走r.JSON()；若 header 缺失或模糊（如Accept: */*），默认 fallback 到 HTML - API 服务应禁用
r.Auto()，统一用r.JSON()，并在app.Use()中加中间件强制设置Content-Type: application/json - 若需同一 endpoint 支持多格式，建议显式判断：
if c.Request().Header.Get("Accept") == "application/json" { return c.Render(200, r.JSON(data)) } else { return c.Render(200, r.HTML("page.html")) } - 注意：Plush 模板里的
{{ json .Data }}是字符串转义输出，不是真正的 JSON 响应，别把它和r.JSON()混用
模板热重载只在 buffalo dev 下生效，build 后失效
Buffalo 的模板修改实时生效依赖于开发服务器的文件监听机制，一旦执行 buffalo build 或用 go run 启动，模板变更必须重新编译二进制才能生效——这点常被忽略，导致本地调试正常、上线后模板不更新。
-
buffalo dev会自动监听templates/和actions/下的改动，无需重启 -
buffalo build默认将模板打包进二进制（通过 packr），但若项目中删了packr依赖或禁用了 asset 打包，运行时会尝试从文件系统读取templates/，此时需确保部署包里包含该目录 - 生产环境不要依赖热重载，应把模板作为构建产物固化；CI/CD 流程中建议加校验步骤，比如
find templates -name "*.html" | xargs ls -l确认模板存在 - 若用 Docker 部署，注意挂载
templates/目录的权限问题：容器内进程需有读取权限，否则open templates/foo.html: permission denied
