自定义函数必须在beego.Run()前注册，否则静默失效；应于init()中调用beego.AddFuncMap，确保在beego.Run()之前执行，且函数签名须严格匹配参数个数与类型。
自定义函数必须在 beego.Run() 前注册
Beego 的模板函数映射表是启动时一次性初始化的，beego.Run() 之后再调用 beego.AddFuncMap() 完全无效——函数不会出现在模板里，也不会报错，只会静默失效。
常见错误现象：utils.Init() 写在 main() 函数里、或写在 beego.Run() 之后；又或者放在某个 controller 的 Init() 方法中——这些位置都晚了。
正确做法是：在 init() 函数中注册，且确保该 init() 在 beego.Run() 调用前执行。典型结构如下：
func init() {
models.Init()
utils.Init() // ← 这里必须在 beego.Run() 之前
}
func main() {
beego.Run() // ← 所有 AddFuncMap 必须在此前完成
}
{{.Value | myFunc}} 和 {{myFunc .Value}} 语法差异
两种写法都合法，但行为不同：
-
{{.Value | myFunc}}：管道语法，把.Value作为第一个参数传给myFunc，适合单参数函数 -
{{myFunc .Value}}：函数调用语法，支持多参数，如{{formatTime .CreatedAt "2006-01-02"}}
注意：函数签名必须严格匹配。例如定义为 func FormatTime(t string, layout string) string，就不能用 {{.Time | FormatTime}}，因为管道只传一个值，第二个参数 layout 缺失。
Beego 不做参数自动补全或类型推导，参数个数/类型错会导致模板渲染 panic，错误信息类似：template: index.html:12:15: executing "index.html" at
函数参数类型限制与常见坑
Go 模板函数接收的参数类型只能是 Go 原生可序列化类型（string、int、bool、time.Time、map[string]interface{}、[]interface{} 等），不能直接传入 struct 指针或自定义类型（除非实现了 String() 或 MarshalText()）。
容易踩的坑：
- 想传
*models.User却没导出字段（字段名小写）→ 模板里取不到任何值，输出空字符串 - 传
time.Time却在函数里用fmt.Sprintf("%v", t)→ 输出带时区和纳秒的完整字符串，不是预期格式 - 函数返回
error类型 → 模板不处理 error，会直接 panic，必须用if err != nil { return "" }显式兜底
建议：所有自定义函数入口统一做非空和类型检查，比如对 nil interface{} 做 if v == nil { return "" }，避免模板崩溃。
模板路径与函数可见性无关，但扩展名要配对
函数注册成功后，在任意 .html、.tpl 或 .gohtml 模板里都能用，不依赖文件位置或目录结构。但前提是模板本身能被 Beego 正确加载。
如果你用了非标准后缀（比如 .vue 或 .ftl），必须提前调用：
beego.AddTemplateExt("vue")
否则 Beego 根本不会尝试解析该文件，函数再全也没机会执行。默认只识别 .html 和 .tpl，.gohtml 是 Go 标准库原生支持的，Beego 也兼容，但显式添加更稳妥。
另外，views/ 目录路径可通过 beego.BConfig.WebConfig.ViewsPath 修改，但这只影响模板查找路径，不影响函数作用域——函数全局可用。
