Go 的 text/template 和 html/template 通过 fmt 包（如 fmt.Sprint 或 fmt.Fprint）生成值的默认字符串表示；对 map 类型，这表现为 map[key:value ...] 格式，且可通过实现 String()（值接收者）或 Error() 方法自定义输出。
go 的 `text/template` 和 `html/template` 通过 `fmt` 包（如 `fmt.sprint` 或 `fmt.fprint`）生成值的默认字符串表示；对 map 类型，这表现为 `map[key:value ...]` 格式，且可通过实现 `string()`（值接收者）或 `error()` 方法自定义输出。
在 Go 模板中，{{.}} 或 {{pipeline}} 这类无函数调用的管道操作，并不会直接调用模板引擎内置的序列化逻辑，而是依赖标准库的 fmt 包进行格式化输出。具体而言：
- text/template 在内部调用 fmt.Fprint(s.wr, iface)（见 exec.go#L848）；
- html/template 则使用 fmt.Sprint(args...)（见 content.go#L135），再结合上下文进行 HTML 转义。
这意味着：任何符合 fmt.Stringer 接口（即拥有 String() string 方法）的类型，其返回值将被直接用作模板输出——前提是该方法使用值接收者，且传入模板的是该类型的值（而非指针）。
以下是一个完整示例，展示如何为自定义 map 类型注入可定制的文本表示：
package main
import (
"os"
"text/template"
)
type MyMap map[string]interface{}
// ✅ 正确：值接收者 → 模板中传入 MyMap{} 即可生效
func (m MyMap) String() string {
return `{"custom": true, "data": ` + fmt.Sprintf("%v", map[string]interface{}(m)) + `}`
}
func main() {
t := template.Must(template.New("").Parse("{{.}}"))
mm := MyMap{"name": "Alice", "age": 30}
t.Execute(os.Stdout, mm) // 输出: {"custom": true, "data": map[name:Alice age:30]}
}
⚠️ 注意事项：
- 接收者类型决定适用性：若 String() 使用指针接收者（func (m *MyMap) String() string），则必须向模板传入 &mm（即 *MyMap 类型值），否则 fmt 不会识别该方法。
- error 接口优先级更高：若类型同时实现了 error 接口（含 Error() string），则 Error() 会被优先调用，String() 将被忽略。
-
html/template 中的双重处理：即使 String() 返回合法 HTML 字符串（如 hello），html/template 仍会对其执行自动转义（如变为 <div>hello</div>），以防止 XSS。如需原样插入，应使用 template.HTML 类型或 {{. | safeHTML}}（配合 template.FuncMap 自定义安全函数）。
总结来说，模板的“默认文本表示”本质是 fmt 包的字符串化行为，而非模板引擎专属逻辑。开发者可通过标准接口（fmt.Stringer、error）自然介入这一过程，实现灵活、类型安全的自定义输出，同时需严格注意接收者类型与模板传参方式的一致性。
