用python发邮件如何添加附件

用Python发邮件可以通过多个库和方法实现，常用的方法包括使用smtplib库来发送邮件以及email库来处理邮件内容、添加附件。 其中，smtplib库负责连接到邮件服务器并发送邮件，而email库则用于创建带有附件的邮件内容。本文将详细介绍如何使用这两个库来发送带有附件的电子邮件。

一、使用smtplib库和email库发送邮件

使用smtplib库和email库发送邮件是最常见的方法。以下是具体步骤：

连接到SMTP服务器：使用smtplib.SMTP或smtplib.SMTP_SSL连接到邮件服务器。
创建邮件内容：使用email库创建邮件内容，包括主题、正文和附件。
发送邮件：使用SMTP对象的sendmail方法发送邮件。

连接到SMTP服务器

首先，我们需要连接到SMTP服务器。例如，对于Gmail的SMTP服务器，我们可以使用以下代码：

import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders
设置SMTP服务器和端口号
smtp_server = 'smtp.gmail.com'
smtp_port = 587
发件人邮箱和密码
sender_email = 'your_email@gmail.com'
password = 'your_password'
收件人邮箱
receiver_email = 'receiver_email@example.com'
创建SMTP对象并连接到服务器
server = smtplib.SMTP(smtp_server, smtp_port)
server.starttls()  # 启用安全传输模式
server.login(sender_email, password)

创建邮件内容

接下来，我们使用email库来创建邮件内容，包括主题、正文和附件。

# 创建MIMEMultipart对象
msg = MIMEMultipart()
设置邮件主题、发件人和收件人
msg['From'] = sender_email
msg['To'] = receiver_email
msg['Subject'] = '邮件主题'
添加邮件正文
body = '这是邮件正文'
msg.attach(MIMEText(body, 'plain'))
添加附件
filename = 'example.txt'
attachment = open(filename, 'rb')
创建MIMEBase对象并设置内容类型
part = MIMEBase('application', 'octet-stream')
part.set_payload(attachment.read())
encoders.encode_base64(part)
part.add_header('Content-Disposition', f'attachment; filename= {filename}')
将附件添加到MIMEMultipart对象
msg.attach(part)

发送邮件

最后，我们使用SMTP对象的sendmail方法发送邮件。

# 发送邮件
server.sendmail(sender_email, receiver_email, msg.as_string())
关闭连接
server.quit()

二、使用yagmail库发送邮件

yagmail库是一个更简单、易于使用的Python库，用于发送电子邮件。它封装了smtplib和email库，使发送邮件变得更加简单。

首先，安装yagmail库：

pip install yagmail

然后，使用以下代码发送带有附件的电子邮件：

import yagmail
发件人邮箱和密码
sender_email = 'your_email@gmail.com'
password = 'your_password'
收件人邮箱
receiver_email = 'receiver_email@example.com'
邮件主题和正文
subject = '邮件主题'
body = '这是邮件正文'
附件文件名
filename = 'example.txt'
创建yagmail.SMTP对象并发送邮件
yag = yagmail.SMTP(sender_email, password)
yag.send(to=receiver_email, subject=subject, contents=body, attachments=filename)

三、使用第三方服务发送邮件

除了使用smtplib库和email库发送邮件，我们还可以使用第三方邮件服务（如SendGrid、Mailgun）发送邮件。这些服务通常提供API，支持通过HTTP请求发送邮件。

以下是使用SendGrid发送带有附件的邮件的示例：

首先，安装sendgrid库：

pip install sendgrid

然后，使用以下代码发送邮件：

import os
from sendgrid import SendGridAPIClient
from sendgrid.helpers.mail import Mail, Attachment, FileContent, FileName, FileType, Disposition
发件人邮箱
sender_email = 'your_email@example.com'
收件人邮箱
receiver_email = 'receiver_email@example.com'
邮件主题和正文
subject = '邮件主题'
body = '这是邮件正文'
附件文件名
filename = 'example.txt'
with open(filename, 'rb') as f:
    file_data = f.read()
    file_b64 = base64.b64encode(file_data).decode()
创建邮件对象
message = Mail(
    from_email=sender_email,
    to_emails=receiver_email,
    subject=subject,
    plain_text_content=body)
创建附件对象
attachment = Attachment(
    FileContent(file_b64),
    FileName(filename),
    FileType('application/octet-stream'),
    Disposition('attachment')
)
将附件添加到邮件对象
message.attachment = attachment
发送邮件
sg = SendGridAPIClient(os.environ.get('SENDGRID_API_KEY'))
response = sg.send(message)
print(response.status_code, response.body, response.headers)

四、使用SMTP服务器的配置注意事项

在使用SMTP服务器发送邮件时，需要注意以下几点：

SMTP服务器地址和端口：不同的邮件服务提供商有不同的SMTP服务器地址和端口。例如，Gmail的SMTP服务器地址是smtp.gmail.com，端口是587（TLS）或465（SSL）。
发件人邮箱和密码：确保正确填写发件人邮箱和密码。对于某些服务提供商（如Gmail），可能需要使用应用专用密码。
安全传输模式：大多数SMTP服务器要求使用TLS或SSL加密传输。使用starttls方法启用TLS加密，或者直接使用smtplib.SMTP_SSL连接到服务器。
防止垃圾邮件：为了防止被邮件服务提供商标记为垃圾邮件，请确保邮件内容和标题合理，避免发送大量重复邮件。

五、使用HTML格式发送邮件

除了发送纯文本邮件，我们还可以发送HTML格式的邮件。以下是发送HTML邮件的示例：

# 创建MIMEMultipart对象
msg = MIMEMultipart('alternative')
设置邮件主题、发件人和收件人
msg['From'] = sender_email
msg['To'] = receiver_email
msg['Subject'] = 'HTML邮件主题'
创建HTML内容
html = '''
<html>
  <body>
    <h1>这是HTML邮件</h1>
    <p>这是邮件正文的第一段。</p>
    <p>这是邮件正文的第二段。</p>
  </body>
</html>
'''
添加HTML内容到邮件对象
msg.attach(MIMEText(html, 'html'))
发送邮件
server.sendmail(sender_email, receiver_email, msg.as_string())

六、发送带有多个附件的邮件

如果需要发送带有多个附件的邮件，可以多次调用attach方法添加附件。以下是发送带有多个附件的示例：

# 创建MIMEMultipart对象
msg = MIMEMultipart()
设置邮件主题、发件人和收件人
msg['From'] = sender_email
msg['To'] = receiver_email
msg['Subject'] = '带有多个附件的邮件'
添加邮件正文
body = '这是邮件正文'
msg.attach(MIMEText(body, 'plain'))
添加第一个附件
filename1 = 'example1.txt'
attachment1 = open(filename1, 'rb')
part1 = MIMEBase('application', 'octet-stream')
part1.set_payload(attachment1.read())
encoders.encode_base64(part1)
part1.add_header('Content-Disposition', f'attachment; filename= {filename1}')
msg.attach(part1)
添加第二个附件
filename2 = 'example2.txt'
attachment2 = open(filename2, 'rb')
part2 = MIMEBase('application', 'octet-stream')
part2.set_payload(attachment2.read())
encoders.encode_base64(part2)
part2.add_header('Content-Disposition', f'attachment; filename= {filename2}')
msg.attach(part2)
发送邮件
server.sendmail(sender_email, receiver_email, msg.as_string())
关闭连接
server.quit()

七、处理常见错误和异常

在发送邮件过程中，可能会遇到一些错误和异常。例如，认证失败、服务器连接失败等。以下是一些常见错误的处理方法：

认证失败：确保发件人邮箱和密码正确。如果使用Gmail，可能需要启用“允许不太安全的应用”或使用应用专用密码。
服务器连接失败：检查SMTP服务器地址和端口是否正确，确保网络连接正常。
附件大小限制：大多数邮件服务提供商对邮件大小有一定限制，通常在20-25MB之间。对于较大的附件，可以考虑使用云存储服务（如Google Drive、Dropbox）并在邮件中提供下载链接。

以下是处理常见错误的示例代码：

try:
    # 连接到SMTP服务器
    server = smtplib.SMTP(smtp_server, smtp_port)
    server.starttls()
    server.login(sender_email, password)
    # 发送邮件
    server.sendmail(sender_email, receiver_email, msg.as_string())
except smtplib.SMTPAuthenticationError:
    print('认证失败，请检查邮箱和密码是否正确')
except smtplib.SMTPConnectError:
    print('无法连接到SMTP服务器，请检查服务器地址和端口')
except smtplib.SMTPException as e:
    print(f'发送邮件时发生错误：{e}')
finally:
    # 关闭连接
    server.quit()

总结

通过本文的介绍，我们学习了如何使用Python发送带有附件的电子邮件。我们介绍了使用smtplib库和email库的基本方法，以及使用yagmail库和第三方邮件服务（如SendGrid）的简化方法。同时，我们还讨论了发送HTML格式邮件、发送多个附件以及处理常见错误和异常的方法。希望这些内容能帮助你更好地掌握Python发送邮件的技巧，并在实际应用中灵活运用。