首页 > Golang > Go教程

Golangnet/smtp发送邮件实战教程

时间：2025-11-29 08:33:31 136浏览收藏

小伙伴们对Golang编程感兴趣吗？是否正在学习相关知识点？如果是，那么本文《Golang net/smtp 发送邮件实战教程》，就很适合你，本篇文章讲解的知识点主要包括。在之后的文章中也会多多分享相关知识点，希望对大家的知识积累有所帮助！

使用Golang的net/smtp包发送邮件需配置正确认证与加密。首先采用587端口通过StartTLS建立加密连接，使用授权码而非登录密码进行PLAIN认证，构造符合MIME标准的邮件头部与正文，利用smtp.Dial建立连接后依次调用StartTLS、Auth、Mail、Rcpt、Data等方法完成发送，注意处理UTF-8编码以避免中文乱码，推荐使用第三方库简化HTML邮件或附件添加。

Golang如何用 net/smtp 发送邮件_Golang SMTP 客户端邮件发送实战

使用 Golang 的 net/smtp 包发送邮件并不复杂，但需要注意认证方式、加密协议和邮件格式的正确设置。下面将从基础到实战，详细介绍如何用 Go 实现通过 SMTP 发送邮件。

SMTP 基础与认证方式

Go 的 net/smtp 包支持基于明文、登录（LOGIN）、普通密码（PLAIN）等认证机制。大多数现代邮件服务商（如 Gmail、QQ 邮箱、163 等）要求使用 TLS 加密连接，并配合 App Password 或授权码进行身份验证。

常见端口：

587：STARTTLS，先明文连接再升级加密
465：旧式 SSL/TLS 加密连接（Go 中需手动封装 TLS）

注意：Go 的 net/smtp 不直接支持 465 端口的隐式 TLS，建议使用 587 + StartTLS。

构造标准邮件内容

邮件正文需遵循 MIME 格式。最简单的纯文本邮件可通过拼接 Header 实现：

To: recipient@example.com
Subject: 测试邮件

这是邮件正文。

关键点是空行分隔头部与正文。若带 HTML 或附件，结构更复杂，建议使用第三方库（如 mail/v2），但原生实现也可行。

代码实战：发送纯文本邮件

以下是一个完整示例，使用 QQ 邮箱或 Gmail 的 SMTP 发送邮件：

package main

import (
    "crypto/tls"
    "fmt"
    "net/mail"
    "net/smtp"
)

func sendEmail() error {
    from := "your_email@qq.com"
    password := "your_authorization_code" // 不是登录密码
    to := "recipient@example.com"
    smtpHost := "smtp.qq.com"
    smtpPort := "587"

    // 构造邮件内容
    subject := "测试主题"
    body := "这是一封来自 Go 程序的测试邮件。"
    msg := fmt.Sprintf("To: %s\r\nSubject: %s\r\n\r\n%s", to, subject, body)

    // 解析发件人邮箱
    sender, err := mail.ParseAddress(from)
    if err != nil {
        return err
    }

    auth := smtp.PlainAuth("", from, password, smtpHost)

    // 建立连接
    conn, err := smtp.Dial(smtpHost + ":" + smtpPort)
    if err != nil {
        return err
    }
    defer conn.Close()

    // 启用 TLS
    if err = conn.StartTLS(&tls.Config{ServerName: smtpHost}); err != nil {
        return err
    }

    // 认证
    if err = conn.Auth(auth); err != nil {
        return err
    }

    // 设置发件人和收件人
    if err = conn.Mail(sender.Address); err != nil {
        return err
    }
    if err = conn.Rcpt(to); err != nil {
        return err
    }

    // 写入邮件数据
    writer, err := conn.Data()
    if err != nil {
        return err
    }
    _, err = writer.Write([]byte(msg))
    if err != nil {
        return err
    }
    err = writer.Close()
    if err != nil {
        return err
    }

    return conn.Quit()
}

func main() {
    if err := sendEmail(); err != nil {
        fmt.Printf("发送失败: %v\n", err)
    } else {
        fmt.Println("邮件发送成功！")
    }
}

常见问题与注意事项

实际使用中容易出错的地方：

授权码问题：QQ、Gmail 等需开启 SMTP 并生成专用授权码，不能用账户登录密码。
TLS 配置：StartTLS 要求正确设置 ServerName，否则证书校验失败。
防火墙/网络：某些环境屏蔽 587 端口，可尝试代理或更换网络。
中文乱码：Subject 和正文应使用 UTF-8 编码，必要时 Base64 编码 Subject。

如果需要发送 HTML 邮件或多部分内容，建议引入 github.com/go-gomail/gomail 或 github.com/jordan-wright/email 等库简化操作。

基本上就这些。掌握 net/smtp 的核心流程后，可以灵活扩展功能，比如批量发送、模板填充等。不复杂但容易忽略细节，尤其是安全配置部分。

本篇关于《Golangnet/smtp发送邮件实战教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！