在 Go template 中遍历 map 时，可通过声明布尔变量 $first 控制分隔符插入逻辑，仅在非首项前添加逗号，从而优雅避免末尾多余逗号。
在 go template 中遍历 map 时，可通过声明布尔变量 `$first` 控制分隔符插入逻辑，仅在非首项前添加逗号，从而优雅避免末尾多余逗号。
Go 的 text/template 包不支持直接获取 map 遍历索引（如数组的 .index），因此无法使用类似 {{if ne $i 0}},{{end}} 的方式处理分隔符。但自 Go 1.11 起，模板支持在 {{...}} 动作中对局部变量赋值（如 {{$first = false}}），这为条件化渲染提供了关键能力。
核心思路是：用一个布尔变量标记是否为首次迭代，首次不加逗号，后续每次输出前先输出 ,。该方案无需注册自定义函数、不依赖外部逻辑，完全在模板内完成。
以下是完整可运行示例：
package main
import (
"os"
"text/template"
)
func main() {
type Map map[string]string
m := Map{
"a": "b",
"c": "d",
"e": "f",
}
const temp = `{{$first := true}}{{range $key, $value := $}}{{if $first}}{{$first = false}}{{else}}, {{end}}key:{{$key}} value:{{$value}}{{end}}`
t := template.Must(template.New("example").Parse(temp))
t.Execute(os.Stdout, m)
}输出结果为：
key:a value:b, key:c value:d, key:e value:f
✅ 注意事项：
-
$first必须在{{range}}外声明（作用域覆盖整个模板），否则每次循环都会重新初始化； -
{{if $first}}{{$first = false}}{{else}}, {{end}}必须紧邻内容输出（如key:...），不可换行或加空格（除非你希望输出中包含这些空白）； - 若需更复杂格式（如换行、缩进），建议将逻辑封装为自定义 template 函数或改用
strings.Join在 Go 代码中预处理，而非在模板中过度耦合逻辑。
此方法简洁、标准、无副作用，是 Go template 官方推荐的“无索引集合分隔”实践方案。
