如何在 Go text/template 中消除条件语句引入的多余换行

在 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 模板的基础技能——它让模板输出完全可控，不再受源码缩进“绑架”。