Golang发邮件教程:gomail使用指南
还在为Go语言发送邮件而烦恼吗?本文为你提供一份详尽的Golang使用gomail库发送邮件的教程,助你轻松实现邮件发送功能。首先,我们将指导你如何安装gomail库,并详细讲解如何配置SMTP服务器信息,以QQ邮箱为例,提供SMTP地址、端口和授权码的设置方法。其次,通过示例代码,一步步教你创建邮件内容,设置发件人、收件人、标题和正文,并通过gomail.NewDialer()连接SMTP服务器,最后使用DialAndSend()发送邮件。此外,本文还列出了常见问题与注意事项,如TLS连接、HTML内容支持、多收件人设置以及错误处理建议,确保你的邮件发送功能稳定可靠。掌握这些技巧,让你的Go项目拥有强大的邮件发送能力!
在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 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 地址)从代码中抽离出来,通过配置文件或环境变量管理。
基本上就这些,如果你只是想实现一个简单的邮件通知功能,上面的内容已经足够用了。
理论要掌握,实操不能落!以上关于《Golang发邮件教程:gomail使用指南》的详细介绍,大家都掌握了吧!如果想要继续提升自己的能力,那么就来关注golang学习网公众号吧!
BOM二维码扫描实现方法详解
- 上一篇
- BOM二维码扫描实现方法详解
- 下一篇
- Deepseek与AIPRM助你优化ChatGPT提示
-
- Golang · Go教程 | 1天前 | map · 并发安全 · RWMutex · sync.Map · Go教程 · 并发安全 RWMutex sync.Map Go map并发读写 go test race
- Go map 并发读写崩溃怎么办:从复现报错到 RWMutex 修复的完整流程
- 272浏览 收藏
-
- Golang · Go教程 | 3天前 | singleflight · 并发控制 · Go教程 · 缓存治理 · 接口优化 · Go 并发请求 缓存击穿 singleflight 缓存回填
- Go singleflight 防缓存击穿实战:相同请求只查一次数据库
- 114浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- ljg-skills
- ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
- 322次使用
-
- MELO音乐
- MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
- 338次使用
-
- UniScribe
- UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
- 307次使用
-
- 剧云
- 剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
- 483次使用
-
- 万象有声
- 万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
- 468次使用
-
- Java 性能优化上线清单:从定位、改造到灰度发布
- 2026-06-11 860浏览
-
- Spring Boot 压测验证:Gatling、JMeter 与性能回归门禁
- 2026-06-11 843浏览
-
- Java NMT 非堆内存排查:Direct Buffer、线程栈与 Metaspace 分析
- 2026-06-11 826浏览
-
- Spring Boot 容器内存优化:JVM 堆、非堆与 MaxRAMPercentage
- 2026-06-11 809浏览
-
- Tomcat 连接与线程参数调优:maxThreads、acceptCount 与 KeepAlive
- 2026-06-11 792浏览

