Golang如何发送电子邮件使用gomail库实现SMTP协议交互-Golang-PHP中文网

Golang如何发送电子邮件使用gomail库实现SMTP协议交互

P粉602998670

发布： 2025-08-01 11:30:03

原创

854人浏览过

在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设置，并做好错误处理以应对认证失败或网络问题。实际开发中建议将配置从代码中抽离，通过配置文件或环境变量管理。

Golang如何发送电子邮件使用gomail库实现SMTP协议交互

发送电子邮件在很多应用场景中是刚需，比如用户注册验证、系统通知、日志报警等。在 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 邮箱的“授权码”（不是登录密码）

示例配置：

腾讯交互翻译

腾讯AI Lab发布的一款AI辅助翻译产品

查看详情

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", "<h1>这是一个HTML邮件</h1>")

登录后复制

多个收件人或抄送

支持同时发给多个收件人，或者添加 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库实现SMTP协议交互的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

使用第三方 DNS 库解析 Golang 中的 DNS 数据包 Golang 链表中删除节点：正确方法与指针理解在 Golang 中查找字符索引的方法 Golang 数组类型混淆及切片使用详解 GoLang中从文件读取混合数据类型（字符串、浮点数、整数）的实践指南

Golang如何发送电子邮件 使用gomail库实现SMTP协议交互

准备工作：安装 gomail

配置SMTP服务器信息

编写发送邮件的代码

常见问题与注意事项

使用 TLS 连接

设置HTML内容

多个收件人或抄送

错误处理建议

小结

大家都在看：

Golang如何发送电子邮件使用gomail库实现SMTP协议交互