模板渲染需手动集成html.new()并严格按funcs()→parseglob()顺序注册函数，路径须与文件系统逐字节一致，首字母大写导出函数且签名匹配，否则静默失败。
模板渲染在 Fiber 中不是开箱即用的功能，必须手动集成并严格遵循注册顺序，否则必报 function not defined 或 template not found。
html.New() 必须在 ParseGlob 前调 Funcs()
Fiber 不自带模板引擎，你得自己初始化 html.New() 实例，并在调用 .ParseGlob() 或 .Load() 之前完成函数注册。顺序错了，新加的函数对已加载模板完全无效。
-
.Funcs(map[string]interface{}{"formatTime": formatTime})必须出现在.ParseGlob("./views/*.html")之前 -
.AddFunc("upper", strings.ToUpper)可随时调，但只对后续新解析的模板生效 - 如果已执行过
engine.Load()，再补.Funcs()，不会自动重载——得重启服务或显式再调一次.Load() - 常见翻车写法：
engine := html.New("./views", ".html"); engine.ParseGlob(...); engine.Funcs(...)—— 这行Funcs白写了
自定义函数必须首字母大写且签名严格匹配
模板引擎只识别导出函数（首字母大写），且参数类型、返回值数量/类型必须和模板中调用方式完全一致，否则静默忽略，报错时只说 function "xxx" not defined，不提示“未导出”。
- ✅ 正确：
func FormatTime(t time.Time, layout string) string，模板中写{{.CreatedAt | FormatTime "2006-01-02"}} - ❌ 无效：
func formatTime(...)（小写）、func FormatTime(t string, ...)（类型不匹配）、func FormatTime() (string, error)（多返回未处理） - 别传闭包或带状态的函数——模板执行是无状态的，外部变量无法捕获
- 函数返回
error时，模板不会中断渲染，也不会暴露错误；想处理失败，得内部转成字符串或配合{{if}}判断
模板路径和文件名必须与实际文件系统一致
报 render: template index not found 多数不是代码问题，而是路径没对齐。Fiber 的 html.New() 第一个参数是根目录，不是模板名前缀。
- 假设文件结构是
./views/index.html，则应写html.New("./views", ".html")，不是html.New("views", ".html")或html.New("./templates", ".html") -
engine.Render(c, "index", data)中的"index"是模板名（不含扩展名），它会自动拼./views/index.html - 若用
.ParseFiles("index.html")，路径必须是相对运行目录的完整路径，比如"./views/index.html"，不能只写"index.html" - Linux 服务器上注意大小写：文件叫
Index.html，但代码里写"index"就会找不到
c.Render() 调用前确保模板和函数都已就绪
c.Render() 是同步阻塞调用，但它不负责加载或注册逻辑——这些都得在启动阶段一次性配好。一旦配错，每次请求都失败。
- 不要在 handler 里动态新建
html.Engine或反复调.Funcs()，性能差且状态不可控 - 注册函数和加载模板必须在
app.Listen()之前完成，推荐放在main()初始化块里 - 嵌套模板（
{{template "header"}}）要求子模板名与template.New("header")中的名字一致，建议和文件名保持相同 - 调试时先用
engine.Lookup("index") != nil检查模板是否成功加载，比等渲染报错更早发现问题
最容易被忽略的是：函数注册时机和模板加载时机必须严格串行，且路径字符串要和操作系统实际路径逐字节一致——少一个点、多一个斜杠、大小写差一位，都会让整个渲染链路静默失败。
