go的text/template和html/template通过fmt包（如fmt.sprint或fmt.fprint）生成值的默认文本表示，对实现了fmt.stringer或error接口的类型会优先调用其string()或error()方法，从而支持开发者定制输出格式。
go的text/template和html/template通过fmt包（如fmt.sprint或fmt.fprint）生成值的默认文本表示，对实现了fmt.stringer或error接口的类型会优先调用其string()或error()方法，从而支持开发者定制输出格式。
在 Go 模板中，{{.}} 或 {{pipeline}} 这类无函数调用的管道表达式，其输出并非由模板引擎自行序列化，而是委托给标准库的 fmt 包完成。具体而言：
- text/template 在内部调用 fmt.Fprint(s.wr, value)（见 exec.go#L848 的 state.PrintValue 函数）；
- html/template 则调用 fmt.Sprint(value)（见 content.go#L135 的 stringify 函数），再根据上下文进行 HTML 转义。
这意味着：任何符合 fmt 打印逻辑的 Go 类型，其模板输出行为都与 fmt.Println(value) 完全一致——包括原生类型（如 map[string]int 输出为 map[a:1 b:2]）、结构体、切片等。
✅ 自定义默认输出：实现 fmt.Stringer
你可以通过为自定义类型实现 fmt.Stringer 接口来接管模板中的默认渲染：
type ConfigMap map[string]interface{}
func (c ConfigMap) String() string {
return fmt.Sprintf(`{env: "%s", timeout: %d}`,
c["env"], c["timeout"])
}
// 使用示例
t := template.Must(template.New("").Parse("{{.}}"))
cfg := ConfigMap{"env": "prod", "timeout": 30}
t.Execute(os.Stdout, cfg) // 输出：{env: "prod", timeout: 30}⚠️ 关键注意事项：
- 接收器类型必须匹配传入值的类型：若使用值接收器（如 func (c ConfigMap) String()），则需传入 ConfigMap 值；若使用指针接收器（func (c *ConfigMap) String()），则必须传入 &cfg，否则 String() 方法不可见。
- 若类型同时实现了 error 接口，Error() 方法优先级高于 String() —— 模板会直接使用错误消息，忽略 String()。
? html/template 中的安全约束
html/template 在 fmt.Sprint 结果基础上还会执行上下文感知的自动转义：
func (m MyMap) String() string { return `<script>alert(1)</script>` }在 html/template 中直接 {{.}} 渲染将输出被转义的 <script>alert(1)</script>，而非可执行脚本。如需原始 HTML，应显式使用 template.HTML 类型或 safeHTML 等安全函数，切勿绕过转义机制直接注入未验证内容。
? 总结：控制默认表示的优先级链
模板对任意值 v 的默认文本表示遵循以下明确优先级（从高到低）：
- 若 v 实现 error 接口 → 调用 v.Error()
- 否则，若 v 实现 fmt.Stringer 接口 → 调用 v.String()
- 否则，交由 fmt.Sprint(v) 生成（即 Go 默认格式，如 map[k:v]、[{…}] 等）
因此，无需修改模板源码或反射黑魔法——只需合理设计类型接口，即可优雅、安全、可维护地定制模板输出行为。
