Go模板渲染切片需用{{range}}遍历并显式处理HTML转义，Gin中c.HTML()要求模板路径正确、数据结构匹配且预处理空值/时间/布尔等字段，推荐用FuncMap复用格式化逻辑。

模板里用 {{.}} 直接渲染切片会出错

Go 的 html/template 默认禁止直接输出未转义的 HTML 字符，而表格结构（如 <tr><td>）本质是 HTML 片段。如果把一个 <code>[]map[string]interface{} 或结构体切片直接传给模板并写成 {{.}}，页面只会显示空或报错 template: …: html escaping not supported for …。

• 必须显式使用 {{range}} 遍历数据，逐行生成 <tr> <li>字段值要用 <code>{{.FieldName | safe}}（仅当确认内容可信）或提前在 Go 层拼好带标签的字符串
• 避免在模板里做逻辑判断——比如“空值显示 -”，应提前在 handler 中处理好

Gin 的 c.HTML() 要求模板路径和数据结构对齐

Gin 不自动查找子目录，c.HTML() 的第一个参数是 HTTP 状态码，第二个是模板文件名（不含扩展名），第三个是传入的数据。模板文件必须放在 templates/ 目录下，且 Gin 初始化时需调用 engine.LoadHTMLGlob("templates/**/*")。

• 模板路径错误会导致 template: …: no template "xxx.html"
• 传入数据类型要和模板中引用的字段名严格匹配，比如模板写 {{.Users}}，那 handler 就得传 map[string]interface{}{"Users": users} 或定义含 Users 字段的 struct
• 如果表格数据是 []User，别传 users 本身，而应包装成 map 或 struct，否则模板里无法用 {{.Users}} 引用

表格列宽、对齐、空值处理得在 Go 层预处理

HTML 表格的样式和语义不能全靠 CSS 补救。比如时间戳字段 CreatedAt time.Time，模板里不能直接写 {{.CreatedAt}}（会输出完整 Go time 格式），也不能让前端 JS 处理——Gin 渲染是服务端一次性完成的。


DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
下载
• 在 handler 中把 time.Time 转成 CreatedAtStr string 字段，再传给模板
• 布尔字段建议转成中文 “是/否” 或图标 HTML 字符串（如 ✔），并加 | safe
• 数值为空时，不要依赖模板里的 {{if .Field}}{{.Field}}{{else}}-{{end}}，容易漏判 nil 或零值；统一在 Go 层赋默认值更可控

用 template.FuncMap 复用格式化逻辑

多个表格都要格式化时间、货币、状态标签时，硬编码在每个 handler 里会重复。Gin 允许注册自定义模板函数，比在每个 struct 上加方法更轻量。

立即学习“go语言免费学习笔记（深入）”；

• 定义函数如 formatTime := func(t time.Time) string { return t.Format("2006-01-02") }
• 初始化 Gin engine 后，调用 engine.SetFuncMap(template.FuncMap{"fTime": formatTime})
• 模板中即可写 {{fTime .CreatedAt}}，无需提前转换字段
• 注意：函数返回值若含 HTML，仍需在调用处加 | safe，比如 {{statusBadge .Status | safe}}
实际渲染时最常卡在模板路径没加载、数据字段名不一致、HTML 字符没标记 safe 这三点。只要确保 LoadHTMLGlob 调用在 Run 前，传参用命名 map，所有动态 HTML 片段都走 | safe，基本不会崩。