自定义函数必须是首字母大写的导出函数，需在parse前通过funcs注册，签名须严格匹配，不支持匿名函数、闭包及多返回值解构，类型不匹配将panic。
自定义函数必须是首字母大写的导出函数
模板引擎只认 func MyFunc(...) 这种形式的函数，func myFunc(...) 会被静默忽略，渲染时报 function "myFunc" not defined，但不提示“未导出”，容易卡住半天。
- 哪怕函数逻辑简单、只想在本包用，也得包一层导出函数，比如
func Upper(s string) string { return strings.ToUpper(s) } - 别往
template.FuncMap里塞匿名函数或闭包，template包不支持运行时动态函数，只接受具名、可导出、签名明确的函数值 - 如果函数在另一个包里，确保它已导出（首字母大写）且该包已被导入
Funcs 必须在 Parse 之前调用
FuncMap 是在解析阶段绑定进 AST 的，不是运行时查表。一旦 Parse 或 ParseFiles 完成，函数映射就固化了。
- 错误写法：
t := template.New("t"); t.ParseFiles("a.tmpl"); t.Funcs(f)—— 新加的函数在已解析的模板里完全不可见 - 正确写法：链式调用，
t := template.Must(template.New("t").Funcs(f).ParseFiles("a.tmpl")) - 如果用
template.ParseGlob，同样要确保Funcs在它之前完成
参数和返回值类型必须严格匹配
模板传参一律是 interface{}，函数签名得自己处理类型断言；模板引擎不做任何类型转换，不匹配就 panic。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 比如注册了
func FormatTime(t time.Time, layout string) string，模板里写{{.CreatedAt | formatTime "2006-01-02"}}，那.CreatedAt就必须是time.Time类型；如果是字符串，会 panic：reflect: Call using *string as type time.Time - 用
{{index .Items 0}}取切片元素再传给函数，函数收到的是interface{}，不是原类型，需手动断言 - 返回多个值的函数（如
func Split(s, sep string) (string, string)）在模板中只能取第一个返回值，其余丢弃，且无法解构
错误处理不能依赖 panic，得靠函数内部兜底
模板不会检查函数是否返回 error，也不会中断渲染。想让错误可控，得在函数里做防御性处理。
- 不要让自定义函数直接 panic，比如对空指针或非法时间格式不做判断
- 推荐返回默认值或空字符串，例如
if t.IsZero() { return "" } - 如果需要条件分支，用
{{if .Field}}{{formatDate .Field}}{{else}}—{{end}}比在函数里硬塞逻辑更清晰
最容易被忽略的是：函数签名一旦写错（比如参数类型漏了指针、返回值少写了括号），编译期可能不报错，但运行时模板一调用就 panic，而且堆栈不指向函数定义处，而是指向 reflect.Call —— 这时候得回头逐行核对 FuncMap 里的每个函数签名。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
