在现代应用程序中，发送包含文本内容和附件的电子邮件是一项常见需求。虽然go语言标准库提供了 net/smtp 包用于smtp通信，但直接使用它来构建带有mime多部分（multipart）附件的邮件可能较为繁琐。幸运的是，有一些第三方库能够极大地简化这一过程。本教程将介绍如何使用 github.com/scorredoira/email 库，以简洁高效的方式实现此功能。
引入 email 库
首先，你需要将 scorredoira/email 库引入到你的Go项目中。在终端中运行以下命令：
go get github.com/scorredoira/email
这将下载并安装该库及其依赖。
构建带附件的邮件
email 库提供了一个直观的API来创建和配置邮件。核心流程包括初始化邮件消息、设置发件人与收件人、添加邮件主题和正文，以及附加文件。
创建新邮件消息 使用 email.NewMessage 函数可以快速创建一个新的邮件实例。它接受邮件主题和正文作为参数。
设置发件人与收件人 通过设置 m.From 字段指定发件人邮箱地址，并通过 m.To 字段设置一个或多个收件人邮箱地址。
-
添加附件m.Attach 方法用于向邮件中添加附件。你只需提供附件的文件路径，库会自动处理文件的读取和MIME类型设置。如果文件不存在或无法读取，该方法会返回一个错误。
立即学习“go语言免费学习笔记（深入）”；
以下是构建邮件的示例代码：
package main
import (
"log"
"net/smtp"
"github.com/scorredoira/email"
)
func main() {
// 1. 创建新邮件消息
// 参数：邮件主题, 邮件正文
m := email.NewMessage("Go语言发送带附件邮件", "你好，这是邮件正文内容。请查收附件。")
// 2. 设置发件人与收件人
m.From = "sender@example.com" // 替换为你的发件人邮箱
m.To = []string{"recipient@example.com"} // 替换为你的收件人邮箱
// 3. 添加附件
// 确保 'picture.png' 文件存在于程序运行目录下，或者提供完整路径
err := m.Attach("picture.png")
if err != nil {
log.Printf("添加附件失败: %v", err)
// 通常情况下，如果附件是必须的，这里应该退出或返回错误
// 但为了演示，我们继续尝试发送（可能不带附件）
}
// ... 邮件发送部分将在下一节介绍
}在上面的例子中，我们假设存在一个名为 picture.png 的文件。在实际应用中，你需要确保该文件路径是正确的，并且应用程序有权限访问它。
邮件发送与SMTP配置
邮件构建完成后，下一步就是通过SMTP服务器将其发送出去。email.Send 函数负责处理SMTP连接、认证和邮件发送。
SMTP服务器地址和端口 你需要提供SMTP服务器的地址和端口，例如 smtp.gmail.com:587。端口通常是 587 (TLS/STARTTLS) 或 465 (SMTPS)。
SMTP认证 大多数SMTP服务器要求认证。smtp.PlainAuth 函数用于创建基于用户名和密码的认证凭据。它接受四个参数：identity (通常为空字符串或与 username 相同), username, password, 和 host (SMTP服务器的域名)。
发送邮件 将SMTP服务器地址、认证信息和构建好的邮件消息传递给 email.Send 函数即可完成发送。
// ... 接续上文的 main 函数
// 4. 配置SMTP服务器信息
smtpHost := "smtp.gmail.com" // 你的SMTP服务器地址
smtpPort := "587" // 你的SMTP服务器端口
smtpAddr := smtpHost + ":" + smtpPort
// 5. 设置SMTP认证信息
// 替换为你的SMTP用户名和密码
auth := smtp.PlainAuth("", "your_smtp_username", "your_smtp_password", smtpHost)
// 6. 发送邮件
err = email.Send(smtpAddr, auth, m)
if err != nil {
log.Fatalf("发送邮件失败: %v", err)
}
log.Println("邮件发送成功！")
}重要提示：
- 请将 sender@example.com、recipient@example.com、your_smtp_username 和 your_smtp_password 替换为实际的邮箱地址和认证信息。
- smtp.gmail.com 是Gmail的SMTP服务器。如果你使用其他邮件服务提供商，请查阅其文档获取正确的SMTP服务器地址和端口。
- 对于Gmail等服务，可能需要开启“允许安全性较低的应用访问”或生成“应用专用密码”才能通过SMTP发送邮件。
注意事项
- 错误处理： 在实际应用中，对 m.Attach 和 email.Send 返回的错误进行健壮的错误处理至关重要。这有助于诊断问题并提高程序的稳定性。
- 敏感信息保护： 避免在代码中硬编码SMTP用户名和密码。推荐使用环境变量、配置文件或密钥管理服务来存储和获取这些敏感信息。
- 文件路径： 确保附件的文件路径是正确的，并且程序有读取该文件的权限。对于部署在不同环境中的应用程序，应考虑使用相对路径或配置可变的文件存储路径。
- SMTP服务器配置： 不同的SMTP服务器可能有不同的安全要求。例如，有些可能强制使用SSL/TLS加密（端口465），而另一些则使用STARTTLS（端口587）。请根据你的服务提供商调整配置。
- 邮件内容编码： email 库通常会自动处理MIME编码，但如果你的邮件正文包含特殊字符或非ASCII字符，请确保其以UTF-8编码，以避免乱码。
总结
github.com/scorredoira/email 库为Go语言开发者提供了一个简洁高效的解决方案，用于发送包含文本和附件的电子邮件。通过清晰的API设计，它抽象了MIME多部分邮件构建的复杂性，并与Go标准库的 net/smtp 包无缝集成。遵循本教程中的步骤和注意事项，你将能够轻松地在你的Go应用程序中实现强大的邮件发送功能。
