如何用Python发送邮件？-Python教程-PHP中文网

答案：Python发送邮件需使用smtplib和email模块，通过SMTP服务器认证连接并构造邮件内容。首先配置发件人邮箱、授权码、收件人及服务器信息，利用MIMEText创建纯文本邮件，MIMEMultipart构建多部分邮件以添加附件或HTML内容，发送时启用TLS或SSL加密，并妥善处理异常。常见问题多为授权码错误、服务器端口配置不当或邮箱服务未开启，需逐一排查。

如何用python发送邮件？

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

smtplib

登录后复制

和

email

登录后复制

模块。

smtplib

登录后复制

负责连接邮件服务器并发送邮件，而

email

登录后复制

模块则用来构造邮件的各种内容，比如正文、附件、HTML格式等。理解这两者的协同工作，就能高效、灵活地实现邮件的自动化发送。

解决方案发送一封最基础的纯文本邮件，我们需要几个关键步骤。这通常是我开始一个新邮件自动化项目时的起点，简单直接，能快速验证连接和认证是否成功。

首先，导入必要的模块：

smtplib

登录后复制

用于SMTP协议交互，

email.mime.text.MIMEText

登录后复制

用于创建文本邮件体。

import smtplib
from email.mime.text import MIMEText
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.gmail.com, smtp.qq.com
smtp_port = 587                          # SMTP服务器端口，SSL通常是465，TLS通常是587

# 邮件内容
subject = 'Python发送测试邮件'
body = '你好！这是一封由Python脚本发送的测试邮件。'

# 构建MIMEText对象
msg = MIMEText(body, 'plain', 'utf-8')
msg['From'] = Header(f'发件人名称 <{sender_email}>', 'utf-8')
msg['To'] = Header(f'收件人名称 <{receiver_email}>', 'utf-8')
msg['Subject'] = Header(subject, 'utf-8')

try:
    # 连接SMTP服务器
    # 对于TLS加密，使用starttls()
    server = smtplib.SMTP(smtp_server, smtp_port)
    server.starttls() # 启动TLS加密

    # 登录邮箱
    server.login(sender_email, sender_password)

    # 发送邮件
    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() # 关闭连接

登录后复制

这里需要特别注意的是

sender_password

登录后复制

。出于安全考虑，大多数主流邮箱服务（如Gmail、QQ邮箱、Outlook等）都推荐使用授权码而非你的账户主密码。授权码是专门为第三方应用生成的一次性或应用专用密码，即使泄露也不会直接影响你的主账户安全。获取授权码的方法通常在邮箱的“设置”->“账户”->“POP3/IMAP/SMTP服务”或“客户端授权码”部分。

Python发送带附件的邮件怎么实现？在实际应用中，纯文本邮件往往不够用，我们经常需要发送带有文件附件的邮件。这比纯文本邮件稍微复杂一点，但

email

登录后复制

模块提供了非常强大的工具来处理。我的经验是，一旦你掌握了

MIMEMultipart

登录后复制

，处理附件就变得非常直观了。

要发送带附件的邮件，我们需要使用

email.mime.multipart.MIMEMultipart

登录后复制

来创建一个多部分邮件体，然后将文本内容和附件作为不同的部分添加到这个邮件体中。

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

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
from email.header import Header
import os

sender_email = 'your_email@example.com'
sender_password = 'your_app_password'
receiver_email = 'recipient@example.com'
smtp_server = 'smtp.example.com'
smtp_port = 587

subject = '带附件的Python测试邮件'
body = '你好！这是一封带附件的Python测试邮件。请查收附件。'
attachment_path = 'path/to/your/file.pdf' # 附件的完整路径

# 创建MIMEMultipart对象，用于组合邮件正文和附件
msg = MIMEMultipart()
msg['From'] = Header(f'发件人名称 <{sender_email}>', 'utf-8')
msg['To'] = Header(f'收件人名称 <{receiver_email}>', 'utf-8')
msg['Subject'] = Header(subject, 'utf-8')

# 添加邮件正文
msg.attach(MIMEText(body, 'plain', 'utf-8'))

# 添加附件
if os.path.exists(attachment_path):
    try:
        with open(attachment_path, 'rb') as f:
            # 创建MIMEBase对象，用于表示附件
            part = MIMEBase('application', 'octet-stream')
            part.set_payload(f.read())

        # 对附件进行Base64编码
        encoders.encode_base64(part)

        # 设置附件的文件名，确保中文文件名能正确显示
        file_name = os.path.basename(attachment_path)
        part.add_header('Content-Disposition', 'attachment', filename=(Header(file_name, 'utf-8').encode()))

        msg.attach(part)
        print(f"附件 '{file_name}' 添加成功。")
    except FileNotFoundError:
        print(f"错误：附件文件 '{attachment_path}' 未找到。")
    except Exception as e:
        print(f"添加附件时发生错误: {e}")
else:
    print(f"警告：附件文件 '{attachment_path}' 不存在，邮件将不包含此附件。")


try:
    server = smtplib.SMTP(smtp_server, smtp_port)
    server.starttls()
    server.login(sender_email, sender_password)
    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()

登录后复制

这里需要注意

MIMEBase('application', 'octet-stream')

登录后复制

的使用，它是一个通用的二进制流类型。

encoders.encode_base64(part)

登录后复制

是邮件协议中对二进制数据进行编码的标准方式。最重要的是

Content-Disposition

登录后复制

头，它告诉邮件客户端这是一个附件，并且指定了附件的文件名。对于中文文件名，使用

Header(file_name, 'utf-8').encode()

登录后复制

可以确保其正确显示。

如知AI笔记

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

查看详情

如何用Python发送HTML格式的邮件？现代邮件客户端对HTML格式的支持非常普遍，发送HTML邮件能让你的内容更具吸引力，可以包含图片、链接、排版等。我个人在发送报告、通知或营销邮件时，几乎总是倾向于使用HTML格式。

发送HTML邮件与发送纯文本邮件类似，只是在创建

MIMEText

登录后复制

对象时，需要将

_subtype

登录后复制

参数设置为

'html'

登录后复制

。如果你想提供一个纯文本的备用版本（这是一个好的实践，以防某些老旧的邮件客户端不支持HTML），你可以将纯文本和HTML版本都添加到

MIMEMultipart

登录后复制

中。

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_port = 587

subject = 'Python发送HTML格式邮件'

# HTML邮件内容
html_body = """\
<html>
  <head></head>
  <body>
    <p>你好！</p>
    <p>这是一封由Python脚本发送的<b>HTML格式</b>测试邮件。</p>
    <p>你可以点击这里访问我的<a href="https://example.com">网站</a>。</p>
    <img src="https://via.placeholder.com/150" alt="Placeholder Image">
    <p>祝好！</p>
  </body>
</html>
"""

# 纯文本备用内容
text_body = "你好！这是一封由Python脚本发送的HTML格式测试邮件。\n请访问我的网站：https://example.com"

# 创建MIMEMultipart对象，用于组合纯文本和HTML版本
msg = MIMEMultipart('alternative') # 'alternative'表示这些部分是同一内容的替代表示
msg['From'] = Header(f'发件人名称 <{sender_email}>', 'utf-8')
msg['To'] = Header(f'收件人名称 <{receiver_email}>', 'utf-8')
msg['Subject'] = Header(subject, 'utf-8')

# 添加纯文本部分
msg.attach(MIMEText(text_body, 'plain', 'utf-8'))

# 添加HTML部分
msg.attach(MIMEText(html_body, 'html', 'utf-8'))

try:
    server = smtplib.SMTP(smtp_server, smtp_port)
    server.starttls()
    server.login(sender_email, sender_password)
    server.sendmail(sender_email, receiver_email, msg.as_string())
    print('HTML格式邮件发送成功！')
except smtplib.SMTPException as e:
    print(f'邮件发送失败: {e}')
except Exception as e:
    print(f'发生未知错误: {e}')
finally:
    if 'server' in locals() and server:
        server.quit()

登录后复制

这里关键是

MIMEMultipart('alternative')

登录后复制

，它告诉邮件客户端，这些附件（纯文本和HTML）是同一个内容的替代版本，客户端会选择它最能理解的版本来显示。通常，邮件客户端会优先显示HTML版本。在HTML邮件中嵌入图片，如果图片是外部链接，直接在

<img>

登录后复制

标签中引用即可；如果是本地图片，则需要将其作为附件嵌入，并在HTML中通过

cid:

登录后复制

（Content-ID）引用，这会稍微复杂一些，涉及到

email.mime.image.MIMEImage

登录后复制

和

Content-ID

登录后复制

头的设置。

Python发送邮件，遇到身份验证失败怎么办？身份验证失败是我在自动化邮件脚本开发中最常遇到的问题之一。它往往不是代码逻辑错误，而是配置或安全策略上的问题。遇到这类问题，首先不要慌，一步步排查通常都能解决。

检查用户名和密码（授权码）：这是最基本也最容易出错的地方。确保
```
sender_email
```
登录后复制
和
```
sender_password
```
登录后复制
完全正确。对于主流邮箱，几乎总是需要使用授权码，而不是你的账户主密码。很多新手会直接填主密码，导致认证失败。例如，Gmail的授权码需要在Google账户安全设置中生成，QQ邮箱和163邮箱也有类似设置。
SMTP服务器地址和端口：
```
smtp_server
```
登录后复制
和
```
smtp_port
```
登录后复制
必须与你的邮箱服务商提供的完全一致。常见的组合是：
- Gmail:
```
smtp.gmail.com
```
  登录后复制
  , 端口587 (TLS) 或 465 (SSL)
- QQ邮箱:
```
smtp.qq.com
```
  登录后复制
  , 端口465 (SSL) 或 587 (TLS)
- Outlook/Hotmail:
```
smtp.office365.com
```
  登录后复制
  , 端口587 (TLS)
- 163邮箱:
```
smtp.163.com
```
  登录后复制
  , 端口465 (SSL) 或 994 (SSL) 确保你的代码中
```
server = smtplib.SMTP(smtp_server, smtp_port)
```
  登录后复制
  或
```
smtplib.SMTP_SSL(smtp_server, smtp_port)
```
  登录后复制
  与端口和加密方式匹配。
加密方式：
- 如果端口是587，通常需要调用
```
server.starttls()
```
  登录后复制
  来启动TLS加密。
- 如果端口是465，则应该使用
```
smtplib.SMTP_SSL()
```
  登录后复制
  来建立连接，它默认使用SSL加密，无需再调用
```
starttls()
```
  登录后复制
  。混淆这两种方式会导致连接或认证失败。
邮箱账户设置：有些邮箱服务默认关闭了SMTP/POP3/IMAP服务，或者有“客户端授权”之类的选项需要手动开启。例如，Gmail账户可能需要开启“允许不够安全的应用访问”或生成应用专用密码。QQ邮箱需要开启IMAP/SMTP服务并生成授权码。
网络或防火墙：极少数情况下，公司的网络策略或个人防火墙可能会阻止对SMTP端口的访问。可以尝试在其他网络环境下测试，或者检查防火墙设置。
错误信息：仔细阅读Python抛出的
```
smtplib.SMTPAuthenticationError
```
登录后复制
或
```
smtplib.SMTPException
```
登录后复制
的详细信息。它通常会告诉你失败的具体原因，比如“Authentication failed”或“535 Authentication failed”。这些信息是排查问题的关键线索。