Python SMTP发送邮件

参考文章

一、介绍

SMTP（Simple Mail Transfer Protocol）即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则，由它来控制信件的中转方式。

python的smtplib提供了一种很方便的途径发送电子邮件。它对smtp协议进行了简单的封装。

Python内置对SMTP的支持，可以发送纯文本邮件、HTML邮件以及带附件的邮件。

Python对SMTP支持有smtplib和email两个模块，email负责构造邮件，smtplib负责发送邮件

二、基础语法

1、Python创建 SMTP 对象

语法如下：

import smtplib

smtpObj = smtplib.SMTP( [host [, port [, local_hostname]]] )

参数说明：

• host: SMTP 服务器主机。 你可以指定主机的ip地址或者域名如: runoob.com，这个是可选参数。
• port: 如果你提供了 host 参数, 你需要指定 SMTP 服务使用的端口号，一般情况下 SMTP 端口号为25。
• local_hostname: 如果 SMTP 在你的本机上，你只需要指定服务器地址为 localhost 即可。

 或者：

import smtplib

smtpObj = smtplib.SMTP()
smtpObj.connect(host, 25)  # 25 为 SMTP 端口号
smtpObj.quit()

2、Python SMTP 对象使用 sendmail 方法发送邮件

语法如下：

smtpObj.sendmail(from_addr, to_addrs, msg[, mail_options, rcpt_options])

参数说明：

• from_addr: 邮件发送者地址(即你的邮箱地址)。
• to_addrs: 字符串列表，邮件发送地址(发给谁，即对方邮箱地址)。
• msg: 发送消息

这里要注意一下第三个参数，msg 是字符串，表示邮件。我们知道邮件一般由标题，发信人，收件人，邮件内容，附件等构成，发送邮件的时候，要注意 msg 的格式。这个格式就是 smtp 协议中定义的格式。

三、纯文本邮件示例

1、基础语法

"""
如果本机已经安装了支持SMTP服务，如sendemail，
我们使用三个引号来设置邮件信息，标准邮件需要三个头部信息： From, To, 和 Subject ，每个信息直接使用空行分割。
msg['To']接收的是字符串而不是list，如果有多个邮件地址，用,分隔即可。

我们通过实例化 smtplib 模块的 SMTP 对象 smtpObj 来连接到 SMTP 访问，并使用 sendmail 方法来发送信息。

执行以上程序，如果你本机安装 sendmail（邮件传输代理程序）
"""
import smtplib
from email.mime.text import MIMEText
from email.header import Header
 
sender = 'xxx'  # 发送者的邮箱
receivers = ['xxx@qq.com']  # 接收邮件，其他人的邮箱
 
# 三个参数：第一个为文本内容，第二个为格式 plain 代表文本格式，第三个 utf-8 设置编码
message = MIMEText('邮件发送测试', 'plain', 'utf-8')  # 邮箱内容
message['From'] = Header("ZBJ", 'utf-8')  # 发送者
message['To'] =  Header("测试", 'utf-8')  # 接收者
 
subject = 'Python SMTP 邮件测试'
message['Subject'] = Header(subject, 'utf-8')  # 邮箱主题
 
 
try:
    smtpObj = smtplib.SMTP('localhost')
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
except smtplib.SMTPException:
    print("Error: 无法发送邮件")



"""
如果我们本机没有 sendmail 访问，也可以使用其他邮件服务商的 SMTP 访问（QQ、网易、Google等）

"""
import smtplib
from email.mime.text import MIMEText
from email.header import Header
 
# 第三方 SMTP 服务
mail_host="smtp.XXX.com"  # 设置服务器
mail_user="XXXX"  # 用户名
mail_pass="XXXXXX"  # 口令 
 
 
sender = 'xxx'  # 发送者邮箱
receivers = ['xxx@qq.com']  # 接收邮件，其他人的邮箱
 
message = MIMEText('邮件发送测.', 'plain', 'utf-8')
message['From'] = Header("ZBJ", 'utf-8')
message['To'] =  Header("测试", 'utf-8')
 
subject = 'Python SMTP 邮件测试'
message['Subject'] = Header(subject, 'utf-8')
 
 
try:
    smtpObj = smtplib.SMTP() 
    smtpObj.connect(mail_host, 25)  # 端口根据服务器不同可能会改变
    smtpObj.login(mail_user,mail_pass)  
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
except smtplib.SMTPException:
    print("Error: 无法发送邮件")

2、纯文本邮件示例(QQ邮箱)

QQ邮箱 POP3 和 SMTP 服务器地址设置如下：

邮箱	POP3服务器（端口995）	SMTP服务器（端口465或587）
qq.com	pop.qq.com	smtp.qq.com

SMTP服务器需要身份验证。根据提示开启相关服务，选择生成授权码，得到后用于后续代码登陆部分

首先必须要打开QQ邮箱的smtp服务，在QQ邮箱个人主页的  设置-账户 中开启。如图：

成功开启后点击生成授权码 ，得到的密码为smtp发送邮件时的登录密码。

import smtplib
from email.mime.text import MIMEText
from email.header import Header


# 第三方 SMTP 服务
mail_host="smtp.qq.com"  # 设置服务器
mail_user="xxx@qq.com"  # 用户名(你的邮箱)
mail_pass="yxdfsdwssdftsdg"  # 口令,即开启smtp服务得到的授权码，不是QQ密码

sender = "xxx@qq.com"  # 发送者的邮箱(也是你的邮箱,同用户名)
receivers = ["yyy@qq.com"]  # 接收邮件，其他人邮箱

# 三个参数：第一个为文本内容，第二个为格式 plain 代表文本格式，第三个 utf-8 设置编码
message = MIMEText("smtplib测试", "plain", "utf-8")

# 标准邮件需要三个头部信息： From, To, 和 Subject
message["From"] = Header("ZBJ", "utf-8")  # 发送人(名称)
message["To"] = Header("测试", "utf-8")  # 接收人(名称)

subject = 'Python SMTP 邮件测试'
message['Subject'] = Header(subject, 'utf-8')  # 邮件主题

try:
    smtpObj = smtplib.SMTP()
    smtpObj.connect(mail_host, 25)  # 25 为 SMTP 端口号
    """
    但是这样我们用25号端口都是以明文发送的，很容易被监视，
    所以我们可以发送加密邮件，只需要利用SSL:
    smtpObj = smtplib.SMTP_SSL()
    smtpObj.connect(mail_host, 465)  # QQ邮箱的端口465或587
    
    SMTP和SMTP_SSL选择一个使用即可
    """
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
    smtpObj.quit()
except smtplib.SMTPException:
    print("Error: 无法发送邮件")

结果如下：

 

3、使用 formataddr 生成真实的发送/接收者

formataddr 和 parseaddr 用法介绍

from email.utils import parseaddr
from email.utils import formataddr

# 根据 <> 进行分割，分割出用户名和邮箱
me = "ZBJ <xxx@qq.com>"
ret = parseaddr(me)  # 入参是字符串
print(ret)  # ('ZBJ', 'xxx@qq.com')


# 跟parseaddr相反，把某个列表合并成邮箱格式
f_str = formataddr(["ZBJ", "xxx@qq.com"])  # 入参是列表或者元组
print(f_str)  # ZBJ <xxx@qq.com>

上面代码设置标准邮件的三个头部信息时，使用的时Header，

Header是自定义的头部信息，不是真实的，

而使用formataddr则是设置真实的信息。

import smtplib
from email.mime.text import MIMEText
from email.header import Header
from email.utils import formataddr


# 第三方 SMTP 服务
mail_host="smtp.qq.com"  # 设置服务器
mail_user="xxx@qq.com"  # 用户名
mail_pass="uhadlxasddwsdgq"  # 口令

sender = "xxx@qq.com"  # 发送者的邮箱
receivers = ["yyy@qq.com"]  # 接收邮件，其他人的邮箱

message = MIMEText("嘿嘿嘿", "plain", "utf-8")

# 标准邮件需要三个头部信息： From, To, 和 Subject
message["From"] = formataddr(["ZBJ", sender])  # 列表里的对应发件人邮箱昵称、发件人邮箱账号
message["To"] = formataddr(["小明", receivers[0]])  # 列表里的对应收件人邮箱昵称、收件人邮箱账号

subject = '邮件测试'
message['Subject'] = Header(subject, 'utf-8')  # 邮件主题

try:
    smtpObj = smtplib.SMTP_SSL()
    smtpObj.connect(mail_host, 465)
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
    smtpObj.quit()
except smtplib.SMTPException:
    print("Error: 无法发送邮件")

结果如下：

四、HTML格式的邮件示例

Python发送HTML格式的邮件与发送纯文本消息的邮件不同之处就是将MIMEText中_subtype设置为html

import smtplib
from email.mime.text import MIMEText
from email.header import Header


# 第三方 SMTP 服务
mail_host="smtp.qq.com"  # 设置服务器
mail_user="xxx@qq.com"  # 用户名
mail_pass="ysdfndwfgasd"  # 口令

sender = "xxx@qq.com"  # 发送者的邮箱
receivers = ["yyy@qq.com"]  # 接收邮件，其他人的邮箱

mail_msg = """
<p>HTML邮件测试</p>
<table>
<thead>
  <tr>
    <th>序号</th>
    <th>姓名</th>
    <th>爱好</th>
  </tr>
  </thead>
  
  <tbody>
  <tr>
    <td>1</td>
    <td>小明</td>
    <td>打球</td>
  </tr>
  <tr>
    <td>2</td>
    <td>小红</td>
    <td>发豪</td>
  </tr>
  </tbody>
</table>
"""

# 设置为html邮箱
message = MIMEText(mail_msg, "html", "utf-8")

# 标准邮件需要三个头部信息： From, To, 和 Subject
message["From"] = Header("ZBJ", "utf-8")  # 发送人
message["To"] = Header("小明", "utf-8")  # 接收人

subject = 'HTML邮件测试'
message['Subject'] = Header(subject, 'utf-8')  # 邮件主题

try:
    smtpObj = smtplib.SMTP_SSL()
    smtpObj.connect(mail_host, 465)
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
    smtpObj.quit()
except smtplib.SMTPException:
    print("Error: 无法发送邮件")

结果如下：

五、带附件的邮件

带附件的邮件可以看做包含若干部分的邮件：文本和各个附件本身，所以，可以构造一个MIMEMultipart对象代表邮件本身，然后往里面加上一个MIMEText作为邮件正文，再继续往里面加上表示附件的MIMEText对象即可

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.header import Header
from email.utils import formataddr

# 第三方 SMTP 服务
mail_host = "smtp.qq.com"  # 设置服务器
mail_user = "xxx@qq.com"  # 用户名
mail_pass = "ytuasfdwsbsdftwe"  # 口令

sender = "xxx@qq.com"  # 发送者的邮箱
receivers = ["yyy@qq.com"]  # 接收邮件，其他人的邮箱

# 创建一个带附件的实例
message = MIMEMultipart()

message["From"] = formataddr(["ZBJ", sender])  # 发送人
message["To"] = formataddr(["小明", receivers[0]])  # 接收人

subject = '带附件的邮件测试'
message['Subject'] = Header(subject, 'utf-8')  # 邮件主题

# 邮件正文内容
message.attach(MIMEText('这是带附件的邮件发送测试', 'plain', 'utf-8'))

# 构造附件1，传送当前目录下的 test.txt 文件
att1 = MIMEText(open('test.txt', 'rb').read(), 'base64', 'utf-8')
att1["Content-Type"] = 'application/octet-stream'
# 这里的filename可以任意写，写什么名字，邮件中显示什么名字
att1["Content-Disposition"] = 'attachment; filename="test.txt"'
message.attach(att1)

# 构造附件2，传送当前目录下的 mypicture.png 图片
att2 = MIMEText(open('mypicture.png', 'rb').read(), 'base64', 'utf-8')
att2["Content-Type"] = 'application/octet-stream'
att2["Content-Disposition"] = 'attachment; filename="mypicture.png"'
message.attach(att2)

try:
    smtpObj = smtplib.SMTP_SSL()
    smtpObj.connect(mail_host, 465)
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
    smtpObj.quit()
except smtplib.SMTPException:
    print("Error: 无法发送邮件")

结果如下：

六、HTML 文本中添加图片

要把一个图片嵌入到邮件正文中，如果直接在HTML邮件中链接图片地址是不行的，大部分邮件服务商都会自动屏蔽带有外链的图片，因为不知道这些链接是否指向恶意网站。

要把图片嵌入到邮件正文中，我们只需按照发送附件的方式，先把邮件作为附件添加进去，然后，在HTML中通过引用src="cid:0"就可以把附件作为图片嵌入了。如果有多个图片，给它们依次编号，然后引用不同的cid:x即可。

import smtplib
from email.mime.text import MIMEText
from email.mime.image import MIMEImage
from email.mime.multipart import MIMEMultipart
from email.header import Header
from email.utils import formataddr

# 第三方 SMTP 服务
mail_host = "smtp.qq.com"  # 设置服务器
mail_user = "xxx@qq.com"  # 用户名
mail_pass = "ytulertyfgbnffd"  # 口令

sender = "xxx@qq.com"  # 发送者的邮箱
receivers = ["yyy@qq.com"]  # 接收邮件，其他人的邮箱

# 创建一个根实例
msgRoot = MIMEMultipart("related")

msgRoot["From"] = formataddr(["ZBJ", sender])  # 发送人
msgRoot["To"] = formataddr(["小明", receivers[0]])  # 接收人

subject = 'HTML带图片的邮件测试'
msgRoot['Subject'] = Header(subject, 'utf-8')  # 邮件主题

# 创建一个存放正文的实例，并添加进根实例
msgAlternative = MIMEMultipart('alternative')
msgRoot.attach(msgAlternative)

mail_msg = """
<p>Python 邮件发送测试...</p>
<p>图片演示：</p>
<p><img src="cid:0"></p>
"""
msgAlternative.attach(MIMEText(mail_msg, 'html', 'utf-8'))

# 创建图片实例，并添加进根实例
fp = open('mypicture.png', 'rb')
msgImage = MIMEImage(fp.read())
fp.close()

# 定义图片 ID，在 HTML 文本中引用
msgImage.add_header('Content-ID', '<0>')
msgRoot.attach(msgImage)

try:
    smtpObj = smtplib.SMTP_SSL()
    smtpObj.connect(mail_host, 465)
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, msgRoot.as_string())
    print("邮件发送成功")
    smtpObj.quit()
except smtplib.SMTPException:
    print("Error: 无法发送邮件")

结果如下：