Python发邮件教程：smtplib使用全解析

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Python发送邮件教程：smtplib使用详解》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

Python发送邮件的核心在于利用smtplib模块与SMTP服务器通信，并用email模块构建邮件内容。常见认证问题包括：1.密码错误或未启用授权码，需使用邮箱生成的专用密码；2.SMTP地址或端口错误，应根据服务商配置正确参数；3.网络或防火墙限制，需检查端口访问权限；4.SSL/TLS协议不匹配，应根据端口选择加密方式。对于HTML或附件邮件，需使用MIMEText设置subtype为html，或通过MIMEMultipart组合多部分内容。整个流程需注意编码、加密连接及邮件内容封装。

Python发送电子邮件，核心在于利用其内置的smtplib模块与邮件服务商的SMTP服务器进行通信。它允许我们像命令行一样，一步步地与邮件服务器“对话”，发送指令，最终把邮件送出去。同时，email模块则负责把我们想发的内容——无论是纯文本、HTML还是附件——“包装”成邮件服务器能理解的标准格式。

要用Python发邮件，我们通常会经历这么几个步骤，看似繁琐，实则逻辑清晰：连接服务器、登录、构建邮件内容，最后发送。

最基本的纯文本邮件发送流程是这样的：

import smtplib
from email.mime.text import MIMEText
from email.header import Header # 为了处理中文主题等

# 邮件配置
sender = '你的发件邮箱@example.com' # 替换为你的邮箱
password = '你的邮箱授权码或密码' # 替换为你的授权码或密码
receivers = ['收件人邮箱@example.com'] # 可以是列表，发送给多人

# 邮件服务器配置 (以Gmail为例，其他服务商请查询其SMTP设置)
# 对于Gmail，通常需要开启两步验证并生成应用专用密码
smtp_server = 'smtp.gmail.com'
smtp_port = 587 # 推荐使用587端口，配合TLS加密

# 邮件内容
msg = MIMEText('这是一封由Python发送的测试邮件，内容很简单。', 'plain', 'utf-8')
msg['From'] = Header("你的名字 <{}>".format(sender), 'utf-8')
msg['To'] = Header("收件人名称 <{}>".format(','.join(receivers)), 'utf-8')
msg['Subject'] = Header("Python邮件发送测试", 'utf-8')

try:
    # 连接SMTP服务器
    server = smtplib.SMTP(smtp_server, smtp_port)
    server.ehlo() # 向服务器标识身份
    server.starttls() # 启动TLS加密
    server.ehlo() # 再次标识身份，以适应TLS连接

    # 登录邮箱
    server.login(sender, password)

    # 发送邮件
    server.sendmail(sender, receivers, msg.as_string())
    print("邮件发送成功！")

except smtplib.SMTPAuthenticationError:
    print("认证失败：请检查用户名和密码（或授权码），以及是否开启了应用专用密码。")
except smtplib.SMTPConnectError as e:
    print(f"连接服务器失败：{e}。请检查SMTP服务器地址和端口是否正确，网络连接是否正常。")
except Exception as e:
    print(f"发送邮件时发生错误：{e}")
finally:
    if 'server' in locals() and server:
        server.quit() # 关闭连接

这里我特意用了Header来处理主题和发件人名称，因为直接用字符串在某些情况下（比如中文）可能会出现乱码。starttls()是关键，它把一个普通的SMTP连接升级为加密连接，这是目前大多数邮件服务商推荐的方式。

使用smtplib发送邮件时常见的认证问题和解决方案有哪些？

认证问题，简直是初次尝试Python发邮件的“拦路虎”。我个人就遇到过好几次，明明代码逻辑没问题，但就是提示认证失败。这背后其实有不少原因。

• 密码错误或授权码未启用： 最直接的，就是你输入的密码不对。但现在很多大型邮箱服务商，比如Gmail、QQ邮箱、网易邮箱，出于安全考虑，当你通过第三方客户端（比如Python脚本）登录时，不再允许使用你的账户登录密码，而是需要生成一个“客户端专用授权码”或“应用专用密码”。如果你用的是普通登录密码，那基本是认证不通过的。

  • 解决方案： 登录你的邮箱网页版，在“账户安全”或“设置”中寻找“POP3/IMAP/SMTP服务”或“客户端授权码”相关的选项，开启它并生成一个专用密码。将这个专用密码填入代码的password变量。

• SMTP服务器地址或端口错误： 每个邮件服务商的SMTP服务器地址和端口都可能不同。常见的SMTP服务器地址是smtp.xxx.com，端口通常是25（不加密或旧式），465（SSL加密），或587（TLS加密，推荐）。

  • 解决方案： 仔细核对你的邮件服务商提供的SMTP服务器地址和端口。例如，Gmail是smtp.gmail.com:587（TLS）或smtp.gmail.com:465（SSL）。如果用465端口，你需要使用smtplib.SMTP_SSL而不是smtplib.SMTP。

• 防火墙或网络限制： 有时候，公司的网络防火墙或者你自己的电脑防火墙可能会阻止Python脚本连接到外部的SMTP端口。

  • 解决方案： 检查你的防火墙设置，确保587或465端口没有被阻止。如果是在公司内网，可能需要联系IT部门。

• SSL/TLS协议问题： 邮件服务商可能要求使用加密连接。如果你的代码没有正确启用TLS (starttls()) 或者使用了错误的加密方式（比如尝试用普通SMTP连接465端口），也会导致连接失败或认证问题。

  • 解决方案： 对于587端口，务必在connect之后、login之前调用server.starttls()。对于465端口，直接使用server = smtplib.SMTP_SSL(smtp_server, smtp_port)来建立连接。

这些问题，很多时候都是细节上的疏忽，但它们会直接导致整个邮件发送流程卡死。所以，遇到问题时，第一反应就是检查这些配置细节，特别是那个授权码。

如何使用Python发送包含附件或HTML内容的邮件？

发送纯文本邮件只是个开始，实际工作中，我们更常需要发送带有格式的HTML邮件，或者附带文件。email模块就是为这些复杂需求而生的。它提供了一套类来构建多部分邮件（MIMEMultipart），让你能把文本、HTML、图片、文件等“打包”在一起。

发送HTML邮件，本质上是把邮件正文的subtype从plain改成html：

from email.mime.text import MIMEText
from email.

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~