正确处理Python邮件附件文件名中的空格

花韻仙語

发布时间：2025-10-13 13:36:42

374人浏览过

来源于php中文网

原创

正确处理python邮件附件文件名中的空格

本文旨在解决在使用Python发送邮件时，附件文件名包含空格导致的问题。通过修改`Content-Disposition`头部，确保接收方正确识别并显示包含空格的文件名，同时避免文件名中出现`%20`等编码字符。本文提供详细的代码示例和解决方案，帮助开发者轻松处理此类问题。

在使用Python的email库发送带有附件的邮件时，如果附件的文件名包含空格，可能会遇到接收方显示的文件名不正确的问题。常见的情况是，文件名中的空格被截断，或者空格被替换为%20等编码字符，影响用户体验。本文将介绍如何正确处理包含空格的文件名，确保接收方能够正确识别和下载附件。

问题分析

问题的根源在于Content-Disposition头部字段的格式。该字段用于指定附件的处理方式，包括文件名。当文件名包含空格时，如果不进行适当的转义或引用，可能会导致解析错误。

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

解决方案

解决此问题的关键在于使用双引号将文件名括起来。这样可以确保即使文件名中包含空格，也能被正确解析。

代码示例

铁通无线固话号码销售站

一个经典的号码销售网站，操作非常方便。可用于销售手机号码、固话号码，也可以直接修改为QQ销售平台。程序采用jmail提交订单，如果采用本程序，请先检查空间是否安装jmail组件。 1、管理信息后台 /admin 用户名 admin 密码 admin888 2、需要设置的信息宽带安装信息设置在email.asp文件中找到以下内容修改成正确的信息即可。 strEmail = "

下载

下面是修改后的代码片段，展示了如何使用双引号来处理文件名中的空格：

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

def prepare_attachment(filepath):
    filename = os.path.basename(filepath)
    attachment = open(filepath, "rb")

    # instance of MIMEBase and named as p
    p = MIMEBase('application', 'octet-stream')

    # To change the payload into encoded form.
    p.set_payload((attachment).read())

    # encode into base64
    encoders.encode_base64(p)

    # 使用双引号将文件名括起来
    p.add_header('Content-Disposition', 'attachment; filename="%s"' % filename)

    return p


class Sender(object):

    def __init__(self, sender_email, sender_password, recipient_email, attachments):
        self.sender_email = sender_email
        self.sender_password = sender_password
        self.recipient_email = recipient_email
        self.attachments = attachments

    def send(self):
        msg = MIMEMultipart()
        msg['From'] = self.sender_email
        msg['To'] = self.recipient_email
        msg['Subject'] = "Email with attachments"

        body = "This is the email body"
        msg.attach(MIMEText(body, 'plain'))

        # open the file to be sent
        for attachment in self.attachments:

            p = prepare_attachment(attachment)

            # attach the instance 'p' to instance 'msg'
            msg.attach(p)

        # creates SMTP session
        s = smtplib.SMTP('smtp.gmail.com', 587)

        # start TLS for security
        s.starttls()

        # Authentication
        s.login(self.sender_email, self.sender_password)

        # Converts the Multipart msg into a string
        text = msg.as_string()

        # sending the mail
        s.sendmail(self.sender_email, self.recipient_email, text)

        # terminating the session
        s.quit()


# 示例用法
if __name__ == '__main__':
    sender_email = "your_email@gmail.com"  # 你的邮箱地址
    sender_password = "your_password"  # 你的邮箱密码
    recipient_email = "recipient_email@example.com"  # 收件人邮箱地址
    attachments = ["my attachment.pdf", "another file with spaces.txt"]  # 附件列表

    sender = Sender(sender_email, sender_password, recipient_email, attachments)
    sender.send()

代码解释

在prepare_attachment函数中，p.add_header('Content-Disposition', 'attachment; filename="%s"' % filename)这行代码是关键。它将文件名用双引号括起来，确保Content-Disposition头部能够正确解析包含空格的文件名。

注意事项