Go text/template 怎样用 break 提前结束 range 遍历

如果模板只需要输出列表中的前几项，或者命中某个目标后就不再继续渲染，可以在 range 内使用 {{break}}。它结束的是当前最内层的 range，不会退出整个模板，也不会跳出外层循环。实际写法是把判断放在循环体中，命中条件后紧跟 break。

记住三个边界：break 结束整个最内层遍历，continue 只跳过当前元素，else 只在 range 输入为空时执行。

break 解决的是模板遍历的提前停止

text/template 的 range 可以遍历切片、数组、映射、整数、通道以及迭代序列。break 不改变输入数据，也不产生返回值；它只告诉模板执行器停止当前最内层循环，后面的元素不再输出，循环之后的模板内容仍会继续执行。

最小写法：命中条件后停止输出

下面的示例把模板和数据放在一个 Go 程序中。注释说明了控制边界；解析失败和执行失败都直接返回，便于把模板错误留在调用方处理。

package main

import (
	"os"
	"text/template"
)

type Item struct {
	Name string
	Stop bool
}

func main() {
	const source = `{{range .}}{{.Name}}{{if .Stop}}{{break}}{{end}} {{end}}之后的模板内容`

	// 先解析模板，语法错误不应被忽略。
	tmpl, err := template.New("items").Parse(source)
	if err != nil {
		panic(err)
	}

	items := []Item{
		{Name: "首项"},
		{Name: "目标项", Stop: true},
		{Name: "不会再输出"},
	}

	// 命中 Stop 后只结束最内层 range，循环后的文字仍会执行。
	if err := tmpl.Execute(os.Stdout, items); err != nil {
		panic(err)
	}
}

这里的关键不是把 break 当作 Go 语句，而是把它放进模板动作中。目标项输出后，第三个元素被跳过，随后仍会看到循环外的“之后的模板内容”。若需要限制输出数量，也可以在模板数据中预先计算边界；模板里的 break 更适合表达一个清晰的停止条件。

break、continue 和 else 不要混用

continue 只停止当前迭代，然后进入下一项。例如需要跳过标记为隐藏的项时，应使用 {{continue}}；如果使用 {{break}}，整个列表会在第一个隐藏项处停止。

const source = `{{range .}}{{if .Hidden}}{{continue}}{{end}}{{.Name}} {{end}}`

// Hidden 只跳过当前元素，后续元素仍有机会输出。
tmpl, err := template.New("visible-items").Parse(source)
if err != nil {
	panic(err)
}

else 的语义又不同：{{range .}}...{{else}}没有数据{{end}} 只在输入为空时输出备用文本。它不会在某个元素不满足条件时触发，也不会因为 break 而触发。要表达“找到目标后显示结果”，应在循环中设置数据字段或使用模板变量，而不是把 else 当成 break 的收尾分支。

嵌套 range 只结束最内层循环

当模板里出现内外两层 range 时，内层的 break 只结束内层。外层仍会继续处理下一个元素。如果业务语义是“全局找到后立即停止”，不要依赖模板动作跨层跳出，应该在进入模板前筛选数据，或把结果和停止条件整理成更简单的数据结构。

最后可以按这张速查表选择动作：

常见问题

break 能退出整个模板吗？

不能。它只结束最内层 range，模板后续内容仍会继续执行。

range 没有元素时会执行 break 吗？

不会进入循环体；需要空输入提示时，应使用 range 的 else 分支。