Go模板中range循环获取索引需用$index, $value := .Slice语法,索引为int类型且从0开始;对map则取key;string和channel不支持双变量,否则报错。

Go template 里 range 循环怎么拿到索引
直接用 $index, $value := range 语法,但必须注意:只有当 range 的目标是 slice、array 或 map 时,双变量形式才有效;对 string 或 channel 不适用。Gin 自身不改 template 行为,它只是把数据传给 Go 原生 html/template。
常见错误是写成 {{range .Items}}{{.Index}}{{end}} —— .Index 根本不存在,模板会静默失败或报错 can't evaluate field Index。
- 对 slice/array:用
{{range $i, $v := .Items}},其中$i是 int 类型索引 - 对 map:同样用
{{$k, $v := range .Map}},$k是 key(不是数字索引) - 如果只要索引不要值,可以写
{{range $i, $_ := .Items}},$_是惯用的丢弃变量名
Gin 传入 slice 后在模板中正确使用双变量 range
后端代码要确保传的是可索引结构,比如 []string、[]struct{} 等:
c.HTML(200, "list.html", gin.H{
"Items": []string{"a", "b", "c"},
})
模板里这么写才能拿到索引:
{{range $i, $item := .Items}}
<div>序号: {{$i}}, 值: {{$item}}</div>
{{end}}
注意:$i 从 0 开始,且类型是 int,不能直接和字符串拼接(如 "第{{$i}}条" 会报错),得用 printf:"第{{printf "%d" $i}}条"。
想在嵌套循环里访问外层索引怎么办
Go template 没有作用域链自动提升,外层变量不会自动透入内层。必须显式传入或重命名:
- 错误写法:
{{range $i, $x := .List}}{{range .Children}}{{print $i}}{{end}}{{end}}—— 内层$i不可见 - 正确写法:在外层用
{{$outerI := $i}}绑定,再进内层:{{range $i, $x := .List}}{{$outerI := $i}}{{range $x.Children}}{{$outerI}}{{end}}{{end}} - 更清晰的做法是统一用有意义的名字,比如
{{$rowIndex, $row := range .Rows}},再在子循环里用{{$rowIndex}}
为什么 range 有时只接受一个变量,有时报错说 “too many args”
根本原因是 range 目标类型的“可 range 性”不同:
- slice/array → 支持双变量(索引+值)和单变量(仅值)
- map → 支持双变量(key+value)和单变量(仅 value)
- string → 只支持单变量(每个 rune),双变量会报
too many arguments to range - channel → 同样只支持单变量(接收值)
如果你传了 string 却写了 {{$i, $r := range .Str}},就会触发这个错误。排查时先 printf "%T" .Str 看实际类型,别假设它是 slice。
真正容易被忽略的是:哪怕你传的是 []interface{},只要里面塞了 string,range 行为仍由底层类型决定——模板引擎不关心 interface{} 里装什么,只看运行时真实类型。


















