本文详解如何将 Go html/template 的执行结果写入字符串而非直接输出到标准流，核心是利用 bytes.Buffer 实现 io.Writer 接口，从而安全捕获 HTML 内容用于邮件发送等场景。
本文详解如何将 go `html/template` 的执行结果写入字符串而非直接输出到标准流，核心是利用 `bytes.buffer` 实现 `io.writer` 接口，从而安全捕获 html 内容用于邮件发送等场景。
在 Go 中，template.Execute() 函数要求第二个参数（即输出目标）必须满足 io.Writer 接口，而 string 类型本身不实现该接口——它既没有 Write([]byte) (int, error) 方法，也无法被直接修改。因此，直接传入 string 变量（如 output）会导致编译错误：cannot use output (type string) as type io.Writer。
正确的做法是使用 bytes.Buffer，它是标准库中已实现 io.Writer 的高效可变字节缓冲区：
import (
"bytes"
"html/template"
// 其他依赖，如 gopkg.in/gomail.v2
)
// 示例：渲染 HTML 模板到字符串
func renderToHTML(tmplhtml string, data interface{}) (string, error) {
buf := new(bytes.Buffer)
t := template.Must(template.New("html table").Parse(tmplhtml))
err := t.Execute(buf, data)
if err != nil {
return "", err
}
return buf.String(), nil // 转为 string 供后续使用
}
// 使用示例（如集成 gomail）
func sendEmail() error {
tmpl := `<table><tr><td>{{.Name}}</td></tr></table>`
htmlContent, err := renderToHTML(tmpl, struct{ Name string }{Name: "Alice"})
if err != nil {
return err
}
// 假设 m 是 *gomail.Message 实例
// m.SetBody("text/html", htmlContent)
// ... 发送逻辑
return nil
}⚠️ 注意事项：
- 不要尝试手动为 string 类型实现 io.Writer——Go 中字符串是不可变的，无法安全实现 Write 方法；
- bytes.Buffer 是线程不安全的，若需并发写入多个模板，请为每次执行创建独立 buf；
- 若模板内容较大，可考虑用 strings.Builder 替代（性能略优，但同样需包装为 io.Writer，通常仍推荐 bytes.Buffer 因其更通用）；
- 渲染失败时务必检查 err，避免静默丢弃模板语法错误或数据字段缺失问题。
总结：bytes.Buffer 是 Go 中捕获模板输出的标准、简洁且高效的方式。掌握这一模式，即可灵活将模板结果用于 HTTP 响应、邮件正文、文件写入或 API 返回等多种场景。
