Revel模板中自定义函数必须通过revel.TemplateFuncs在app/init.go的init()函数中全局注册，未注册则报“function not defined”错误；函数签名需匹配html/template要求，不可含闭包，参数按值传递，nil需手动处理。
Revel模板中添加自定义函数必须通过revel.TemplateFuncs注册
Revel不支持在模板里直接定义函数（比如{{define "myfunc"}}），所有自定义函数必须在应用启动时，通过revel.TemplateFuncs全局注册。它是一个map[string]interface{}，key是模板中调用的函数名，value是Go函数值。未注册就使用会报function "xxx" not defined错误。
常见错误现象：{{myUpper .Name}}在模板里报错，但代码里明明写了strings.ToUpper——根本原因是没注册进TemplateFuncs，模板引擎压根“不认识”这个函数名。
- 注册时机：必须在
app/init.go的init()函数中，在revel.InterceptMethod等调用之前完成 - 函数签名需严格匹配：参数和返回值类型要能被
html/template识别，如func(string) string、func(interface{}) bool - 不能带闭包捕获外部变量：注册的是函数值，不是闭包；若需访问
*revel.Controller或配置，得提前绑定或改用模板方法（.c上下文）
eq、set这些内置函数其实也是靠TemplateFuncs注册的
Revel源码里，eq、set、field等函数并非语言级特性，而是框架在revel.NewApp阶段统一注入到TemplateFuncs里的。这意味着你写的自定义函数和它们处于完全相同的执行层级，享有同等能力——比如也能接收.errors或.flash这样的上下文字段。
一个典型误用：想在自定义函数里直接读c.RenderArgs["user"]。不行——函数本身没有c参数。正确做法是让模板传入所需数据：{{myFormat .user .lang}}，函数定义为func(user interface{}, lang string) string。
- 性能影响：函数体应轻量，避免IO或复杂计算；模板渲染是同步阻塞的，慢函数会拖垮整个页面响应
- 参数差异：模板传参是按值拷贝的，对
struct或slice做修改不会影响原始RenderArgs - nil安全必须自己处理：比如
{{myJoin .items ", "}}中.items可能是nil，函数内要先判空
实战示例：注册一个安全的truncate函数
需求：截断字符串并加…，但要防止panic（如输入nil、负数长度）。不能依赖strings包原生函数裸用。
// app/init.go
import "strings"
func init() {
revel.TemplateFuncs["truncate"] = func(s interface{}, n int) string {
if s == nil {
return ""
}
str, ok := s.(string)
if !ok {
str = fmt.Sprintf("%v", s)
}
if n <= 0 || len(str) <= n {
return str
}
if n < 3 {
return str[:n]
}
return str[:n-3] + "..."
}
}
模板中调用：{{truncate .title 20}}。注意这里n是硬编码长度，不是rune数——如果需要Unicode安全截断，得用utf8.RuneCountInString重写，但会略慢，按场景权衡。
- 容易踩的坑：把
func(string, int) string错写成func(string, int)（少返回值），会导致编译失败且错误提示模糊 - 调试技巧：在函数开头加
revel.INFO.Printf("truncate called with %v, %d", s, n)，开发模式下可快速定位传参问题 - 测试建议：单独为该函数写单元测试，覆盖
nil、空串、超长、负数等边界
为什么不用template.FuncMap单独传给某个template.Parse？
因为Revel的模板加载是自动化的——路由匹配后，框架内部调用template.New().Funcs(...).ParseFiles(...)，你无法干预这个过程。试图在控制器里手动Parse并传FuncMap，会导致include、template等嵌套行为失效，且.errors、.flash等Revel上下文变量丢失。
唯一例外是测试场景：用html/template独立解析单个文件做UT时，可以传FuncMap，但这和Revel运行时无关。
- 兼容性影响：注册到
TemplateFuncs的函数对所有模板生效，包括errors/404.html、header.html等共享模板 - 命名冲突风险：不要覆盖
eq、len等Go模板原生函数，Revel注册逻辑不检查重复，后注册的会静默覆盖前一个 - 最易忽略的一点：修改
init.go后必须重启Revel服务，热编译不触发init()重执行
