Buffalo 框架不内置邮件发送功能，需自行集成 gomail、mailgun-go 或 net/smtp 等库；推荐用 gomail 发送 HTML 邮件，配合 Buffalo 模板渲染并从环境变量读取 SMTP 配置，发信逻辑应抽离为独立 service 以保障可测性与错误处理。
Buffalo 框架里没有内置邮件发送模块
Buffalo 本身不提供 Mail 或类似 SendEmail 的封装，它只负责 Web 层路由、模板和中间件。发邮件这件事得靠你自己集成第三方库，比如 gomail、mailgun-go 或 smtp 标准库。
常见错误是直接搜 “buffalo send email”，结果卡在找不到 buffalo mailer 命令或包 —— 因为它根本不存在。
实际做法是：在 Buffalo 的 actions 或自定义 service 层里，调用标准 SMTP 客户端。你得自己处理认证、连接复用、模板渲染和错误分类。
用 gomail 发送带模板的 HTML 邮件最稳妥
gomail 轻量、无依赖、支持附件和内联 CSS，比原生 net/smtp 更适合 Buffalo 场景。它不自动渲染模板，所以你要先用 Buffalo 的 render 包生成 HTML 字符串，再喂给 gomail。
关键步骤：
- 在
actions/mail.go（或新建）中初始化gomail.Dialer，复用连接避免每次发信都握手 - 用
buffalo.Renderer加载.html模板（路径如templates/mail/welcome.html），传入数据后调用ToString() - 构造
gomail.Message，设置To、From、Subject，用SetBody("text/html", htmlStr) - 注意：HTML 模板里不能用
#{...}，Buffalo 模板语法是{{.Name}}；CSS 必须内联，否则多数邮箱客户端会过滤<style>
SMTP 配置必须从环境变量读取，别硬编码
Buffalo 的 env 配置机制不自动加载 SMTP 凭据，.env 文件里的 SMTP_HOST、SMTP_PORT、SMTP_USER、SMTP_PASS 不会自动注入到 Go 变量里。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
你得手动调用 os.Getenv("SMTP_HOST")，并在启动时校验非空，否则上线后发信静默失败。
典型坑点：
-
SMTP_PORT是字符串，需用strconv.Atoi转成int，否则gomail.NewDialer报错cannot use port (type string) as type int - Gmail 等服务要求开启「应用专用密码」并关闭两步验证，否则认证永远
535 5.7.8 Username and Password not accepted - 本地开发用
localhost:1025配合mailhog测试最安全，避免误触生产配额
发信逻辑别塞进 action handler，要抽成独立 service
把发邮件代码写在 actions/users.go 的 Create 方法里，会导致测试难、错误难捕获、HTTP 请求超时风险高（SMTP 延迟不可控）。
正确姿势是定义一个 MailService 接口，实现类里包装 gomail.Dialer 和模板渲染器，再通过依赖注入传入 handler：
type MailService interface {
SendWelcome(to string, data map[string]interface{}) error
}
func (m *SMTPMailService) SendWelcome(to string, data map[string]interface{}) error {
tpl := buffalo.Renderer.FromFiles("templates/mail/welcome.html")
html, _ := tpl.ToString(data)
msg := gomail.NewMessage()
msg.SetHeader("To", to)
msg.SetHeader("From", "no-reply@example.com")
msg.SetHeader("Subject", "Welcome!")
msg.SetBody("text/html", html)
return m.dialer.DialAndSend(msg)
}
这样单元测试可以 mock MailService，异步发信也能后续接入 Celery 或简单 goroutine（但注意并发限流）。
真正容易被忽略的是：SMTP 错误不是 HTTP 错误，SendWelcome 失败时，用户注册成功了但邮件没发出去 —— 你得记录日志、告警，甚至落库重试，而不是只返回 500 给前端。
