
在 go 的 text/template 中对切片循环时,若想同时获取索引(key)和元素值(value),需直接对切片本身调用 range,而非访问不存在的字段(如 .rec);否则会因字段未定义而 panic。
在 go 的 text/template 中对切片循环时,若想同时获取索引(key)和元素值(value),需直接对切片本身调用 range,而非访问不存在的字段(如 .rec);否则会因字段未定义而 panic。
Go 模板的 range 动作支持两种常用形式:
- 对映射(map):
range $k, $v := .Map→$k为键,$v为值; - 对切片或数组:
range $i, $v := .Slice→$i为从 0 开始的整数索引(即“key”),$v为对应元素。
关键在于:切片本身就是一个可遍历值,无需通过点号访问子字段。你遇到的错误:
panic: template: let:2:19: executing "let" at <.rec>: can't evaluate field rec in type []string</.rec>
说明模板上下文(.)是一个 []string 类型,但你却试图访问其不存在的字段 .rec —— 这属于类型不匹配导致的运行时 panic。
✅ 正确写法(假设传入的是 []string{"a", "b", "c"}):
{{ range $i, $v := . }}
{{ $i }} :: {{ $v }}
{{ end }}
输出为:
0 :: a 1 :: b 2 :: c
⚠️ 注意事项:
- 若模板数据是结构体指针(如
struct{ Rec []string }),且你想遍历Rec字段,则应确保结构体字段导出(首字母大写),并在模板中写{{ range $i, $v := .Rec }}; - 切片索引
$i始终为int类型,不可用于 map 查找(除非显式转换,但模板中不支持类型转换); - 若只需值而不要索引,可省略
$i:{{ range $v := . }}{{ $v }}{{ end }}。
总结:range 的行为由被遍历值的底层类型决定。对切片用 range $index, $value := . 即可安全获取索引与元素,避免无谓的字段访问,这是编写健壮 Go 模板的基础实践。










