本文详解如何将 mysql 查询得到的结构体指针切片（如 []*tasks）安全、清晰地传递并渲染到 go html 模板中，避免因字段未导出或误用嵌套 range 导致模板渲染失败。
本文详解如何将 mysql 查询得到的结构体指针切片（如 []*tasks）安全、清晰地传递并渲染到 go html 模板中，避免因字段未导出或误用嵌套 range 导致模板渲染失败。
你在 Go 中从 MySQL 查询多行数据并传入模板时，遇到“所有值合并为一个字符串”“内层 range 失效”的问题，根本原因在于：*Go 模板中的 range 仅支持对 slice、array、map 或 channel 进行迭代；而 `Tasks是单个结构体指针，不是可遍历类型——因此{{range $values}}` 会静默失败（Go 模板不报错但不执行），且若结构体字段未导出（首字母小写），模板也无法访问其值。**
✅ 正确做法：修正结构体字段导出 + 模板显式取值
首先，必须将 Tasks 结构体字段改为导出（首字母大写），否则模板完全无法访问任何字段：
type Tasks struct {
Tid int `json:"tid"`
Pid int `json:"pid"`
Uid int `json:"uid"`
Del int `json:"del"`
Finisch int `json:"finisch"`
Open int `json:"open"`
Inprocess int `json:"inprocess"`
Abnahme int `json:"abnahme"`
Fertig int `json:"fertig"`
Finischdatum string `json:"finischdatum"`
Erstellt string `json:"erstellt"`
Start string `json:"start"`
Ende string `json:"ende"`
Name string `json:"name"`
Beschreibung string `json:"beschreibung"`
}⚠️ 注意：Go 中只有首字母大写的字段才是导出字段（exported），才能被模板、JSON 编码等外部包访问。小写字段（如 tid, name）在模板中视为不可见。
其次，*模板中禁止对 `Tasks使用range**，应直接通过点号（.`）访问其字段：
{{ range $index, $task := .Tabledata }}
<li>
<strong>第 {{ add $index 1 }} 项</strong><br>
ID: {{ $task.Tid }}<br>
名称: {{ $task.Name }}<br>
状态: {{ if eq $task.Open 1 }}进行中{{ else }}已关闭{{ end }}<br>
创建时间: {{ $task.Erstellt }}<br>
</li>
{{ end }}✅ 完整可运行示例（关键片段）
// 数据库查询与结构体填充（注意 Scan 字段顺序与结构体导出字段严格一致）
rows, err := db.Query("SELECT tid,pid,uid,del,finisch,open,inprocess,abnahme,fertig,finischdatum,erstellt,start,ende,name,beschreibung FROM tasks WHERE pid=? AND del=0", pid)
if err != nil {
log.Fatal(err)
}
defer rows.Close()
var tasks []*Tasks
for rows.Next() {
t := new(Tasks)
// 注意：Scan 参数顺序必须与 SELECT 字段顺序、结构体字段声明顺序完全一致
err := rows.Scan(
&t.Tid, &t.Pid, &t.Uid, &t.Del, &t.Finisch,
&t.Open, &t.Inprocess, &t.Abnahme, &t.Fertig,
&t.Finischdatum, &t.Erstellt, &t.Start, &t.Ende,
&t.Name, &t.Beschreibung,
)
if err != nil {
log.Printf("scan error: %v", err)
continue
}
tasks = append(tasks, t)
}
// 渲染模板
data := Daten{Tabledata: tasks}
err = tmpl.Execute(w, data) // 假设 tmpl 已解析，w 是 http.ResponseWriter
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
}? 常见错误排查清单
- ❌ 错误：模板中 {{range $values}} → $values 是 *Tasks，非 slice → 删除该嵌套 range
- ❌ 错误：结构体字段小写（如 tid, name）→ 模板中 {{.Tid}} 返回空 → 全部改为大写首字母
- ❌ 错误：Scan 字段数量/顺序与 SQL SELECT 不匹配 → 可能 panic 或字段错位 → 显式列出 SELECT 字段，与结构体字段一一对应
- ✅ 推荐：为结构体添加 json tag，便于调试（fmt.Printf("%+v", tasks) 查看实际值）
? 总结
Go 模板不是“自动反射遍历对象”，它依赖严格的类型规则：
✅ 用 range 遍历 slice（如 []*Tasks）→ 得到索引和 *Tasks 实例；
✅ 用 . 访问导出结构体字段（如 {{.Name}}）；
❌ 不可用 range 遍历单个结构体或指针；
❌ 小写字段在模板中不可见，也无任何提示——这是最隐蔽的坑。
修正字段导出 + 显式模板取值，即可稳定渲染 MySQL 多行数据。
