Python发送CID内嵌图片邮件，Gmail收件箱显示为附件的问题求助

问题根源在于你使用了默认的MIMEMultipart()（对应multipart/mixed类型），这种类型会把所有附加内容都视为独立附件。Gmail对邮件结构识别严格，要让内嵌图片不被当成附件显示，需调整邮件的multipart结构：

核心修改点 #

• 使用MIMEMultipart('related')作为根容器，专门承载HTML内容及其关联的内嵌资源（图片、样式等）
• 把HTML文本放在MIMEMultipart('alternative')中，这是邮件规范里同时支持纯文本和HTML版本的标准结构，能帮助Gmail正确识别内容层级

修改后的完整代码 #

from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.image import MIMEImage

message = MIMEMultipart('related')  # 关键：改用related类型
message['Subject'] = emailSubject
message['From'] = fromAddress
message['To'] = toAddress

# 创建alternative容器，用于存放纯文本和HTML版本（可按需添加纯文本内容）
alt_part = MIMEMultipart('alternative')
message.attach(alt_part)

# 添加HTML内容，确保cid与图片的Content-ID一致
emailHtml = '<img src="cid:INLINE_IMAGE"/>'
html_part = MIMEText(emailHtml, 'html')
alt_part.attach(html_part)

# 添加内嵌图片
fp = open(imagePath, 'rb')
image = MIMEImage(fp.read())
fp.close()
image.add_header('Content-ID', '<INLINE_IMAGE>')  # 按规范添加尖括号，提升兼容性
image.add_header('Content-Disposition', 'inline', filename="inline-image.png")
message.attach(image)

关键细节说明 #

1. multipart/related的作用：告知邮件客户端容器内的内容相互关联，图片是HTML的一部分，而非独立附件
2. Content-ID的尖括号：这是邮件规范的标准写法，能避免部分客户端识别异常
3. 保留Content-Disposition: inline：明确指定图片为内嵌显示，既不会被当成下载附件，也能避免出现"noname"的问题

调整后，Gmail收件箱不会把内嵌图片显示为附件，同时图片依然能正常显示在邮件正文中。

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