📐 控制 Go 模板中的空白字符:嵌套循环篇 🔗

控制 Go 模板中的空白字符:嵌套循环篇控制 Go 模板中的空白字符:嵌套循环篇

在使用 Go 语言的 text/template 包时,格式化嵌套数据结构往往会产生许多不希望出现的空行。由于 Go 模板会保留所有空白字符——包括用于排版模板代码本身的换行符——标准的循环写法很容易产生充斥着空行的臃肿输出。

下面介绍如何利用 Go 模板的空白裁剪标记(trim markers)来解决空白字符问题。

📑 目录

⚠️ 问题所在:被保留的换行符 🔗

假设我们想要格式化下面这个嵌套数据结构:

var data = map[string]map[string][]string{
	"1": {
		"1.1": {"1.1.1", "1.1.2", "1.1.3"},
	},
	"2": {
		"2.1": {"2.1.1", "2.1.2", "2.1.3"},
	},
}

编写模板时,一种很自然的写法是使用标准的 {{ range }} 块:

{{ range $name, $map := . }}
{{ $name }}:
  {{ range $name, $values := $map }}
  {{ $name }}:
    {{ range $value := $values }}
    {{ $value }}
    {{ end }}
  {{ end }}
{{ end }}

因为模板中的每一个换行符和缩进空格都会按原样输出,最终的打印结果会充斥着大量多余的空行:

1:
  
  1.1:
    
    1.1.1
    
    1.1.2
    
    1.1.3
    
  

2:
...

✂️ 解决方案:空白裁剪标记(-) 🔗

我们可以在模板动作标签内部添加减号(-),指示 Go 模板引擎吞掉相邻的空白字符:

为了修复我们的嵌套循环,我们可以有策略地放置 - 标记,吞掉用于模板排版的换行符,同时保留我们想要的缩进空格:

{{- range $name, $map := . -}}
{{ $name }}:
  {{- range $name, $values := $map }}
  {{ $name }}:
    {{- range $value := $values }}
    {{ $value }}
    {{- end }}
  {{- end }}
{{ end -}}

通过剔除紧跟在 range 声明和 end 块前后的换行符,我们就能得到干净、紧凑的输出结果:

1:
  1.1:
    1.1.1
    1.1.2
    1.1.3
2:
  2.1:
    2.1.1
    2.1.2
    2.1.3

💻 完整可运行示例 🔗

你可以复制并运行以下代码,直接测试其实际效果。

package main

import (
	"fmt"
	"os"
	"text/template"
)

var data = map[string]map[string][]string{
	"1": {
		"1.1": {"1.1.1", "1.1.2", "1.1.3"},
	},
	"2": {
		"2.1": {"2.1.1", "2.1.2", "2.1.3"},
	},
}

func main() {
	const tpl = `
{{- range $name, $map := . -}}
{{ $name }}:
  {{- range $name, $values := $map }}
  {{ $name }}:
    {{- range $value := $values }}
    {{ $value }}
    {{- end }}
  {{- end }}
{{ end -}}
`
	fmt.Println("Output:")
	fmt.Println("'''")
	
	t := template.Must(template.New("nested").Parse(tpl))
	t.Execute(os.Stdout, data)
	
	fmt.Println("'''")
}


💬 评论与讨论 🔗

有任何问题、见解或建议吗?欢迎在下方分享您的想法。评论功能由 GitHub Discussions 驱动(无广告、无垃圾信息)——点击下方的使用 GitHub 登录即可发表评论或互动(注册免费 GitHub 账号不到一分钟即可完成)。



最后更新于 2026年10月11日.

免责声明:本站所有内容仅供信息参考与教育用途,不构成任何医疗、心理、财务、投资、税务或法律建议。此处呈现的观点、整理与见解仅代表我个人,不代表我雇主的立场。书籍、演讲及文章摘要均为独立的教育性评论,其知识产权归原作者所有。本站可能使用 AI 工具辅助编辑、排版与归纳;尽管我们竭力确保准确无误,但仍可能存在疏漏。隐私政策:本站不使用任何追踪 Cookie;浏览器本地存储仅用于记住可选的语言与播放速度偏好,Google Cloud 托管日志会处理访客 IP 地址、浏览器元数据、所请求的资源、页面互动及流量来源以用于汇总访问统计。用于可选邮件通讯订阅(Mailchimp)、评论(giscus / GitHub Discussions)及媒体下载或播放(GitHub)的第三方服务可能会依据各自的隐私政策处理访客的 IP 地址和 Cookie。