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.

好了，本文到此结束，带大家了解了《Python发邮件教程：smtplib使用详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！