
Go 的 text/template 模板中,条件语句(如 {{if}})前后默认会保留原始换行符,导致输出中出现意外空行;可通过 {{-(左去空白)和 -}}(右去空白)语法精准控制空白字符,实现紧凑、无冗余换行的渲染效果。
go 的 text/template 模板中,条件语句(如 `{{if}}`)前后默认会保留原始换行符,导致输出中出现意外空行;可通过 `{{-`(左去空白)和 `-}}`(右去空白)语法精准控制空白字符,实现紧凑、无冗余换行的渲染效果。
在 Go 模板中,所有模板动作(action)前后的空白符(包括换行符、制表符和空格)都会原样输出——这是初学者常忽略的关键细节。例如以下模板:
Let's say:
{{ if eq .Foo "foo" }}
Hello, StackOverflow!
{{ else if eq .Foo "bar" }}
Hello, World!
{{ end }}
当 .Foo == "foo" 时,实际输出为:
Let's say: Hello, StackOverflow!
原因在于:
-
"Let's say:"后有一个换行(\n); -
{{ if ... }}占据独立一行,其前的换行被保留; - 条件体
"Hello, StackOverflow!"前又有一个换行;
→ 最终产生两个连续换行,形成空行。
✅ 解决方案:使用空白修剪语法 {{- 和 -}}
Go 1.6 起支持在动作起始或结束处添加 -(连字符),指示删除紧邻的动作左侧或右侧的所有空白字符(含换行):
-
{{- action }}:删除action左侧直到上一个非空白字符之间的所有空白(含换行); -
{{ action -}}:删除action右侧直到下一个非空白字符之间的所有空白(含换行); -
{{- action -}}:左右空白同时删除。
? 推荐实践示例:
Let's say:
{{- if eq .Foo "foo" }}
Hello, StackOverflow!
{{- else if eq .Foo "bar" }}
Hello, World!
{{- end }}
✅ 输出(.Foo == "foo"):
Let's say: Hello, StackOverflow!
→ 仅保留 : 后的换行,消除了条件块引入的额外空行。
若需更紧凑(如拼接为同一行),可进一步使用 -}}:
Let's say:
{{- if eq .Foo "foo" -}}
Hello, StackOverflow!
{{- else if eq .Foo "bar" -}}
Hello, World!
{{- end -}}
✅ 输出:
Let's say:Hello, StackOverflow!
⚠️ 注意事项:
-
-必须紧贴{或},中间不可有空格(如{{ - if ... }}是非法语法,会报illegal number syntax: "-"); - 修剪只作用于紧邻的空白序列,不影响模板中其他位置的格式;
- 多重嵌套时,建议逐层测试,可借助 Go Playground 快速验证;
- 对可读性要求高的模板,可在逻辑清晰的前提下适度保留换行,避免过度压缩导致维护困难。
掌握 {{- 和 -}} 是编写健壮、整洁 Go 模板的基础技能——它让模板输出完全可控,不再受源码缩进“绑架”。










