如何确定Django文件型邮件后端中message参数的所属类？

我有C背景，这类类型问题在C里很好解决，但现在有点困惑。以下是Django文件型邮件后端（django.core.mail.backends.filebased.py）里的代码片段：

def write_message(self, message):
    self.stream.write(message.message().as_bytes() + b"\n")

我的问题是：怎么确定这里的message参数属于哪个类？

背景 #

我的代码通过不同路径发送邮件，调试和单元测试时想用Django的文件型后端，不想发真实邮件也不想自己实现文件存储。目前生产环境用的是MIMEMultipart对象（带UTF-8编码文本），运行正常，现在需要把它转成能被上面的代码正确输出的对象。

解答 #

1. message参数的类型 #

这个message参数是Django的django.core.mail.EmailMessage类（或其子类，比如EmailMultiAlternatives）的实例。

2. 验证结论的依据 #

• 从Django邮件系统的设计逻辑来看：所有邮件后端的send_messages方法接收的都是EmailMessage实例组成的列表，write_message是后端处理单个邮件的方法，因此参数必然属于这个类型体系。
• 从代码调用细节看：message.message()是EmailMessage类的核心方法，它会返回Python标准库email模块中的message.Message子类实例（比如你用到的MIMEMultipart），而as_bytes()正是这类标准库邮件对象的方法。

3. 把MIMEMultipart转成EmailMessage的方法 #

如果你已有现成的MIMEMultipart对象，只需将其包装为EmailMessage实例，就能被文件型后端正常处理：

from django.core.mail import EmailMessage

# 假设你已有的MIMEMultipart对象叫mimemsg
email_message = EmailMessage()
email_message._message = mimemsg

之后把这个email_message传给文件型后端的send_messages方法，或直接调用write_message，就能将邮件内容写入文件。

更推荐的做法是直接用Django的EmailMessage或EmailMultiAlternatives构造邮件，而非直接操作MIMEMultipart——这样生产和测试环境的代码可以统一，切换后端无需额外转换。比如创建带HTML和纯文本的邮件：

from django.core.mail import EmailMultiAlternatives

msg = EmailMultiAlternatives(
    subject="邮件标题",
    body="纯文本内容",
    from_email="sender@example.com",
    to=["recipient@example.com"],
)
msg.attach_alternative("<h1>HTML内容</h1>", "text/html")
# 直接发送，测试环境用文件后端，生产用SMTP后端
msg.send()

内容的提问来源于stack exchange，提问作者Dr Phil