Golang中实现邮件发送依赖net/smtp和mime包,通过配置SMTP信息可发送文本或HTML邮件。1. 使用smtp.PlainAuth认证并调用smtp.SendMail发送纯文本邮件,需注意Gmail应用专用密码的使用。2. 发送HTML邮件时,利用multipart.Writer设置Content-Type为text/html,并结合quotedprintable编码支持富文本内容。3. 封装EmailSender结构体统一管理配置,提升代码复用性,支持动态生成邮件内容。4. 实际应用中需注意邮箱服务商限制、敏感词过滤及批量发送时的性能优化,建议结合模板引擎与消息队列。该方案简洁高效,适用于多种邮件场景。

在Golang中实现邮件发送功能并不复杂,主要依赖标准库red">net/smtp和mime相关包。通过配置SMTP服务器信息,构造符合规范的邮件内容,即可完成文本或HTML格式的邮件发送。下面从基础实现到常见场景,一步步带你完成Golang邮件发送的实战应用。
使用net/smtp发送纯文本邮件
Go的标准库net/smtp提供了基于SMTP协议的认证和发送支持。以下是一个发送纯文本邮件的简单示例:
代码示例:
package main
import (
"fmt"
"net/smtp"
)
func sendTextEmail() {
from := "your_email@gmail.com"
password := "your_app_password" // 推荐使用应用专用密码
to := []string{"recipient@example.com"}
smtpHost := "smtp.gmail.com"
smtpPort := "587"
subject := "测试邮件"
body := "这是一封通过Golang发送的测试邮件。"
// 构造邮件内容
message := fmt.Sprintf("To: %s\r\nSubject: %s\r\n\r\n%s", to[0], subject, body)
// 认证信息
auth := smtp.PlainAuth("", from, password, smtpHost)
// 发送邮件
err := smtp.SendMail(smtpHost+":"+smtpPort, auth, from, to, []byte(message))
if err != nil {
fmt.Printf("发送失败: %v\n", err)
return
}
fmt.Println("邮件发送成功!")
}
注意:使用Gmail时需开启两步验证并生成“应用专用密码”替代账户密码。
立即学习“go语言免费学习笔记(深入)”;
发送HTML格式邮件
若希望邮件支持富文本(如链接、样式),需设置Content-Type为text/html,并使用mime包辅助编码。
实现方式:
import (
"bytes"
"mime/multipart"
"mime/quotedprintable"
)
func sendHTMLEmail() {
var buffer bytes.Buffer
writer := multipart.NewWriter(&buffer)
// 设置HTML内容部分
htmlPart, _ := writer.CreatePart(map[string][]string{
"Content-Type": {"text/html; charset=UTF-8"},
})
htmlContent := `你好,世界!
这是一封 HTML 邮件。
`
quotedprintable.NewWriter(htmlPart).Write([]byte(htmlContent))
writer.Close()
message := fmt.Sprintf("To: %s\r\n"+
"Subject: HTML邮件测试\r\n"+
"MIME-Version: 1.0\r\n"+
"Content-Type: %s\r\n\r\n%s",
"recipient@example.com",
writer.FormDataContentType(),
buffer.String())
// 调用SendMail发送...
}
使用multipart.Writer可灵活构建多部分邮件内容,适合包含附件或多种格式的场景。
封装通用邮件发送结构体
为提升复用性,可以将邮件功能封装成结构体和方法:
type EmailSender struct {
Host string
Port string
Username string
Password string
}
type Email struct {
To []string
Subject string
Body string
IsHTML bool
}
func (e *EmailSender) Send(email Email) error {
auth := smtp.PlainAuth("", e.Username, e.Password, e.Host)
msg := e.buildMessage(email)
return smtp.SendMail(e.Host+":"+e.Port, auth, e.Username, email.To, []byte(msg))
}
func (e *EmailSender) buildMessage(email Email) string {
contentType := "text/plain"
if email.IsHTML {
contentType = "text/html"
}
return fmt.Sprintf("To: %s\r\nSubject: %s\r\nContent-Type: %s; charset=utf-8\r\n\r\n%s",
strings.Join(email.To, ","), email.Subject, contentType, email.Body)
}
这样可以在多个项目中复用该组件,只需初始化一次配置即可多次调用Send方法。
常见问题与注意事项
实际开发中需要注意以下几点:
- Gmail等主流邮箱要求开启两步验证并使用应用密码
- 某些国内邮箱(如QQ、163)可能限制第三方客户端登录,建议查看SMTP文档
- 邮件内容避免敏感词或大量链接,防止被识别为垃圾邮件
- 生产环境应结合模板引擎(如html/template)动态生成HTML内容
- 大批量发送建议使用队列机制(如Redis + worker)避免阻塞主流程
基本上就这些。掌握基础发送逻辑后,可进一步扩展附件上传、抄送、密送等功能。Golang的简洁语法让邮件集成变得高效可靠。










