在 Go 模板中遍历 map 时，若需以逗号分隔输出（如 key:a value:b, key:c value:d），直接在循环内添加逗号会导致末尾多余逗号；本文介绍利用 Go 1.11+ 支持的模板变量赋值能力，通过 $first 标志位实现首项不加前缀、后续项前置逗号的简洁方案。
在 go 模板中遍历 map 时，若需以逗号分隔输出（如 `key:a value:b, key:c value:d`），直接在循环内添加逗号会导致末尾多余逗号；本文介绍利用 go 1.11+ 支持的模板变量赋值能力，通过 `$first` 标志位实现首项不加前缀、后续项前置逗号的简洁方案。
Go 模板原生不支持索引访问（尤其对 map），因此无法像切片那样用 $.index 或 len 判断是否为末项。但自 Go 1.11 起，text/template 支持在模板内对变量重新赋值（如 {{$first = false}}），这为我们提供了状态管理的能力——无需注册自定义函数，纯模板即可解决“去尾逗号”问题。
核心思路是：用布尔变量 $first 标记是否为首次迭代，首次输出内容不加前缀，后续每次输出前先渲染逗号。具体模板结构如下：
{{$first := true}}
{{range $key, $value := $}}
{{if $first}}
{{$first = false}}
{{else}}
,
{{end}}
key:{{$key}} value:{{$value}}
{{end}}该逻辑将逗号作为“连接符”置于每项之前（除首项外），天然规避了末尾逗号问题，且语义清晰、可读性强。
完整可运行示例：
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
⚠️ 注意事项：
- 此方案依赖 Go ≥ 1.11，低版本需升级或改用自定义模板函数；
-
$first必须在{{range}}外初始化，否则每次循环都会重置； - 若需更复杂分隔（如换行+缩进），可将
,替换为任意字符串（如\n）； - 对于空 map，该模板安全输出空字符串，无 panic 风险。
总结：相比预处理数据（如转为切片并手动拼接）或注册辅助函数，此方案完全在模板层解耦逻辑，符合“关注点分离”原则，是 Go 模板中处理动态分隔场景的推荐实践。
