如何在 Go 中将多个数据结构合并传递给 HTML 模板进行渲染-Golang-PHP中文网

本文介绍在 Go 的 html/template 中，如何将多个不相关的数据（如切片、结构体等）安全、清晰地组合并传递给模板，避免使用 map[string]interface{} 带来的类型不安全和可维护性问题。

本文介绍在 go 的 `html/template` 中，如何将多个不相关的数据（如切片、结构体等）安全、清晰地组合并传递给模板，避免使用 `map[string]interface{}` 带来的类型不安全和可维护性问题。

在 Go Web 开发中，常需将多个独立的数据源（例如初创公司列表和活动列表）同时渲染到同一 HTML 页面。html/template.Execute 方法仅接受单个数据参数，因此必须将多组数据封装为一个统一的值。最佳实践是定义具名匿名结构体或预声明结构体——它兼具类型安全、语义清晰与 IDE 友好性。

以下是一个完整示例：

// 定义结构体承载多组数据（推荐：具名结构体更易复用）
type PageData struct {
    StartupData []model.StartupModel
    EventData   []model.EventModel
}

// 查询数据
var startupData []model.StartupModel
err := startupCollection.Find(nil).Sort("-timestamp").All(&startupData)
if err != nil {
    http.Error(w, "Failed to load startups", http.StatusInternalServerError)
    return
}

var eventData []model.EventModel
err = eventCollection.Find(nil).Sort("-timestamp").All(&eventData)
if err != nil {
    http.Error(w, "Failed to load events", http.StatusInternalServerError)
    return
}

// 封装为单一数据对象
data := PageData{
    StartupData: startupData,
    EventData:   eventData,
}

// 渲染模板
if err := t.Execute(w, data); err != nil {
    http.Error(w, "Template execution failed", http.StatusInternalServerError)
}

在模板中，可直接通过字段名访问：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

<!-- templates/index.html -->
<h2>Upcoming Events</h2>
{{range .EventData}}
  <div>{{.Title}} ({{.Date}})</div>
{{end}}

<h2>Featured Startups</h2>
{{range .StartupData}}
  <div>{{.Name}} — {{.Description}}</div>
{{end}}

⚠️ 注意事项：