本文详解如何使用 consul-template 的 go 模板语法，将多个 consul 注册服务的 address 和 port 安全拼接为逗号分隔的字符串，避免尾部多余逗号，并提供可复用的模板模式。
本文详解如何使用 consul-template 的 go 模板语法，将多个 consul 注册服务的 address 和 port 安全拼接为逗号分隔的字符串，避免尾部多余逗号，并提供可复用的模板模式。
在 Consul-Template 中动态生成配置时，常需将一组服务实例（如 service "foo"）的网络信息（Address:Port）拼接成单行字符串，例如：
servers=192.168.0.1:3333,192.168.0.2:4444/bogus
但直接使用 {{range}}...{{end}} 会导致末尾多出一个逗号（如 ...,/bogus），破坏格式合法性。Go 模板原生不支持“join with separator”对复合字段（.Address + .Port）的操作，因此需借助索引控制与条件判断实现精准拼接。
✅ 推荐方案：索引遍历 + 末项单独处理
以下模板安全、清晰且兼容任意数量的服务实例（包括零个或一个）：
{{$foo_srv := service "foo"}}
{{if $foo_srv}}
{{$len := len $foo_srv}}
{{$last := sub $len 1}}
servers=
{{- range $i, $svc := $foo_srv}}
{{- if lt $i $last}}{{$svc.Address}}{{$svc.Port}},{{end}}
{{- end}}
{{- if $foo_srv}}{{index $foo_srv $last | printf "%s%d" .Address .Port}}{{end}}/bogus
{{else}}
servers=/bogus
{{end}}
说明：
- {{$foo_srv := service "foo"}} 缓存服务列表，避免重复查询；
- {{if $foo_srv}} 防止空列表导致渲染错误；
- {{$last := sub $len 1}} 计算最后一个元素索引（Go 模板中 sub 是内置函数）；
- {{if lt $i $last}} 在非末项时输出 Address:Port,；
- {{index $foo_srv $last | printf "%s%d" .Address .Port}} 对末项单独格式化，不加逗号；
- 使用 {{- ... }} 自动裁剪空白符，确保输出紧凑无换行/空格干扰。
⚠️ 注意事项：
- Consul-Template v0.25+ 内置 sub 函数（无需自定义函数）；旧版本可改用 add $len -1；
- printf "%s%d" 确保 .Port（整数）正确转为字符串，避免类型错误；
- 若需添加协议前缀（如 http://）或路径，可在 {{.Address}} 前统一插入，保持逻辑一致；
- 生产环境建议配合 consul-template -dry 验证模板输出，再部署到真实配置文件。
该模式可轻松扩展至其他组合字段（如 {{.Node}}:{{.Address}}:{{.Port}}），是 Consul-Template 动态配置生成的稳健实践。
