Python如何发送电子邮件？smtplib模块完整流程-Python教程-PHP中文网

邮件发送失败常见原因包括：未使用邮箱授权码而直接使用登录密码；smtp服务器地址或端口配置错误（如qq邮箱应使用smtp.qq.com:465用于ssl）；网络或防火墙限制导致无法连接；邮件内容被识别为垃圾邮件；邮箱地址拼写错误。2. 发送带附件或html内容的邮件需使用email模块的mime组件：html内容通过mimetext(content, 'html', 'utf-8')实现；附件需读取为二进制数据，用mimebase封装并base64编码，再通过content-disposition头设置为附件。3. 大批量发送邮件时应避免使用个人邮箱smtp服务，因其有频率和数量限制，易被封禁；建议采用专业邮件服务如sendgrid、阿里云邮件推送等以提高送达率；若自行发送，需控制频率、添加异常重试机制、记录日志并安全存储授权码（如使用环境变量）。使用python发送电子邮件的核心是smtplib与email模块协同工作，遵循此流程可实现稳定高效的邮件发送功能。

Python如何发送电子邮件？smtplib模块完整流程

使用Python发送电子邮件，核心在于利用其内置的

smtplib

登录后复制

模块来与邮件服务器进行通信，以及

email

登录后复制

模块来构建符合MIME标准的邮件内容。简单来说，就是通过代码模拟一个邮件客户端的行为：连接到服务器、登录、然后把准备好的邮件内容“投递”出去。这听起来有点像在邮局寄信，

smtplib

登录后复制

是邮递员，

email

登录后复制

模块则帮你把信封、信纸、照片（附件）都整理得妥妥当当。

解决方案

要用Python发送电子邮件，我们通常会经历以下几个步骤，这基本上是一个标准流程：

导入必要的模块：
```
smtplib
```
登录后复制
负责连接和发送，
```
email.mime.text.MIMEText
```
登录后复制
用于纯文本或HTML内容，
```
email.mime.multipart.MIMEMultipart
```
登录后复制
用于组合多部分邮件（如文本+附件），而
```
email.mime.base.MIMEBase
```
登录后复制
和
```
email.encoders
```
登录后复制
则用于处理附件。
配置邮件信息：包括发件人邮箱、收件人邮箱、邮件主题、邮件正文，以及SMTP服务器地址和端口。特别要注意的是，很多主流邮箱服务（如QQ邮箱、163邮箱、Gmail等）出于安全考虑，不再允许你直接使用登录密码进行SMTP认证，而是需要生成一个“授权码”或“应用专用密码”。这往往是新手最容易踩的坑。
构建邮件内容：使用
```
MIMEMultipart
```
登录后复制
对象作为邮件的“容器”，然后将文本、HTML内容（如果需要）或附件作为子部分添加到这个容器中。
建立SMTP连接：根据邮件服务器的要求，选择
```
smtplib.SMTP_SSL
```
登录后复制
（推荐，端口通常是465）进行SSL加密连接，或者
```
smtplib.SMTP
```
登录后复制
配合
```
starttls()
```
登录后复制
（端口通常是587）进行TLS加密。
登录邮件服务器：使用发件人邮箱和前面提到的授权码进行身份验证。
发送邮件：调用
```
send_message()
```
登录后复制
或
```
sendmail()
```
登录后复制
方法发送邮件。
关闭连接：发送完成后，记得调用
```
quit()
```
登录后复制
方法断开与服务器的连接，释放资源。

这是一个简单的代码示例，展示了如何发送一封纯文本邮件：

立即学习“Python免费学习笔记（深入）”；

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.header import Header

# --- 邮件配置信息 ---
sender_email = 'your_email@example.com'  # 发件人邮箱
sender_password = 'your_app_password'    # 发件人邮箱的授权码或应用专用密码
receiver_email = 'recipient@example.com' # 收件人邮箱
smtp_server = 'smtp.example.com'         # SMTP服务器地址 (例如：smtp.qq.com, smtp.163.com, smtp.gmail.com)
smtp_port = 465                          # SMTP服务器端口 (SSL通常是465，TLS通常是587)

# --- 构建邮件内容 ---
msg = MIMEMultipart()
msg['From'] = Header("发件人昵称", 'utf-8')
msg['To'] = Header("收件人昵称", 'utf-8')
msg['Subject'] = Header("Python邮件测试", 'utf-8')

# 邮件正文
mail_content = """
你好！

这是一封通过Python smtplib模块发送的测试邮件。
希望你能收到！

此致
敬礼
你的Python脚本
"""
msg.attach(MIMEText(mail_content, 'plain', 'utf-8'))

try:
    # --- 建立SMTP连接并发送邮件 ---
    # 对于SSL连接，使用SMTP_SSL
    server = smtplib.SMTP_SSL(smtp_server, smtp_port)
    # 如果是SMTP并需要starttls，则：
    # server = smtplib.SMTP(smtp_server, smtp_port)
    # server.ehlo()
    # server.starttls()
    # server.ehlo()

    server.login(sender_email, sender_password)
    server.send_message(msg) # 或者 server.sendmail(sender_email, receiver_email, msg.as_string())
    print("邮件发送成功！")

except smtplib.SMTPException as e:
    print(f"邮件发送失败: {e}")
except Exception as e:
    print(f"发生未知错误: {e}")
finally:
    if 'server' in locals() and server:
        server.quit()

登录后复制

为什么我的邮件总是发送失败？常见问题与排查

我刚开始接触Python邮件发送时，最头疼的就是邮件总是发不出去，报错信息也看得云里雾里。后来才发现，这其中有不少“坑”，但大部分都有迹可循。

一个最常见的问题就是授权码（或应用专用密码）的使用。很多邮箱服务，比如QQ邮箱、163邮箱、Gmail，为了账户安全，不允许第三方应用直接使用你的登录密码进行SMTP认证。你需要登录邮箱的网页版设置，找到“POP3/IMAP/SMTP服务”或者“客户端授权码”相关的选项，生成一个专门用于第三方客户端的授权码。这个授权码就是你在Python脚本里

server.login()

登录后复制

时要用的“密码”，而不是你平时登录邮箱的密码。这真是个让人头疼但又不得不面对的现实。

其次，SMTP服务器地址和端口配置错误也是常犯的错误。不同的邮箱服务商有不同的SMTP服务器地址（比如QQ邮箱是

smtp.qq.com

登录后复制

，163邮箱是

smtp.163.com

登录后复制

，Gmail是

smtp.gmail.com

登录后复制

）。端口也分两种主流：SSL加密通常用465，TLS加密通常用587。如果你选错了端口或者加密方式，连接自然会失败。有时候，你的网络环境或者防火墙也可能阻碍你连接到这些端口。

还有，发件人邮箱或收件人邮箱地址拼写错误，或者邮件内容被邮件服务商判定为垃圾邮件。后者尤其需要注意，如果你的邮件主题或内容过于简单、包含敏感词汇、或者发送频率过高，很可能直接被服务器拒绝或者被收件箱直接扔进垃圾箱。排查这类问题，可以先尝试发送一封最简单的纯文本邮件给自己，如果成功了，再逐步增加复杂性。

如何发送带附件、HTML内容的邮件？MIME的妙用

发送带附件或者HTML内容的邮件，就得请出

email

登录后复制

模块的MIME（Multipurpose Internet Mail Extensions）家族了。MIME这东西，听起来很技术，但其实就是个“打包盒”，它规定了邮件内容的各种类型和编码方式，让邮件客户端能够正确地解析和显示邮件。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

要发送HTML内容的邮件，你只需要把

MIMEText

登录后复制

的第二个参数从

'plain'

登录后复制

改成

'html'

登录后复制

就行了。比如：

MIMEText(html_content, 'html', 'utf-8')

登录后复制

。

而附件的处理则稍微复杂一些，但原理都是把附件文件读取成二进制数据，然后进行Base64编码，再封装成一个

MIMEBase

登录后复制

对象，最后添加到

MIMEMultipart

登录后复制

这个“主容器”里。你需要指定附件的文件名、MIME类型（比如图片是

image/jpeg

登录后复制

，PDF是

application/pdf

登录后复制

），以及一个

Content-Disposition

登录后复制

头，告诉邮件客户端这是一个附件。

import os
from email.mime.base import MIMEBase
from email import encoders

# ... (前面的邮件配置和MIMEMultipart初始化代码不变) ...

# 添加HTML内容
html_content = """
<html>
<body>
    <p>你好！</p>
    <p>这是一封<b>HTML格式</b>的邮件，来自Python脚本。</p>
    <p>希望你喜欢！</p>
    <img src="cid:image1.png" alt="Python Logo">
</body>
</html>
"""
msg.attach(MIMEText(html_content, 'html', 'utf-8'))

# 添加附件 (以一个图片文件为例)
# 假设当前目录下有一个 'example.png' 文件
file_path = 'example.png'
if os.path.exists(file_path):
    part = MIMEBase('application', 'octet-stream') # 通用二进制类型
    with open(file_path, 'rb') as file:
        part.set_payload(file.read())
    encoders.encode_base64(part) # 进行Base64编码

    # 设置附件的文件名，确保中文文件名显示正常
    encoded_filename = Header(os.path.basename(file_path), 'utf-8').encode()
    part.add_header('Content-Disposition', 'attachment', filename=encoded_filename)
    msg.attach(part)
else:
    print(f"警告：附件文件 '{file_path}' 不存在，将不发送附件。")

# 如果HTML中包含内联图片（cid:image1.png），需要单独添加
# from email.mime.image import MIMEImage
# with open('image1.png', 'rb') as img_file:
#     msg_image = MIMEImage(img_file.read())
#     msg_image.add_header('Content-ID', '<image1.png>') # 这里的ID要和HTML中的src="cid:..."对应
#     msg.attach(msg_image)

# ... (后面的SMTP连接和发送代码不变) ...

登录后复制

通过

MIMEMultipart

登录后复制

，你可以把文本、HTML、各种附件像搭积木一样组合起来，非常灵活。

大批量发送邮件需要注意什么？安全与效率考量

如果你需要通过Python发送大量的邮件，比如产品通知、营销邮件或者系统警报，那么使用个人邮箱的SMTP服务直接发送，很快就会遇到瓶颈，甚至可能导致你的邮箱被服务商暂时封禁。我之前有个项目需要发大量通知，一开始想着用自己的邮箱硬扛，结果没发几封就被封了。后来才意识到，专业的事还得专业工具来办。

首先，个人邮箱的SMTP服务通常有严格的发送频率和数量限制。你不可能指望通过一个个人邮箱一天发送几万封邮件。一旦触发了这些限制，你的邮件可能会被退回，甚至你的账户可能会被标记为垃圾邮件发送者。

其次，邮件送达率是个大问题。自己发送的邮件，很可能被收件方的垃圾邮件过滤器拦截，最终根本到不了用户的收件箱。专业的邮件服务提供商（ESP，Email Service Provider），比如SendGrid、Mailgun、或者国内的腾讯邮件推送、阿里云邮件推送等，它们有专门的IP信誉管理、反垃圾邮件机制和投递优化技术，能大大提高邮件的送达率。虽然它们通常是付费服务，但对于商业或大规模应用来说，这是非常值得的投资。

如果你确实需要自己处理，并且量不大，那么有几个点可以考虑：

控制发送频率：在发送每封邮件之间加入适当的
```
time.sleep()
```
登录后复制
，避免短时间内发送大量邮件。
异常处理和重试机制：网络波动、服务器临时故障都可能导致发送失败。为你的发送逻辑加上健壮的
```
try-except
```
登录后复制
块，并在失败时考虑重试几次。
日志记录：记录每封邮件的发送状态，包括成功、失败原因等，方便后续排查问题。
安全存储凭证：不要将你的邮箱授权码直接写死在代码里，尤其是在公共代码库中。考虑使用环境变量、配置文件或更安全的密钥管理服务来存储这些敏感信息。