GolangSMTP发邮件教程详解

想要用 Golang 发送邮件？本文为你提供一份详尽的 Golang SMTP 发送邮件教程，让你轻松掌握邮件发送技巧。首先，你需要准备好 SMTP 服务器信息和邮箱账号，例如 Gmail、QQ 邮箱、163 邮箱等，并注意配置正确的端口和认证方式，特别是应用专用密码和 TLS/SSL 设置。接着，我们将深入讲解如何使用 Golang 的 `net/smtp` 包，手动构造邮件内容、连接 SMTP 服务器并进行身份验证，最后发送邮件。同时，我们还会分享常见问题及注意事项，例如认证失败、连接超时和邮件被拒收等，助你避坑。为了提升开发效率，我们还推荐使用第三方库如 `go-mail/mail` 或 `jordan-wright/email`，尤其是在处理 HTML 邮件或附件时，它们能帮你简化代码，事半功倍。无论你是新手还是有经验的 Golang 开发者，都能通过本文快速掌握 Golang 发送邮件的技能。

用Golang发邮件的关键在于掌握流程和参数配置，1. 准备SMTP服务器信息和账号，如Gmail为smtp.gmail.com:587、QQ邮箱为smtp.qq.com:465或587、163邮箱为smtp.163.com:465或25，需注意使用应用专用密码并确认TLS/SSL启用情况；2. 使用net/smtp包发送邮件需手动拼接邮件内容，基本流程包括构造邮件内容、连接SMTP服务器并验证、发送邮件，代码示例中邮件头与正文间必须有两个\r\n；3. 注意认证失败、连接超时、邮件被拒收等问题，检查密码、网络、格式及频率；4. 推荐使用第三方库如go-mail/mail或jordan-wright/email提升开发效率，尤其在处理HTML邮件或附件时更为便捷。

发邮件这事儿，用 Golang 做其实不难，标准库里的 net/smtp 包就能搞定。关键在于搞清楚流程和参数怎么配，尤其是认证方式和服务器地址这些细节别弄错。

1. 准备工作：SMTP 服务器信息和账号

要发邮件，首先得知道你用的邮箱服务商提供的 SMTP 地址和端口。比如：

• Gmail：smtp.gmail.com:587
• QQ 邮箱：smtp.qq.com:465 或 587
• 163 邮箱：smtp.163.com:465 或 25（有的可能需要 SSL）

然后是你的邮箱账号和密码。注意，有些服务商（比如 Gmail）现在要求使用“应用专用密码”，而不是你的主账号密码。

还要确认是否启用 TLS 或者 SSL。一般推荐用 STARTTLS 模式，也就是端口 587 这种。

2. 使用 net/smtp 发送邮件的基本步骤

Go 的 smtp 包提供了发送邮件的核心功能，但没有封装邮件内容结构。所以你需要手动拼接邮件正文，或者配合 mime 包来构造更复杂的格式。

基本流程如下：

• 构造邮件内容（包括收件人、主题、正文等）
• 连接到 SMTP 服务器并进行身份验证
• 发送邮件

示例代码大致像这样：

auth := smtp.PlainAuth("", "your_email@example.com", "your_password", "smtp.example.com")

to := []string{"recipient@example.com"}
msg := []byte("To: recipient@example.com\r\n" +
    "Subject: 测试邮件\r\n" +
    "\r\n" +
    "这是测试内容。\r\n")

err := smtp.SendMail("smtp.example.com:587", auth, "your_email@example.com", to, msg)
if err != nil {
    log.Fatal(err)
}

注意：上面这段代码里，邮件头和正文之间必须有两个 \r\n，否则可能会被当作垃圾邮件或报错。

3. 常见问题与注意事项

• 认证失败：检查用户名和密码是否正确，尤其是某些邮箱需要开启“第三方登录”或生成“授权码”。
• 连接超时：检查网络是否通，SMTP 地址和端口是否正确。
• 邮件被拒收：可能是邮件格式不对，或者发信频率过高触发反垃圾机制。
• 不支持 SSL/TLS：有些老旧的邮件服务器只支持明文传输，这时候可以尝试用 smtp.SendMail 的替代方法，比如自己建立连接后调用 smtp.Client 手动控制流程。

如果你需要发 HTML 邮件或者带附件，那就要手动构造 MIME 格式的内容了，这部分稍微复杂一点，但网上有很多模板可以直接参考。

4. 更方便的方式：使用第三方库

虽然标准库能完成基本任务，但如果要做更复杂的功能（比如加附件、HTML 内容、多语言支持），建议用一些封装好的库，比如：

• go-mail/mail
• jordan-wright/email

它们在底层还是用了 smtp，但帮你处理好了 MIME 结构、加密连接等问题，开发效率高不少。

基本上就这些。用 smtp 包发邮件不算复杂，但细节容易出错，尤其是一些邮箱的安全策略限制比较多。只要把认证和邮件格式弄对，就能稳定发出去了。

终于介绍完啦！小伙伴们，这篇关于《GolangSMTP发邮件教程详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！