Go 模板中 {{range}} 语句默认会保留前后空白符，导致生成代码缩进错乱或空行冗余；通过合理使用 -（减号）修饰符可精确剥离模板中不必要的空白、换行和缩进，实现结构清晰、格式规范的输出。
go 模板中 `{{range}}` 语句默认会保留前后空白符，导致生成代码缩进错乱或空行冗余；通过合理使用 `-`（减号）修饰符可精确剥离模板中不必要的空白、换行和缩进，实现结构清晰、格式规范的输出。
在 Go 模板（text/template 或 html/template）中，{{range}} 结构天然会将模板中的换行符和空白作为字面量内容输出——这在 HTML 渲染中常可接受，但在生成 Go 源码、JSON、YAML 等对格式敏感的文本时，极易引发缩进错位、空行污染甚至语法错误。
核心原理在于：Go 模板的 - 修饰符用于裁剪紧邻的操作符前后的空白字符（包括空格、制表符、换行符）。它不作用于模板逻辑本身，而仅影响模板解析后渲染阶段的空白处理。
✅ 正确用法是「双向修剪」：
- {{- range ...}}：去除 {{- 左侧所有连续空白（含换行），直到上一行非空白内容末尾；
- {{end -}}：去除 end -}} 右侧所有连续空白（含换行），直到下一行非空白内容开头。
但需注意：- 仅裁剪紧邻的空白，不会自动对齐缩进层级。因此，要兼顾可读性与输出整洁，推荐采用「左对齐 + 内容缩进 + 双向裁剪」模式：
type {{makeGoTableName .TableName}} struct {
{{- range $key, $value := .TableData}}
{{makeGoColName $value.ColName}} {{$value.ColType}} `db:"{{makeDBColName $value.ColName}}",json:"{{$value.ColName}}"`
{{- end}}
}
? 关键细节解析：
- 第一行 { 后换行 + 缩进 4 个空格，被 {{- range 吞掉（因 - 向左裁剪至 {）；
- 每个字段行以 ` ` 开头（手动缩进），无前置/后置多余换行；
- {{- end}} 向右裁剪，确保 } 紧接上一行末尾，避免空行和错位；
- 最终输出严格保持结构紧凑且缩进统一：
type Dogs struct {
ID int64 `db:"id",json:"id"`
DogNumber int64 `db:"dog_number",json:"dog_number"`
}
⚠️ 注意事项：
- 不要滥用 - 在中间变量插值处（如 {{$value.ColType -}}），除非你明确需要抹去其右侧空格（可能破坏字段间间距）；
- 模板内缩进应使用空格而非混合 Tab，避免不同编辑器渲染差异；
- 若需生成多级嵌套结构（如嵌套 struct），建议将子模板提取为 define，再配合 template 调用，提升可维护性；
- 测试时务必用 strings.TrimSpace() 对比期望输出，因为首尾换行易被忽略。
总结：Go 模板的空白控制不是“删除换行”，而是“智能裁剪边界空白”。掌握 {{- ...}} 和 {{... -}} 的组合逻辑，就能在模板可读性与输出严谨性之间取得最佳平衡——尤其适用于代码生成类场景，让自动化产出真正具备生产就绪质量。
