自定义模板函数必须在Parse前注册，即在revel.Run()前于app/init.go的init()中将函数赋值给revel.TemplateFuncs，且需重启生效；签名须首字母大写、类型严格匹配，路径须正确，否则静默失败。
自定义模板函数必须在 Parse 前注册，否则 undefined 报错
Revel 模板引擎只在 Parse 阶段扫描函数名并绑定到 FuncMap，一旦模板加载完成，再调用 Funcs() 完全无效。常见错误写法：t := template.New("x"); t.ParseFiles("a.tmpl"); t.Funcs(fm) → 函数在模板里不可见。
正确做法是链式调用：template.New("name").Funcs(fm).ParseFiles("a.tmpl")。Revel 项目中，这个注册动作通常放在 app/init.go 的 init() 函数里，且必须在 revel.BuiltinValidators 等框架初始化之后、revel.Run() 之前执行。
-
FuncMap必须是全局变量或在init()中一次性构造好，不能延迟生成 - 别用
template.Must包裹ParseFiles—— 它不校验函数签名，错误会拖到模板执行时才暴露为空白输出 - Revel 默认使用
revel.TemplateLoader加载模板，它内部已封装了ParseFS流程，所以你只需确保FuncMap在revel.TemplateLoader.Init()前注册即可
函数签名必须严格匹配，首字母大写 + 明确类型
模板引擎通过反射调用函数，不支持类型自动转换。例如，想格式化时间，不能写 func FormatTime(v interface{}, layout string) string，因为模板传入的 .CreatedAt 若是 string 类型，函数内部强制转 time.Time 就会 panic。
正确签名应为：func FormatTime(t time.Time, layout string) string，并在模板中确保传入的是 time.Time 类型值（如 {{FormatTime .CreatedAt "2006-01-02"}}）。
- 接收指针参数时，必须先判空：
if v == nil { return "" }，否则reflect.ValueOf(v).Interface()会 panic - 函数名必须首字母大写，否则 Go 模板无法导出
- 别在函数里
panic—— 模板引擎会吞掉它，只输出空字符串，无日志、无堆栈
Revel 中注册自定义函数要改 app/init.go 并重启
Revel 不允许运行时热注册模板函数。所有自定义函数必须在应用启动前注册进全局 revel.TemplateFuncs，然后重启服务才生效。这是最容易被忽略的点：改完代码不重启，函数永远调不到。
典型注册位置在 app/init.go 的 init() 函数末尾：
func init() {
// 注册路由、拦截器等...
revel.InterceptMethod((*App).Begin, revel.BEFORE)
// ✅ 正确注册时机：在 revel.Run() 之前，且在 Revel 自身模板初始化之后
revel.TemplateFuncs["formatPrice"] = func(price float64) string {
return fmt.Sprintf("$%.2f", price)
}
}
- 不要在控制器或 action 里注册 —— 每次请求都注册毫无意义，且不会生效
- 修改
init.go后必须手动重启revel run，热重载不触发init()重执行 - 多个函数批量注册？直接用
map[string]interface{}赋值给revel.TemplateFuncs，但注意 key 是字符串，value 是函数值，不是函数名
路径和加载方式决定模板能否读到函数，别信相对路径
template.ParseFiles("templates/index.html") 的路径基准是 os.Getwd()，不是项目根目录，也不是 app/views。开发期最稳方案是用 embed.FS + template.ParseFS，把模板打包进二进制，路径绝对可靠。
Revel 默认走自己的 TemplateLoader，它已基于 embed.FS 实现（从 Revel 1.0+ 开始），所以你只要保证模板文件在 app/views/ 下、且路径拼写正确（比如 app/views/Application/Index.html），就能被正确加载。
- 别用
ParseGlob("templates/*.tmpl")—— 它不报错也不提示“没匹配到任何文件”，容易误以为加载成功 - 调试时可在模板里临时写
{{printf "%#v" .}}查看当前上下文，确认函数是否出现在作用域中 - 函数注册后仍报
undefined？90% 是路径问题或没重启，剩下 10% 是签名不匹配导致静默丢弃
函数注册本身不难，难的是时机、签名、路径三者严丝合缝。漏掉任一环，模板就安静地什么都不干——没有报错，也没有输出，只有空白页面在等你花半小时翻日志。
