Go模板range遍历切片时子项字段取不到，主因是结构体字段未导出（首字母小写），导致反射访问失败或静默丢值；须确保所有嵌套层级字段均导出，且空切片需用if判断兜底，多级目录模板define名称须与加载路径一致。
模板里用 range 遍历切片，但结构体字段必须导出
Go 的 html/template 只能访问首字母大写的导出字段。如果切片元素是 struct，里面字段像 name string（小写）就不会被渲染出来，页面留空也不报错——这是最常卡住的地方。
实操建议：
- 确保切片元素类型的所有字段名首字母大写，例如
Name string、Age int - 传入模板的数据不能是局部变量或匿名 struct 字面量，得是命名类型或
gin.H（它底层是map[string]interface{}，键名自动导出） - 避免直接传
[]map[string]interface{}，虽然能 work，但可读性和类型安全差
range 语法细节：索引、值、嵌套层级别写错
模板中写 {{range .Users}} 是最简形式，但容易漏掉上下文切换带来的变量作用域问题。比如在 range 内部想访问外层数据（如分页总数），得用 $ 显式引用根对象。
常见错误现象：
-
{{.Name}}在range内正常，但{{.Total}}（外层字段）拿不到，变成空 - 嵌套
range时误用.Item.Tags，实际Tags是另一个切片，没加第二层range就只输出%!s([]string) - 用
{{range $index, $user := .Users}}却忘了在循环内用$user.Name，仍写.Name导致 nil 指针 panic（如果.Users有 nil 元素）
切片为空时模板不渲染，但你可能需要显示“暂无数据”
Gin 默认对空切片不做任何输出，{{range .Items}} 块直接跳过。这和前端预期不符——用户看到一片空白，不知道是加载失败还是真没数据。
解决方式只有两种，没有第三种：
- 用
{{if .Items}}{{range .Items}}...{{else}}暂无数据
{{end}} - 后端统一保证传入的切片非 nil：哪怕数据库查不到，也返回
[]User{}而不是nil；Gin 不会把 nil 切片转成空 slice，模板里.Items就是nil，range直接 panic
多级目录模板下，define 名称必须带路径前缀
如果你用 r.LoadHTMLGlob("templates/**/*") 加载了 templates/admin/users/index.html，那这个文件里写 {{define "index.html"}} 是无效的——Gin 查找模板时用的是完整路径名，实际注册的是 "admin/users/index.html"。
否则调用 c.HTML(200, "index.html", data) 会报错：template: "index.html" is undefined。
正确做法：
- 要么模板里写
{{define "admin/users/index.html"}} - 要么改用
r.LoadHTMLGlob("templates/*")并把所有模板扁平放在templates/下 - 或者在路由里明确传路径：
c.HTML(200, "admin/users/index.html", data)，同时模板define名称保持一致
模板里渲染切片看着简单，真正上线时踩坑最多的是字段未导出、空切片处理遗漏、以及多级目录下 define 名称和实际加载路径对不上——这三个点漏一个，页面就静默失败。
