Go 的 text/template 和 html/template 通过 fmt 包（如 fmt.Sprint/fmt.Fprint）生成值的默认字符串表示；对 map 类型，其输出形如 map[key:value key:value]，且可通过实现 String() 或 Error() 方法自定义该行为。
go 的 `text/template` 和 `html/template` 通过 `fmt` 包（如 `fmt.sprint`/`fmt.fprint`）生成值的默认字符串表示；对 map 类型，其输出形如 `map[key:value key:value]`，且可通过实现 `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.Sprint 对该值的输出结果。对于原生 map[string]interface{}，fmt 会按 map[key:value key:value] 格式打印（键按哈希顺序，非插入顺序），该格式恰好是合法的 Go 语法，也常被用作轻量级 JS 对象字面量（需注意：JS 不支持 map[k:v] 语法，但结构可类比，实际应配合 json.Marshal 更稳妥）。
自定义表示：实现 String() 方法
你可以通过为自定义类型实现 fmt.Stringer 接口来接管渲染逻辑：
type ConfigMap map[string]string
func (c ConfigMap) String() string {
return fmt.Sprintf("Config{%v}", map[string]string(c))
}
// 使用示例
t := template.Must(template.New("").Parse("{{.}}"))
data := ConfigMap{"host": "localhost", "port": "8080"}
t.Execute(os.Stdout, data) // 输出：Config{map[host:localhost port:8080]}
⚠️ 关键注意事项：
- String() 方法必须使用值接收者（如 func (c ConfigMap) String()），才能被模板正确识别；若使用指针接收者（func (c *ConfigMap) String()），则需传入 &data，否则方法不会被调用。
- 若类型同时实现了 error 接口（即含 Error() string 方法），则 Error() 优先级高于 String() —— 这是 fmt 包的约定，模板亦遵循此规则。
html/template 中的额外处理
html/template 在调用 fmt.Sprint 获取字符串后，会进一步执行上下文感知转义（contextual auto-escaping）。例如：
type UnsafeMap map[string]string
func (u UnsafeMap) String() string {
return `<script>alert(1)</script>`
}
t := template.Must(htmltemplate.New("").Parse("{{.}}"))
t.Execute(os.Stdout, UnsafeMap{}) // 输出：<script>alert(1)</script>
此时原始 String() 返回值会被 HTML 转义，确保 XSS 安全。如需绕过转义（仅限可信内容），应使用 template.HTML 类型或 {{. | safeHTML}} 等安全函数，而非依赖 String()。
总结
- 模板的 {{.}} 渲染本质是 fmt.Sprint / fmt.Fprint 的封装；
- 自定义 String() 是最直接、标准的扩展方式，但需注意接收者类型匹配；
- Error() 优先级更高，适用于错误语义明确的场景；
- 在 html/template 中，自定义字符串仍受自动转义保护，安全性不因 String() 而妥协；
- 如需结构化、跨语言兼容的序列化（如传给前端 JS），推荐显式使用 json.Marshal 并注入为 template.JS，而非依赖 fmt 的 map 表示。
