使用gofiber/template需严格对齐路径、大小写和静态服务：html.new()路径须匹配文件位置且后缀含点；fiber.map键名首字母大写；app.static()必须显式挂载静态资源；开发时启用setdebug(true)开启热重载。
直接用 gofiber/template 渲染 HTML 是可行的，但默认配置下容易 404、变量不生效、静态资源 404、热重载失效——根本原因不是模板写错了，而是引擎初始化路径、路由顺序和文件生命周期没对齐。
html.New() 初始化时路径和后缀必须严格匹配
最常见的错误是 html.New("./views", ".html") 初始化后，实际文件放在了 ./templates 或漏了 .html 后缀，导致 c.Render("index", ) 找不到文件。
-
html.New()第一个参数是目录路径，必须是相对当前工作目录（即go run main.go所在路径）的合法路径；建议用os.Stat("./views")显式校验是否存在 - 第二个参数是后缀名，必须和文件真实后缀完全一致（包括点），比如文件叫
index.html，就传".html"；若传"html"会去找indexhtml文件 - Fiber 不会自动创建
views目录，也不递归搜索子目录；c.Render("admin/dashboard", )要求文件路径是./views/admin/dashboard.html - Windows 下路径分隔符不用手动处理，
filepath.Join或直接写"./views"都可，Fiber 内部已 normalize
fiber.Map 键名必须首字母大写才能在模板中访问
Go 的 map[string]interface{} 是严格区分大小写的，fiber.Map{"title": "Home"} 在模板里写 {{.Title}} 就取不到值。
- HTML 模板中访问字段必须用首字母大写的导出名，比如
fiber.Map{"Title": "Home", "UserCount": 123}→{{.Title}},{{.UserCount}} - 如果传的是 struct，字段也必须首字母大写且有导出权限；匿名 struct 字段不导出，
fiber.Map{"user": struct{ Name string }{Name: "Alice"}}中{{.user.Name}}会空，应改用fiber.Map{"User": struct{ Name string }{Name: "Alice"}} - 嵌套 map 可以多层展开，如
fiber.Map{"Data": fiber.Map{"ID": 1}}→{{.Data.ID}}，但不支持方法调用或复杂表达式（原生html/template限制）
静态资源必须单独挂载 app.Static()
gofiber/template 只负责 c.Render()，它不接管 /static/style.css 这类请求。如果你没配静态服务，浏览器直接 404。
- 必须显式调用
app.Static("/static", "./public")（假设 CSS 放在./public） -
app.Static()和模板引擎无关，即使你用了html.New()，也得单独配这一句 - 别把
app.Static("/", "./public")当成静态网站生成器（SSG）——它只是运行时按需读文件，每次请求都走磁盘 I/O，QPS 上不去，CDN 也无法缓存
开发阶段记得启用 SetDebug(true)
模板修改后不生效？大概率是缓存没关。Fiber 默认会缓存编译后的模板，SetDebug(true) 才能实现热重载。
- 在初始化引擎后立即调用：
engine := html.New("./views", ".html"); engine.SetDebug(true) - 该设置仅影响开发，生产环境请关闭（默认就是 false）
- 不启用时，哪怕你改了
index.html，Fiber 仍返回旧版本，且无任何提示
最容易被忽略的是：模板路径、键名大小写、静态服务三者必须同时对齐；缺一不可。哪怕只错一个点，比如 views 目录少个 s，或者 fiber.Map{"Title"} 写成 {"title"}，页面就静默失败——既不报错，也不渲染变量，只会留空。
