
go 模板原生不支持直接使用 `arr[1]` 语法,但可通过内置函数 `index` 实现对数组、切片或 map 的索引访问,例如 `{{index .items 1}}` 即可获取第二个元素。
在 Go 的 text/template(或 html/template)中,模板语言设计强调安全性与简洁性,因此不提供类似 arr[1] 的中括号索引语法。若需访问函数返回的切片/数组中的特定元素(如第二项),必须借助预定义全局函数 index。
index 函数签名语义为:
index collection key1 [key2] [key3]...
它会依次对第一个参数(必须是 slice、array 或 map)执行索引操作。对于一维切片,只需传入单个整数索引即可,例如 {{index (service "mongodb") 1}} 即可获取 service "mongodb" 返回切片的第二个元素(索引从 0 开始)。
✅ 正确用法示例(适配你的原始模板):
test start
{{ index (service "mongodb") 1 }}
test end⚠️ 注意事项:
- index 要求第一个参数必须是可索引类型([]T、[N]T 或 map[K]V),否则运行时 panic;
- 索引越界(如 index arr 5 但 len(arr) == 3)将导致模板执行失败,建议确保数据结构稳定或在函数层做边界防护;
- 若 service 是自定义模板函数,需确保其返回值为 Go 切片(如 []*Service),而非字符串或其他不可索引类型;
- 多层嵌套可用 {{index (index .Data "services") 1}},等价于 .Data.services[1]。
? 小技巧:你也可以将常用索引逻辑封装为辅助函数(如 nth),但 index 已足够简洁通用,无需额外扩展。
综上,解决“模板中访问数组任意元素”的标准、安全、推荐方式就是使用 {{index ... N}} —— 它是 Go 模板原生支持的、类型安全的索引机制,也是官方文档明确推荐的实践方式。










