如何在Revel模板中正确传递嵌套结构体切片数据

先来说一个开发者经常遇到的典型问题：在使用 Revel（以及所有基于 Go text/template 或 html/template 的框架）时，模板无法访问结构体中小写字母开头的字段。这并非 Revel 有意设置障碍，而是 Go 语言自身的反射机制所决定的——只有导出的字段（即首字母大写的字段）才能在包外部被访问。如果你试图将小写字段传递给模板，程序会立即报错，提示“unexported field”。

解决办法其实非常直接：将你希望在模板中使用的字段名改为大写开头，同时确保这些字段所属的类型本身也是导出的。

这里通过一个具体示例来说明。假设你定义了两个结构体：

type company struct {
    tradetotals float64
    totals      float64
    costCount   string
    traderCount string
}
type AllData struct {
    company []company // 小写，非导出
}

在这种定义方式下，模板无论如何都无法获取 company 切片中的数据。正确的做法是将结构体本身及其所有字段都改为导出形式：

type Company struct {
    Tradetotals float64
    Totals      float64
    CostCount   string
    TraderCount string
}
type AllData struct {
    Company []Company // 大写，导出，模板可访问
}

有一个容易被忽视的细节：结构体名称 company（小写）本身也是非导出的。即使你将字段名改成了 Company，但结构体类型仍然是私有的，在特定场景下依然可能引发问题。因此，最佳实践是将结构体也命名为 Company（导出类型），这样处理最为干净利落。

控制器与模板配合示例

在控制器中按以下方式传递数据：

func (c App) Index() revel.Result {
    data := AllData{
        Company: []Company{
            {Tradetotals: 123.45, Totals: 678.9, CostCount: "5", TraderCount: "3"},
            {Tradetotals: 200.0, Totals: 800.0, CostCount: "12", TraderCount: "7"},
        },
    }
    return c.Render(data)
}

对应的模板中可以通过如下方式进行遍历：

{{range $index, $comp := .Company}}
    

        
            

            Demo Danger 
Button
        
        
            
            US: {{$comp.Tradetotals}}

            {{$comp.Totals}}

            {{$comp.Totals}} {{$comp.CostCount}}
        
    
{{end}}

补充说明与最佳实践

• 命名规范值得留意：Go 社区约定，导出类型和字段应使用大驼峰命名（PascalCase），例如 Company、Tradetotals。保持这种一致性可以减少许多困惑。
• 空值处理需谨慎：在模板中遍历切片之前，建议添加条件判断，比如 {{if .Company}}...{{end}}。如果传入的数据中该切片为 nil，直接循环会触发 panic。
• 调试小技巧：当你怀疑模板接收到的数据有误时，可以在模板中临时加入 {{printf "%#v" .}}，它会输出实际传入的数据结构，帮助你快速定位问题。
• 多层嵌套同样适用：只要每一层的字段都是导出的，无论嵌套多深（例如 .User.Profile.Company.Name），都能正常访问。

这一导出规则并非 Revel 独有，而是整个 Go 模板系统底层的基本约定——text/template 和 html/template 都遵循这一设计。理解并遵守这一规则，数据就能安全、顺畅地渲染到前端，再也不会因为“unexported field”这类错误而受阻。