
在Go模板中,不能使用类似.a[2]的方括号语法访问数组或切片元素,而必须通过内置函数index实现安全、合法的索引访问。
在go模板中,不能使用类似`.a[2]`的方括号语法访问数组或切片元素,而必须通过内置函数`index`实现安全、合法的索引访问。
Go模板语法严格遵循Go语言的模板规范,不支持直接的中括号索引表达式(如 .a[2]),因此当你写 {{ .a[2] }} 时,模板解析器会将 [ 视为非法字符(报错 bad character U+005B '['),导致编译失败。
✅ 正确做法是使用内置模板函数 index:
{{ index .a 2 }}该函数接受一个序列(数组、切片、map 或字符串)和一个或多个索引参数,返回对应位置的值。对于一维数组/切片,只需传入单个整数索引:
{{ index .users 0 }} <!-- 获取第一个用户 -->
{{ index .scores 3 }} <!-- 获取第四个成绩(索引为3) -->⚠️ 注意事项:
- index 是安全的:若索引越界(如 index .a 10 而 .a 长度为5),Go模板默认静默返回零值(如 0、""、nil),不会panic;但建议在数据层确保索引有效性,或结合 if 判断:
{{ if ge (len .a) 3 }} {{ index .a 2 }} {{ else }} <span class="empty">N/A</span> {{ end }} - 支持嵌套访问:{{ index (index .matrix 1) 2 }} 等价于二维切片 matrix[1][2];
- 对 map 使用时:{{ index .config "timeout" }} 相当于 config["timeout"];
- 索引必须为整数(或可转为整数的变量),不支持负数索引(如 -1 表示末尾)。
? 小结:Go模板的设计哲学强调显式性与安全性——所有动态访问都需通过函数完成。牢记 index 是访问有序集合元素的唯一标准方式,既规避语法错误,也便于模板静态分析与维护。










