本文详细介绍了如何使用Python的`imaplib`库在Gmail中创建显示为HTML格式的邮件草稿。针对默认创建的草稿显示为纯文本HTML标签的问题，核心解决方案是为邮件消息添加`Content-Type: text/html;charset=UTF-8`头部。教程通过代码示例演示了如何正确设置MIME类型，确保HTML内容能够被Gmail客户端正确解析和渲染，从而实现预期的富文本显示效果，提升邮件草稿的用户体验和专业性。
引言：使用Python在Gmail中创建HTML邮件草稿的挑战
在使用Python通过imaplib库向Gmail的草稿箱追加邮件时，一个常见的需求是创建包含HTML内容的邮件草稿，使其能够被Gmail客户端正确渲染为富文本格式，而非直接显示HTML标签。默认情况下，如果仅将HTML字符串作为邮件内容，Gmail会将其识别为纯文本，导致诸如<a>标签等被原样显示，而非呈现为可点击的https://www.php.cn/link/8f1dd6e7a88b9cf615c146330c591ba9。本文将深入探讨这一问题，并提供一个简洁有效的解决方案。
问题分析：纯文本与HTML内容的识别
当使用email.message.Message对象构建邮件，并通过imaplib.append方法将其追加到Gmail草稿箱时，如果不明确指定邮件内容的类型，Gmail通常会将其识别为text/plain。这意味着即使邮件负载（payload）中包含HTML标签，邮件客户端也会将其视为普通文本字符来显示。
例如，以下代码片段尝试创建一个带有https://www.php.cn/link/8f1dd6e7a88b9cf615c146330c591ba9的邮件草稿：
立即学习“Python免费学习笔记（深入）”；
from email.message import Message
import imaplib
import time
import ssl # 导入ssl模块用于IMAP SSL连接
# 假设 imap_ssl 已经是一个建立好的IMAPSSL连接对象
# imap_ssl = imaplib.IMAP4_SSL("imap.gmail.com", port=993)
# imap_ssl.login("your_email@gmail.com", "your_app_password")
message = Message()
message["To"] = "recipient@example.com"
message["Subject"] = "Subject line with HTML attempt"
message.set_payload("This is the email <a href='#'>body</a> with a link.")
utf8_message = str(message).encode("utf-8")
# 假设imap_ssl已连接并登录
# status, data = imap_ssl.append('"[Google Mail]/Drafts"', "", imaplib.Time2Internaldate(time.time()), utf8_message)
# print(f"Append status: {status}, data: {data}")这段代码在Gmail中创建的草稿会显示为：This is the email <a href='#'>body</a> with a link.，而不是预期的“This is the email body”效果。
解决方案：明确指定Content-Type头部
要解决此问题，关键在于告知邮件客户端（Gmail）邮件内容的实际类型。这通过在邮件消息中添加Content-Type头部来实现。对于HTML内容，我们应将其设置为text/html;charset=UTF-8。
Content-Type头部是一个标准的MIME（Multipurpose Internet Mail Extensions）头部，它指示了邮件体或邮件体某个部分的媒体类型。
- text/html：声明内容是HTML格式的文本。
- charset=UTF-8：指定内容的字符编码为UTF-8，确保各种语言字符都能正确显示。
示例代码：创建HTML邮件草稿
以下是修正后的Python代码，它通过添加Content-Type头部，成功在Gmail中创建可正确渲染的HTML邮件草稿：
from email.message import Message
import imaplib
import time
import ssl
def create_html_gmail_draft(imap_ssl_connection, to_email, subject, html_content):
"""
使用IMAPLIB在Gmail中创建HTML邮件草稿。
Args:
imap_ssl_connection: 已经建立并登录的imaplib.IMAP4_SSL连接对象。
to_email (str): 收件人邮箱地址。
subject (str): 邮件主题。
html_content (str): 包含HTML标签的邮件正文内容。
Returns:
tuple: (status, data) 从imaplib.append返回的状态和数据。
"""
message = Message()
message["To"] = to_email
message["Subject"] = subject
# 核心解决方案：添加Content-Type头部
message["Content-Type"] = "text/html;charset=UTF-8"
message.set_payload(html_content, charset="utf-8") # 明确指定payload的编码
# 将Message对象转换为字符串并编码为UTF-8
# 注意：这里直接使用message.as_string()并编码，比str(message).encode()更规范
utf8_message = message.as_string().encode("utf-8")
# 将邮件追加到Gmail的草稿箱
# Gmail的草稿箱通常是 "[Google Mail]/Drafts" 或 "Drafts"
# 建议先list()一下查看实际名称
status, data = imap_ssl_connection.append('"[Google Mail]/Drafts"',
"",
imaplib.Time2Internaldate(time.time()),
utf8_message)
return status, data
# --- 使用示例 ---
if __name__ == "__main__":
# 请替换为您的邮箱和应用程序密码
EMAIL_ADDRESS = "your_email@gmail.com"
APP_PASSWORD = "your_app_password" # 使用应用程序密码，而非普通密码
# 建立IMAPSSL连接
try:
imap_ssl = imaplib.IMAP4_SSL("imap.gmail.com", port=993)
imap_ssl.login(EMAIL_ADDRESS, APP_PASSWORD)
print("IMAP Login successful.")
# 构造HTML内容
html_body = """
<html>
<head></head>
<body>
<p>你好，</p>
<p>这是一封<b>HTML格式</b>的邮件草稿，通过Python的<code>imaplib</code>创建。</p>
<p>请点击这个<a href="https://www.example.com" style="color:blue;">示例https://www.php.cn/link/8f1dd6e7a88b9cf615c146330c591ba9</a>。</p>
<p>祝好！</p>
</body>
</html>
"""
# 调用函数创建HTML草稿
status, data = create_html_gmail_draft(
imap_ssl,
"target_recipient@example.com",
"Python IMAPLIB HTML 草稿测试",
html_body
)
if status == 'OK':
print(f"HTML邮件草稿创建成功！状态: {status}, 数据: {data}")
else:
print(f"HTML邮件草稿创建失败！状态: {status}, 数据: {data}")
imap_ssl.logout()
print("IMAP Logout successful.")
except imaplib.IMAP4.error as e:
print(f"IMAP error: {e}")
print("请检查邮箱地址、应用程序密码或网络连接。")
except Exception as e:
print(f"An unexpected error occurred: {e}")
注意事项：
- 应用程序密码： 为了安全，Gmail建议使用应用程序专用密码（App Password）而非您的主账户密码进行第三方应用登录。您可以在Google账户安全设置中生成。
- imap_ssl.append的第一个参数： ' "[Google Mail]/Drafts"' 是Gmail草稿箱的常见名称。在某些情况下，它可能只是"Drafts"。您可以通过imap_ssl.list()命令查看所有邮箱的名称。
- message.set_payload(..., charset="utf-8")： 在设置payload时，显式指定charset可以增强兼容性。
- message.as_string().encode("utf-8")： 这是一个更规范的方法将Message对象转换为适合传输的字节串，它会处理所有头部和payload的编码。
总结
通过在email.message.Message对象中添加Content-Type: text/html;charset=UTF-8头部，我们能够有效地指示Gmail将邮件内容解析为HTML格式。这一简单的修改解决了使用imaplib创建HTML邮件草稿时内容显示为纯文本的问题，确保了邮件草稿的专业性和可读性。在处理邮件内容时，理解MIME类型的重要性是实现复杂邮件功能（如附件、多部分邮件）的基础。
