本文详细介绍了如何使用Python的`imaplib`库在Gmail中创建HTML格式的邮件草稿。通过在邮件消息对象中正确设置`Content-Type`头部为`text/html;charset=UTF-8`，您可以确保邮件内容以富文本形式而非纯文本字面量显示，从而实现更美观和功能丰富的邮件草稿创建。
引言
在使用Python通过IMAP协议与邮件服务器交互时，一个常见的需求是创建包含富文本（HTML）内容的邮件草稿。然而，许多开发者在尝试将HTML字符串作为邮件正文时，发现草稿邮件中HTML标签被原样显示，而非被渲染成预期的格式。这通常是因为邮件客户端（如Gmail）未能正确识别邮件内容的类型。本文将深入探讨如何解决这一问题，并提供一个使用imaplib库在Gmail中创建HTML邮件草稿的实用教程。
理解问题：纯文本与HTML的区分
默认情况下，当您使用email.message.Message对象构建邮件并将其内容附加到IMAP服务器时，如果没有明确指定内容的MIME类型，邮件客户端会将其视为纯文本（text/plain）。这意味着任何HTML标签（如、、 等）都会被当作普通字符处理，导致它们在邮件中直接显示，而不是被浏览器或邮件客户端解析。 以下是原始代码片段，它创建了纯文本草稿，并导致HTML标签被字面显示： 立即学习“Python免费学习笔记（深入）”； 运行上述代码后，在Gmail草稿箱中看到的将是：这是一封包含 链接 的邮件正文，而不是一个可点击的“链接”。 要让邮件客户端正确解析HTML内容，关键在于在邮件头部中明确声明内容的MIME类型。对于HTML邮件，这意味着需要设置Content-Type头部为text/html，并指定字符编码（通常是UTF-8）。 通过在email.message.Message对象中添加一行代码，即可实现这一目标： 这行代码会告诉邮件客户端，邮件的负载（payload）部分应该被解释为HTML文档，而不是纯文本。 下面是一个完整的Python脚本，演示了如何使用imaplib在Gmail中创建HTML格式的邮件草稿： 您好， 这是一封由 Python 和 它包含一个 Python官网链接。 祝您工作愉快！ 代码说明：from email.message import Message
import imaplib
import time
# 假设 imap_ssl 已经是一个连接到IMAP服务器的SSL对象
# imap_ssl = imaplib.IMAP4_SSL("imap.gmail.com")
# imap_ssl.login("your_email@example.com", "your_app_password")
message = Message()
# 创建消息
message["To"] = "recipient@example.com"
message["Subject"] = "测试主题"
message.set_payload("这是一封包含 链接 的邮件正文")
utf8_message = str(message).encode("utf-8")
# 发送消息到草稿箱
# status, data = imap_ssl.append('"[Google Mail]/Drafts"', "", imaplib.Time2Internaldate(time.time()), utf8_message)
# print(f"Status: {status}, Data: {data}")解决方案：设置Content-Type头部
message["Content-Type"] = "text/html;charset=UTF-8"
完整的HTML邮件草稿创建示例
from email.message import Message
import imaplib
import time
import ssl
def create_html_gmail_draft(username, app_password, recipient_email, subject, html_body):
"""
使用Python的imaplib库在Gmail中创建HTML邮件草稿。
Args:
username (str): Gmail邮箱地址。
app_password (str): Gmail应用专用密码。
recipient_email (str): 收件人邮箱地址。
subject (str): 邮件主题。
html_body (str): 邮件HTML正文内容。
"""
imap_server = "imap.gmail.com"
imap_port = 993
try:
# 连接到IMAP服务器
# 对于Gmail，通常使用SSL/TLS加密连接
context = ssl.create_default_context()
imap_ssl = imaplib.IMAP4_SSL(imap_server, imap_port, ssl_context=context)
# 登录到Gmail账户
imap_ssl.login(username, app_password)
print(f"成功登录到 {username}")
# 创建邮件消息对象
message = Message()
message["To"] = recipient_email
message["Subject"] = subject
# !!! 关键步骤：设置Content-Type头部为text/html
message["Content-Type"] = "text/html;charset=UTF-8"
message.set_payload(html_body)
# 将Message对象转换为字符串并编码为UTF-8字节流
# imaplib.append 需要字节流作为邮件内容
utf8_message = str(message).encode("utf-8")
# 将邮件附加到Gmail的草稿箱
# "[Google Mail]/Drafts" 是Gmail草稿箱的IMAP路径
# "" 表示没有特殊的邮件标志
# imaplib.Time2Internaldate(time.time()) 设置内部日期
status, data = imap_ssl.append('"[Google Mail]/Drafts"', "", imaplib.Time2Internaldate(time.time()), utf8_message)
if status == 'OK':
print(f"HTML邮件草稿已成功创建。状态: {status}, 数据: {data}")
else:
print(f"创建HTML邮件草稿失败。状态: {status}, 数据: {data}")
except imaplib.IMAP4.error as e:
print(f"IMAP错误: {e}")
except Exception as e:
print(f"发生未知错误: {e}")
finally:
# 登出IMAP服务器
if 'imap_ssl' in locals() and imap_ssl.state == 'AUTH':
imap_ssl.logout()
print("已登出IMAP服务器。")
# --- 使用示例 ---
if __name__ == "__main__":
# 请替换为您的Gmail账户信息和应用专用密码
GMAIL_USERNAME = "your_gmail_account@gmail.com"
GMAIL_APP_PASSWORD = "your_generated_app_password" # 访问Google账户安全设置生成
# 邮件内容
RECIPIENT = "target@example.com"
SUBJECT = "Python创建的HTML草稿邮件"
HTML_BODY = """
imaplib 创建的 HTML 邮件草稿。
注意事项与最佳实践
