在go语言中使用gomail库发送邮件,需先安装库并配置smtp信息。步骤如下:1. 安装gomail:执行go get gopkg.in/gomail.v2;2. 配置smtp服务器,如qq邮箱的地址为smtp.qq.com、端口465、授权码作为密码;3. 编写代码创建邮件内容并发送,使用gomail.newmessage()设置发件人、收件人、标题和正文,通过gomail.newdialer()连接smtp服务器并调用dialandsend()发送;4. 注意事项包括确保tls连接、处理证书错误、支持html内容及多收件人、cc/bcc设置,并做好错误处理以应对认证失败或网络问题。实际开发中建议将配置从代码中抽离,通过配置文件或环境变量管理。

发送电子邮件在很多应用场景中是刚需,比如用户注册验证、系统通知、日志报警等。在 Go 语言中,使用
gomail库是一个比较常见且方便的方式,它封装了 SMTP 协议的细节,让开发者可以更专注于业务逻辑。

下面我们就来看看如何用
gomail实现邮件发送功能,包括基本配置、代码结构和一些注意事项。

准备工作:安装 gomail
首先确保你的项目中已经引入了
gomail库。可以通过以下命令安装:
立即学习“go语言免费学习笔记(深入)”;
go get gopkg.in/gomail.v2
这个库目前虽然不是官方维护,但社区活跃度高,稳定性也还不错。

配置SMTP服务器信息
要发送邮件,必须有一个可用的 SMTP 服务。你可以使用自己的邮箱服务商提供的 SMTP 地址,比如 QQ 邮箱、163 邮箱、Gmail 等,也可以使用第三方邮件服务(如 SendGrid)。
以 QQ 邮箱为例,配置如下:
- SMTP 服务器地址:
smtp.qq.com
- 端口:通常为
465
或587
- 用户名:你的 QQ 邮箱地址
- 密码:QQ 邮箱的“授权码”(不是登录密码)
示例配置:
smtpHost := "smtp.qq.com" smtpPort := 465 senderEmail := "your-qq@qq.com" senderPassword := "your-authorization-code"
注意:密码字段填的是“授权码”而非登录密码。QQ 邮箱可以在设置里开启 IMAP/SMTP 并获取授权码。
编写发送邮件的代码
使用
gomail构建邮件内容非常直观。下面是一个完整的发送邮件函数示例:
package main
import (
"gopkg.in/gomail.v2"
)
func sendEmail(to, subject, body string) error {
m := gomail.NewMessage()
m.SetHeader("From", "your-qq@qq.com") // 发件人
m.SetHeader("To", to) // 收件人
m.SetHeader("Subject", subject) // 标题
m.SetBody("text/plain", body) // 正文内容(纯文本)
d := gomail.NewDialer("smtp.qq.com", 465, "your-qq@qq.com", "your-authorization-code")
// 开始发送
if err := d.DialAndSend(m); err != nil {
return err
}
return nil
}调用方式:
err := sendEmail("someone@example.com", "测试邮件", "这是一封测试邮件内容")
if err != nil {
panic(err)
}常见问题与注意事项
使用 TLS 连接
有些 SMTP 服务器要求强制使用 TLS 加密连接。
gomail默认会尝试使用 TLS,但如果遇到证书问题或不信任的证书源,可能需要手动配置。
例如,忽略证书错误(仅限测试环境):
d := gomail.NewDialer("smtp.qq.com", 465, "your-qq@qq.com", "your-authorization-code")
d.TLSConfig = &tls.Config{InsecureSkipVerify: true} // 不推荐用于生产环境设置HTML内容
如果想发送 HTML 格式的邮件正文,只需要改一下
SetBody的参数:
m.SetBody("text/html", "这是一个HTML邮件
")多个收件人或抄送
支持同时发给多个收件人,或者添加 CC/BCC:
m.SetHeader("To", "user1@example.com", "user2@example.com")
m.SetAddressHeader("Cc", "cc@example.com", "抄送用户")错误处理建议
- 如果出现
connection refused
,请检查 SMTP 地址和端口是否正确。 - 如果提示认证失败,请确认你使用的是“授权码”而不是登录密码。
- 如果提示
timeout
,可能是网络不通或防火墙限制。
小结
使用
gomail发送邮件并不复杂,只要准备好 SMTP 配置,就可以快速集成到项目中。实际开发中建议将配置项(如账号、密码、SMTP 地址)从代码中抽离出来,通过配置文件或环境变量管理。
基本上就这些,如果你只是想实现一个简单的邮件通知功能,上面的内容已经足够用了。










