如何在Golang中实现简单的邮件发送功能_Golang邮件发送项目实战汇总

Golang中实现邮件发送依赖net/smtp和mime包,通过配置SMTP信息可发送文本或HTML邮件。1. 使用smtp.PlainAuth认证并调用smtp.SendMail发送纯文本邮件,需注意Gmail应用专用密码的使用。2. 发送HTML邮件时,利用multipart.Writer设置Content-Type为text/html,并结合quotedprintable编码支持富文本内容。3. 封装EmailSender结构体统一管理配置,提升代码复用性,支持动态生成邮件内容。4. 实际应用中需注意邮箱服务商限制、敏感词过滤及批量发送时的性能优化,建议结合模板引擎与消息队列。该方案简洁高效,适用于多种邮件场景。

在Golang中实现邮件发送功能并不复杂,主要依赖标准库net/smtpmime相关包。通过配置SMTP服务器信息,构造符合规范的邮件内容,即可完成文本或HTML格式的邮件发送。下面从基础实现到常见场景,一步步带你完成Golang邮件发送的实战应用。

使用net/smtp发送纯文本邮件

Go的标准库net/smtp提供了基于SMTP协议的认证和发送支持。以下是一个发送纯文本邮件的简单示例:

代码示例:

package main

import (
    "fmt"
    "net/smtp"
)

func sendTextEmail() {
    from := "your_email@gmail.com"
    password := "your_app_password" // 推荐使用应用专用密码
    to := []string{"recipient@example.com"}
    smtpHost := "smtp.gmail.com"
    smtpPort := "587"

    subject := "测试邮件"
    body := "这是一封通过Golang发送的测试邮件。"

    // 构造邮件内容
    message := fmt.Sprintf("To: %s\r\nSubject: %s\r\n\r\n%s", to[0], subject, body)

    // 认证信息
    auth := smtp.PlainAuth("", from, password, smtpHost)

    // 发送邮件
    err := smtp.SendMail(smtpHost+":"+smtpPort, auth, from, to, []byte(message))
    if err != nil {
        fmt.Printf("发送失败: %v\n", err)
        return
    }
    fmt.Println("邮件发送成功!")
}

注意:使用Gmail时需开启两步验证并生成“应用专用密码”替代账户密码。

发送HTML格式邮件

若希望邮件支持富文本(如链接、样式),需设置Content-Type为text/html,并使用mime包辅助编码。

实现方式:

import (
    "bytes"
    "mime/multipart"
    "mime/quotedprintable"
)

func sendHTMLEmail() {
    var buffer bytes.Buffer
    writer := multipart.NewWriter(&buffer)

    // 设置HTML内容部分
    htmlPart, _ := writer.CreatePart(map[string][]string{
        "Content-Type": {"text/html; charset=UTF-8"},
    })
    htmlContent := `

你好,世界!

这是一封 HTML 邮件。

` quotedprintable.NewWriter(htmlPart).Write([]byte(htmlContent)) writer.Close() message := fmt.Sprintf("To: %s\r\n"+ "Subject: HTML邮件测试\r\n"+ "MIME-Version: 1.0\r\n"+ "Content-Type: %s\r\n\r\n%s", "recipient@example.com", writer.FormDataContentType(), buffer.String()) // 调用SendMail发送... }

使用multipart.Writer可灵活构建多部分邮件内容,适合包含附件或多种格式的场景。

封装通用邮件发送结构体

为提升复用性,可以将邮件功能封装成结构体和方法:

type EmailSender struct {
    Host     string
    Port     string
    Username string
    Password string
}

type Email struct {
    To      []string
    Subject string
    Body    string
    IsHTML  bool
}

func (e *EmailSender) Send(email Email) error {
    auth := smtp.PlainAuth("", e.Username, e.Password, e.Host)
    msg := e.buildMessage(email)
    return smtp.SendMail(e.Host+":"+e.Port, auth, e.Username, email.To, []byte(msg))
}

func (e *EmailSender) buildMessage(email Email) string {
    contentType := "text/plain"
    if email.IsHTML {
        contentType = "text/html"
    }
    return fmt.Sprintf("To: %s\r\nSubject: %s\r\nContent-Type: %s; charset=utf-8\r\n\r\n%s",
        strings.Join(email.To, ","), email.Subject, contentType, email.Body)
}

这样可以在多个项目中复用该组件,只需初始化一次配置即可多次调用Send方法。

常见问题与注意事项

实际开发中需要注意以下几点:

  • Gmail等主流邮箱要求开启两步验证并使用应用密码
  • 某些国内邮箱(如QQ、163)可能限制第三方客户端登录,建议查看SMTP文档
  • 邮件内容避免敏感词或大量链接,防止被识别为垃圾邮件
  • 生产环境应结合模板引擎(如html/template)动态生成HTML内容
  • 大批量发送建议使用队列机制(如Redis + worker)避免阻塞主流程

基本上就这些。掌握基础发送逻辑后,可进一步扩展附件上传、抄送、密送等功能。Golang的简洁语法让邮件集成变得高效可靠。