
在 Go 的 text/template 中对切片循环时,若想同时获取索引和元素值,需直接对切片本身调用 range,而非访问不存在的字段(如 .rec);否则会因字段未定义而 panic。
在 go 的 text/template 中对切片循环时,若想同时获取索引和元素值,需直接对切片本身调用 range,而非访问不存在的字段(如 .rec);否则会因字段未定义而 panic。
Go 模板中的 range 动作支持两种常用形式:
- 对映射(map):
{{ range $k, $v := .Map }}→$k为键,$v为值; - 对切片或数组:
{{ range $i, $v := .Slice }}→$i为整数索引(从 0 开始),$v为对应元素。
关键点在于:切片本身是数据源,无需通过字段名间接访问。若模板数据是一个字符串切片(例如 []string{"a", "b", "c"}),且直接传入模板执行,则应使用 . 代表该切片:
// Go 代码示例
data := []string{"apple", "banana", "cherry"}
tmpl := template.Must(template.New("test").Parse(`{{ range $k, $v := . }}
Index: {{ $k }}, Value: "{{ $v }}"
{{ end }}`))
tmpl.Execute(os.Stdout, data)输出为:
Index: 0, Value: "apple" Index: 1, Value: "banana" Index: 2, Value: "cherry"
⚠️ 常见错误:误将切片包装在结构体中但未按结构体字段访问,或错误假设切片总在 .rec 字段下。例如,若实际数据是 struct{ Rec []string }{Rec: data},则应写 {{ range $k, $v := .Rec }};而原错误 {{ range $k, $v := .rec }} 同时存在字段名大小写错误(Go 结构体字段需导出,即首字母大写 Rec)和字段不存在问题。
✅ 正确做法:明确数据结构,匹配传入模板的实际类型。若传入的是裸切片,就用 .;若传入的是结构体,则用对应导出字段名(如 .Rec),并确保字段名拼写与大小写完全一致。
总结:range 的 key 在切片上下文中是索引(int),在 map 中是键(key type);始终以数据实际类型和结构为准,避免硬编码不存在的字段路径。

















