Python邮箱API发送邮件时，如何添加附件并设置其属性？

在Python中，我们通常使用内置的smtplib库和email模块来发送电子邮件。当我们需要向邮件中添加附件时，我们需要构建一个MIME（多用途互联网邮件扩展）消息，以便在邮件中包含非文本内容。MIME消息允许我们将不同的数据类型（如文本、图像、音频和视频）嵌入到电子邮件中。

下面是一个详细的步骤指南，介绍如何在Python中使用邮箱API发送带有附件的电子邮件，并设置附件的属性。

一、设置邮件服务器和SMTP连接

首先，我们需要设置邮件服务器的信息，并使用smtplib库建立与SMTP服务器的连接。SMTP（简单邮件传输协议）是用于发送电子邮件的协议。

python

import smtplib

from email.mime.multipart import MIMEMultipart

from email.mime.base import MIMEBase

from email.mime.text import MIMEText

from email.utils import formatdate

from email import encoders

# 邮件服务器设置

smtp_server = 'smtp.example.com'

smtp_port = 587  # 通常用于TLS加密的端口

smtp_username = 'your-email@example.com'

smtp_password = 'your-password'

# 连接到SMTP服务器

server = smtplib.SMTP(smtp_server, smtp_port)

server.starttls()  # 启用TLS加密

server.login(smtp_username, smtp_password)

二、创建邮件消息

接下来，我们将创建一个MIME多部分消息，该消息将包含文本部分和附件部分。

python

# 创建邮件对象

msg = MIMEMultipart()

msg['From'] = smtp_username

msg['To'] = 'recipient@example.com'

msg['Date'] = formatdate(localtime=True)

msg['Subject'] = 'Email with attachment'

# 添加邮件正文

body = 'This is the email body with an attached file.'

msg.attach(MIMEText(body, 'plain'))

三、添加附件

要添加附件，我们需要创建一个MIMEBase对象，并使用encoders模块中的函数将其编码为可传输的格式。然后，我们将这个对象添加到邮件消息中。

python

# 读取附件文件

with open('attachment.pdf', 'rb') as f:

part = MIMEBase('application', 'octet-stream')  # 通用二进制数据

part.set_payload(f.read())

 红帽云邮邮件群发系统99%送达率（查看：邮件群发价格） 

 定制开发邮件系统多ip多域名轮播（咨询：定制价格） 

# 编码附件并设置Content-Transfer-Encoding头部

encoders.encode_base64(part)

# 设置附件的文件名和描述性信息（可选）

part.add_header('Content-Disposition', 'attachment', filename='attachment.pdf')

part.add_header('Content-ID', '<00001>')  # 可以设置一个唯一的Content-ID

part.add_header('Content-Description', 'A PDF attachment')  # 附件的描述性文本

# 将附件添加到邮件消息中

msg.attach(part)

在上面的代码中，我们首先使用open函数以二进制模式（'rb'）打开附件文件。然后，我们创建一个MIMEBase对象，并指定MIME类型为application/octet-stream，这是一个通用的二进制数据类型。接下来，我们使用set_payload方法将文件内容设置为MIME对象的负载。

然后，我们使用encoders.encode_base64函数对MIME对象进行Base64编码，这是SMTP服务器要求的格式。我们还需要使用add_header方法设置一些额外的头部信息，如Content-Disposition（指定附件的文件名和如何显示它）、Content-ID（一个可选的唯一标识符）和Content-Description（附件的描述性文本）。

最后，我们将编码并设置头部后的MIME对象添加到邮件消息中。

四、发送邮件并关闭连接

现在我们已经构建了完整的邮件消息，包括文本正文和附件。我们可以使用SMTP服务器的sendmail方法发送邮件。

python

# 发送邮件

text = msg.as_string()

server.sendmail(smtp_username, 'recipient@example.com', text)

# 关闭SMTP连接

server.quit()

在上面的代码中，我们使用as_string方法将邮件消息对象转换为字符串格式，然后将其传递给sendmail方法。sendmail方法需要三个参数：发件人地址、收件人地址和邮件消息的字符串表示形式。最后，我们使用quit方法关闭与SMTP服务器的连接。

五、总结

在Python中发送带有附件的电子邮件需要一些额外的步骤来构建MIME多部分消息并处理附件文件。但是，通过使用`smtplib和email模块，我们可以轻松地实现这一功能。

---