简单三步，用 Python 发邮件

crossin先生

0. 前言

发送电子邮件是个很常见的开发需求。比如你写了个监控天气的脚本，发现第二天要下雨，或者网站上关注的某个商品降价了，就可以发个邮件到邮箱来提醒自己。

使用 Python 脚本发送邮件并不复杂。不过由于各家邮件的发送机制和安全策略不同，常常会因为一些配置问题造成发送失败。今天我们来举例讲讲如何使用 Python 发送邮件。
本文主要内容包括，了解发邮件的思路，发送邮件需要的一些设置，发送一封简单的邮件，发送一封包含附件的邮件，在写代码过程中我们需要注意哪些问题等等。（完整参考代码地址见文末）

1. 思路

使用脚本发送邮件的思路其实和客户端发送邮件一样，过程都是：

登录 —> 写邮件 —> 发送

只不过通过脚本发送时我们需要考虑到整个过程的方方面面。以下为思路导图：



2. Python-email 模块

与发送邮件相关的 Python 模块：
smtplib
是关于 SMTP（简单邮件传输协议）的操作模块，在发送邮件的过程中起到服务器之间互相通信的作用。
email
简单来说，即服务器之间通信的信息，包括信息头、信息主体等等。

举个简单的例子，当你登录邮箱，写好邮件后点击发送，这部分是由 SMTP 接管；而写邮件、添加附件是由 email 模块控制。

3. 开通电子邮箱的SMTP功能

在使用脚本发邮件之前，我们需要打开自己邮箱的 SMTP 功能，各家邮箱的设置方法就不一一讲述了，具体使用时可以百度一下，下面以 163 邮箱设置为例做一个简单的演示：



4. 简单代码

实践出真知，我们结合一个简单的代码来理解这一过程：登录 163 邮箱，向 qq 邮箱发送邮件。
脚本分为三个步骤：

• 设置好服务器端信息
• 邮件主体信息
• 登录发送
  

另外在处理文本时，我们需要使用 MIMEText 类。

1. import smtplib
   
2. from email.mime.text import MIMEText
   
3. #设置服务器所需信息
   
4. #163邮箱服务器地址
   
5. mail_host = 'smtp.163.com'  
   
6. #163用户名
   
7. mail_user = '159*****02'  
   
8. #密码(部分邮箱为授权码)
   
9. mail_pass = '7******x'   
   
10. #邮件发送方邮箱地址
    
11. sender = '159*****02@163.com'  
    
12. #邮件接受方邮箱地址，注意需要[]包裹，这意味着你可以写多个邮件地址群发
    
13. receivers = ['59*****02@qq.com']  
    
14. 
    
15. #设置email信息
    
16. #邮件内容设置
    
17. message = MIMEText('content','plain','utf-8')
    
18. #邮件主题      
    
19. message['Subject'] = 'title'
    
20. #发送方信息
    
21. message['From'] = sender
    
22. #接受方信息     
    
23. message['To'] = receivers[0]  
    
24. 
    
25. #登录并发送邮件
    
26. try:
    
27.     smtpObj = smtplib.SMTP()
    
28.     #连接到服务器
    
29.     smtpObj.connect(mail_host,25)
    
30.     #登录到服务器
    
31.     smtpObj.login(mail_user,mail_pass)
    
32.     #发送
    
33.     smtpObj.sendmail(
    
34.         sender,receivers,message.as_string())
    
35.     #退出
    
36.     smtpObj.quit()
    
37.     print('success')
    
38. except smtplib.SMTPException as e:
    
39.     print('error',e) #打印错误

复制代码

结果：


注意事项：
一些邮箱登录比如 QQ 邮箱需要 SSL 认证，所以 SMTP 已经不能满足要求，而需要SMTP_SSL，解决办法为：

1. #启动
   
2. smtpObj = smtplib.SMTP()
   
3. #连接到服务器
   
4. smtpObj.connect(mail_host,25)
   
5. #######替换为########
   
6. smtpObj = smtplib.SMTP_SSL(mail_host)

复制代码

5. 带有附件的email

上面我们介绍了发送字符串的邮件，但这明显不满足现代邮件的需求，下面我们介绍如何发送内容以 HTML 格式，并且带有图片和文本文件的邮件。
处理多种形态的邮件主体我们需要 MIMEMultipart 类，而处理图片需要 MIMEImage 类。

1. import smtplib
   
2. from email.mime.text import MIMEText
   
3. from email.mime.multipart import MIMEMultipart
   
4. from email.mime.image import MIMEImage
   
5. 
   
6. #设置登录及服务器信息
   
7. mail_host = 'smtp.163.com'
   
8. mail_user = '159*****02'
   
9. mail_pass = '7******x'
   
10. sender = '159*****02@163.com'
    
11. receivers = ['7******0@qq.com']
    
12. 
    
13. #设置eamil信息
    
14. #添加一个MIMEmultipart类，处理正文及附件
    
15. message = MIMEMultipart()
    
16. message['From'] = sender
    
17. message['To'] = receivers[0]
    
18. message['Subject'] = 'title'
    
19. #推荐使用html格式的正文内容，这样比较灵活，可以附加图片地址，调整格式等
    
20. with open('abc.html','r') as f:
    
21.     content = f.read()
    
22. #设置html格式参数
    
23. part1 = MIMEText(content,'html','utf-8')
    
24. #添加一个txt文本附件
    
25. with open('abc.txt','r')as h:
    
26.     content2 = h.read()
    
27. #设置txt参数
    
28. part2 = MIMEText(content2,'plain','utf-8')
    
29. #附件设置内容类型，方便起见，设置为二进制流
    
30. part2['Content-Type'] = 'application/octet-stream'
    
31. #设置附件头，添加文件名
    
32. part2['Content-Disposition'] = 'attachment;filename="abc.txt"'
    
33. #添加照片附件
    
34. with open('1.png','rb')as fp:
    
35.     picture = MIMEImage(fp.read())
    
36.     #与txt文件设置相似
    
37.     picture['Content-Type'] = 'application/octet-stream'
    
38.     picture['Content-Disposition'] = 'attachment;filename="1.png"'
    
39. #将内容附加到邮件主体中
    
40. message.attach(part1)
    
41. message.attach(part2)
    
42. message.attach(picture)
    
43. 
    
44. #登录并发送
    
45. try:
    
46.     smtpObj = smtplib.SMTP()
    
47.     smtpObj.connect(mail_host,25)
    
48.     smtpObj.login(mail_user,mail_pass)
    
49.     smtpObj.sendmail(
    
50.         sender,receivers,message.as_string())
    
51.     print('success')
    
52.     smtpObj.quit()
    
53. except smtplib.SMTPException as e:
    
54.     print('error',e)

复制代码

6.小结通过上面的代码，想必大家已经对发邮件有了基本的认识。
从整体上我们要把握整个过程的思路：

• 登录
• 写邮件
• 发送
  

微观上我们需要了解：

• smtplib/email 模块的代码规则；
• 什么时候使用 SMTP，什么时候使用 SMTP_SSL？
• 针对不同的邮件内容需要使用到不同的类，MIMEmultipart、MIMEText、MIMEIamge 等等；
• 怎么去设置附件信息
  

当然，看再多教程，不如亲自动手写一段代码。大家不妨都自己发一封邮件试一试。


在公众号（crossincode）中回复『email』，可以获取实例代码。

porschen

crossin老师看下 那个500错误的代码

1. 
   
2. #-*- coding: utf-8 -*-
   
3. import smtplib
   
4. from email.mime.text import MIMEText
   
5. 
   
6. mail_host = "smtp.163.com"
   
7. mail_user = "python_cjx"
   
8. mail_pass = "密码"
   
9. 
   
10. sender = "python_cjx@163.com"
    
11. receivers = ["471211579@qq.com"]
    
12. 
    
13. message = MIMEText('content', 'plain', 'utf-8')
    
14. message['Subject'] = 'title'
    
15. message['From'] = sender
    
16. message['To'] = receivers[0]
    
17. 
    
18. try:
    
19.         server = smtplib.SMTP()
    
20.         server.connect(mail_host, 25)
    
21.         print '1'
    
22.         server.login('python_cjx@163.com', '密码')
    
23.         print '2'
    
24.         server.sendmail(sender, receivers, message.as_string())
    
25.         server.quit()
    
26.         print 'success'
    
27.        
    
28. except smtplib.SMTPException as e:
    
29.         print 'error', e

复制代码

crossin先生

porschen 发表于 2016-12-10 20:02
crossin老师看下 那个500错误的代码

你的content、subject都用“真”一点的数据，不要直接'content'、'title'这样，太敷衍了，邮件服务器一眼就归为垃圾邮件了。
我试了下改掉内容就成功了。

porschen

crossin先生 发表于 2016-12-10 23:14
你的content、subject都用“真”一点的数据，不要直接'content'、'title'这样，太敷衍了，邮件服务器一眼 ...

不好意思啊，我就是改成真的也发不出去，还是500，是不是因为电脑设置之类的，邮箱是设置好的

crossin先生

porschen 发表于 2016-12-11 12:10
不好意思啊，我就是改成真的也发不出去，还是500，是不是因为电脑设置之类的，邮箱是设置好的 ...

那就不知道了，我是直接复制你的代码，只改了下用户名密码。
可能性有：
1你的账号或者ip已经被限制了，换个号试试
2你还是有地方弄错了，只是你没有描述出来。你把代码和报错截图发上来看看呢

porschen

crossin先生 发表于 2016-12-11 17:22
那就不知道了，我是直接复制你的代码，只改了下用户名密码。
可能性有：
1你的账号或者ip已经被限制了， ...

crossin先生，我用的是python2.7 这是完整代码和截图[code]
#-*- coding: utf-8 -*-
import smtplib
from email.mime.text import MIMEText

mail_host = "smtp.163.com"
mail_user = "python_cjx"
mail_pass = "chen123456"

sender = "cjxmhxy001@163.com"
receivers = ["471211579@qq.com"]

message = MIMEText('王老师，今天下午我们出去玩吧，去开个会，大概在3点', 'plain', 'utf-8')
message['Subject'] = '下午活动'
message['From'] = sender
message['To'] = receivers[0]

try:
        server = smtplib.SMTP()
        server.connect(mail_host, 25)
        print '1'
        server.login(sender, mail_pass)
        server.sendmail(sender, receivers, message.as_string())
        server.quit()
        print 'success'
       
except smtplib.SMTPException as e:
        print 'error', e

crossin先生

porschen 发表于 2016-12-11 19:01
crossin先生，我用的是python2.7 这是完整代码和截图[code]
#-*- coding: utf-8 -*-
import smtplib

我直接运行你的代码就成功了……

也可能是字符编码的问题，换个编码比如 gbk 试试

你换个环境运行下吧，比如在pycharm里面运行。