Fiber模板引擎中Funcs()必须在ParseGlob()前调用，因引擎仅对未加载模板生效；路径需字节级匹配根目录，函数须首字母大写、签名严格一致且无闭包。
模板渲染在 Fiber 中不是开箱即用的功能，必须手动集成 html.New() 并严格按 Funcs() → ParseGlob() 顺序注册函数，否则必报 function not defined 或 template not found。
为什么 engine.Funcs() 放在 ParseGlob() 后面就失效？
Fiber 的模板引擎（基于 html/template）只对“尚未加载”的模板生效。一旦调过 ParseGlob() 或 Load()，所有模板已编译进内存，后续再调 Funcs() 不会重载或修补已有模板。
- ✅ 正确顺序：
engine := html.New("./views", ".html"); engine.Funcs(myFuncs); engine.ParseGlob("./views/*.html") - ❌ 常见翻车：
engine.ParseGlob(...); engine.Funcs(...)—— 这行Funcs白写了，函数在模板里始终报function "xxx" not defined - ⚠️ 注意：
AddFunc("name", fn)可随时调，但只影响之后新解析的模板（比如用ParseFiles()动态加载），不改变已加载模板行为
render: template index not found 真正原因不是代码写错
90% 的 template not found 是路径没对齐，和代码逻辑无关。Fiber 的 html.New() 第一个参数是**模板根目录的文件系统路径**，不是相对引用前缀。
- 假设文件结构是
./views/index.html，必须写html.New("./views", ".html")，不是"views"（缺.）、"./templates"（目录名错）或"views/"（末尾斜杠可能触发不同行为） -
engine.Render(c, "index", data)中的"index"是模板名（不含扩展名），引擎会自动拼成./views/index.html；若文件实际叫index.tmpl，而你设了后缀".html"，就会找不到 - 上线环境务必确认工作目录：加一行
log.Println("cwd:", os.Getwd())，避免开发时go run main.go和部署时./myapp路径不一致
自定义函数为什么在模板里调不到？
函数必须同时满足三个硬性条件，缺一不可，否则静默忽略——错误信息只说 function "xxx" not defined，不会提示“未导出”或“签名不匹配”。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- ✅ 首字母大写：
func FormatTime(t time.Time, layout string) string✅，func formatTime(...)❌（小写不导出，反射拿不到） - ✅ 参数与返回值严格匹配：模板中写
{{.CreatedAt | FormatTime "2006-01-02"}}，函数就必须接收两个参数（time.Time+string），且返回单个string；多返回值（如(string, error)）或类型不一致（如把string当int）都会失效 - ✅ 别传闭包或带状态的函数：模板执行无状态，无法捕获外部变量；想用配置、DB 实例等，得提前注入到
data结构体里，或用全局变量（不推荐）
HTML 内容被当成纯文本显示？
这是 html/template 的安全机制生效了，不是渲染失败。
- 务必 import
"html/template"，不是"text/template"；后者不转义但也不安全，且浏览器可能解析失败 - 可信 HTML 才用
{{.Content | safeHTML}}（注意大小写，是内置函数，不是自定义） - 别用
strings.ReplaceAll拼接 HTML 后塞进模板——等于主动绕过转义，开 XSS 后门 - 整块模板都不想转义？说明设计有误：富文本内容走
safeHTML，按钮、表单等结构化内容应由模板原生生成
最易被忽略的是：函数注册顺序和路径字节级一致性。哪怕多一个点、少一个斜杠、函数名首字母小写，都会导致静默失败，而错误信息毫无指向性。
