html/template 直接支持结构体切片遍历，需确保字段首字母大写、传入非nil切片，并用{{range .Slice}}访问；空切片安全，nil指针会panic；嵌套字段和方法调用需防nil和多返回值；复杂逻辑应预计算，避免模板内重复调用。
用 html/template 直接 range 渲染结构体切片
Go 的标准 html/template 完全支持结构体切片遍历，不需要额外序列化或中间转换。关键在于模板中正确使用 range 和字段访问语法。
常见错误是把切片传给模板时用了指针解引用（如 {{range .Data}} 却传了 &data），或者字段未导出（首字母小写）导致模板里取不到值。
- 结构体字段必须首字母大写（
exported），否则template无法访问 - 传入模板的数据应是切片本身，不是指向切片的指针（除非你明确想在模板里用
*[]T） -
range会自动将当前项绑定为.，可直接用.FieldName访问
{{range .Users}}
<tr>
<td>{{.Name}}</td>
<td>{{.Age}}</td>
<td>{{.Email}}</td>
</tr>
{{end}}
处理空切片或 nil 切片避免 panic
range 对 nil 切片是安全的（不会 panic），但若传入的是 nil 指针（比如 *[]User 为 nil），模板执行会报 invalid memory address 错误。
更常见的是业务逻辑中忘记初始化切片，导致前端表格空白且无提示。
- 服务端渲染前主动检查：用
if len(users) == 0判断，再决定是否传空切片或带默认提示的数据 - 模板内可用
{{if .Users}}{{range .Users}}...{{else}}暂无数据 - 不要依赖
nil切片做“空状态”逻辑——Go 中nil []T和[]T{}行为一致，但指针类型不等价
嵌套结构体字段与方法调用的注意事项
如果结构体字段是嵌套结构体（如 User.Profile.AvatarURL），或你想调用结构体方法（如 .CreatedAt.Format("2006-01-02")），必须确保方法签名符合模板规则：接收者是值或指针均可，但返回值只能有一个且不能是 error。
容易踩坑的是时间格式化——time.Time 的 Format 方法返回 string，可以直接用；但自定义方法若返回多个值（如 func() (string, error)），模板会静默忽略。
- 嵌套字段访问支持多层点号：
{{.Profile.Name}}，但中间任意一级为nil会 panic - 调用方法前建议先判空：
{{if .CreatedAt}}{{.CreatedAt.Format "2006-01-02"}}{{end}} - 避免在模板里做复杂逻辑，比如条件拼接 URL——提取成结构体方法更可控、易测
性能敏感场景下避免重复计算
模板每次执行都会重新求值，如果在 range 内反复调用同一个方法（如 {{.GetStatusColor}}），且该方法内部有 IO 或复杂计算，会显著拖慢渲染速度。
典型例子是权限判断、状态映射、URL 构造等——这些本该在 handler 层预计算好，而不是丢给模板现场算。
- 把衍生字段提前塞进结构体：比如加一个
DisplayStatus string字段，在 handler 里赋值 - 用
map[string]interface{}包装数据时尤其危险——类型丢失 + 运行时反射开销更大 - 如果必须复用逻辑，定义 template func（
template.New("t").Funcs(...)），但仅限纯函数，别带副作用
表格渲染本身开销不大，真正卡住的是模板里藏了隐式数据库查询、HTTP 调用或循环嵌套渲染。盯住 go tool trace 里的 template.Execute 阶段耗时，比盲目优化 HTML 更有效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
