注册自定义模板函数必须在app.go的App()初始化阶段完成，即buffalo.New()之后、return app之前调用app.Templates.Funcs()，否则模板无法识别；函数名不可与Buffalo默认函数冲突，建议加前缀避免覆盖。
注册自定义模板函数必须在 app.go 的 App() 初始化阶段完成
Buffalo 的模板函数不是“随时可加”的，它依赖于 app.Templates 的底层 html/template 实例。这个实例只在 App() 函数中由 buffalo.New() 创建并缓存，之后再修改 FuncMap 不生效——你写进去了，模板里却调不到。
常见错误现象：在某个 action 里用 c.Template().Funcs(...) 或单独 new 一个 template 并注册函数，结果模板渲染时报 function "myfunc" not defined。
- 必须在
app.go文件中，app := buffalo.New(...)之后、return app之前插入注册逻辑 - 注册方式是调用
app.Templates.Funcs(map[string]interface{}{...}) - 函数签名需严格匹配 Go 模板规则：第一个参数是接收值（如
string），返回值可以是任意类型（但建议带 error 便于模板内判断）
app.Templates.Funcs(template.FuncMap{
"required": func(s string) bool {
return s != ""
},
"pluralize": func(s string) string {
// 简单复数规则（实际应使用 inflect.Pluralize）
if strings.HasSuffix(s, "y") && !strings.HasSuffix(s, "ay") && !strings.HasSuffix(s, "ey") {
return strings.TrimSuffix(s, "y") + "ies"
}
return s + "s"
},
})
函数名不能与内置函数或 Buffalo 默认注册的函数冲突
Buffalo 默认注册了 urlfor、contentFor、csrf_token 等约 20 个函数，还通过 inflect 包注入了 pluralize、singularize、titleize 等。如果你重复注册同名函数，后注册的会覆盖前一个，但 Buffalo 的默认函数在 buffalo.New() 内部已先注册完毕——所以你在 app.Templates.Funcs() 里写的同名函数，反而会把 Buffalo 自带的干掉。
典型踩坑：自己写了 "pluralize": myPluralize，结果 {{ "cat" | pluralize }} 输出异常，因为 Buffalo 原生的 inflect.Pluralize 被替换了，而你的实现没处理不规则变化（如 mouse → mice）。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 查默认函数列表：看
github.com/gobuffalo/buffalo/render/template.go中的defaultFuncMap() - 若想扩展而非覆盖，函数名加前缀，比如
"my_required"、"my_pluralize" - 若真要替换内置行为（如定制
urlfor），务必确保新函数完全兼容原签名和语义，否则路由生成会出错
模板中调用时注意作用域和参数传递顺序
Go 模板函数不支持命名参数，所有参数都靠位置传递，且管道符 | 左侧值自动作为第一个参数。这意味着 {{ .Name | required }} 等价于 required(.Name)，而 {{ "email" | required "Email is required" }} 是 required("email", "Email is required")——但后者要求你的函数定义为 func(string, string) bool，否则 panic。
容易忽略的点：模板里传入的值可能为 nil 或未导出字段，函数内部需做类型断言或空值防护，否则渲染直接崩溃。
- 推荐函数签名统一用
interface{}接收首参，再内部转换，避免模板传非预期类型时 panic - 不要在函数里调用
c.Render()或任何依赖buffalo.Context的东西——模板函数运行时没有 context - 若需访问请求上下文（如 locale、session），应改用
context.Value注入，或在 action 中预计算好传入模板
调试模板函数失败最有效的办法是看 panic 日志和渲染上下文
Buffalo 在开发模式下对模板错误非常“诚实”：函数 panic 会完整打印堆栈到终端，包括哪行模板、哪个文件、什么参数触发。但日志里不会显示“函数未定义”这种提示——它只会报 template: xxx.html:12: function "xxx" not defined，此时你要立刻检查三件事：
- 是否漏写了
app.Templates.Funcs(...)，或写在了buffalo.New()之前 - 函数名拼写是否和模板中
{{ ... | myfunc }}完全一致（大小写敏感） - 是否在
templates/下某子目录用了独立template.Must(template.New(...).Funcs(...))，导致局部模板没继承全局 FuncMap
真正复杂的地方在于：Buffalo 的 Templates 是分组管理的（HTML / JSON / XML），而 app.Templates 默认只管 HTML；如果你在 r.JSON(...) 中用了自定义函数，那得单独给 JSON 模板注册——但 JSON 模板根本不执行函数，它走的是 json.Marshal，这点常被忽略。
