贝利信息

在 Go 模板中通过 index 函数安全访问数组或切片的任意索引元素

日期:2026-01-04 00:00 / 作者:花韻仙語

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

⚠️ 注意事项:

? 小技巧:你也可以将常用索引逻辑封装为辅助函数(如 nth),但 index 已足够简洁通用,无需额外扩展。

综上,解决“模板中访问数组任意元素”的标准、安全、推荐方式就是使用 {{index ... N}} —— 它是 Go 模板原生支持的、类型安全的索引机制,也是官方文档明确推荐的实践方式。