文章目录
- sendgrid-python：用 Python 发邮件，几行代码搞定
- 安装很简单
- 发邮件有两种写法
- 不止发邮件
- 什么场景适合用
- 小结
- 小结
sendgrid-python：用 Python 发邮件，几行代码搞定
最近留意到一个邮件发送的 Python 库，sendgrid-python。它在 GitHub 上有 1,628 个 Star，数量不算多，但解决的是个实在问题。
很多开发者都遇到过这种情况：项目需要发邮件，用 Python 自带的 smtplib 也能写，但配置麻烦，成功率低，进垃圾箱的概率还高。走第三方邮件服务的 API 会更稳一些，sendgrid-python 就是 SendGrid 服务的官方 Python SDK。
这个库封装了 SendGrid Web API v3 的全部端点，最常用的功能就是发邮件，也支持查询退信、处理入站邮件等。对需要集成邮件功能的 Python 项目来说，是个省事的方案。
安装很简单
直接用 pip 装：
pipinstallsendgrid依赖只有两个：Python-HTTP-Client 和 Cryptography。Python 版本要求 2.7 以上。
使用时需要配置 SENDGRID_API_KEY 环境变量，在 SendGrid 后台申请一个就行。配好一次，后续不用再管。Mac 和 Windows 的环境变量配置方式文档里都写了，复制粘贴就能用。
发邮件有两种写法
这个库提供了两种使用方式，看你喜欢哪种。
第一种是用 Mail 辅助类，这是最省事的写法：
importsendgridimportosfromsendgrid.helpers.mailimport*sg=sendgrid.SendGridAPIClient(api_key=os.environ.get('SENDGRID_API_KEY'))from_email=Email("test@example.com")to_email=To("test@example.com")subject="Sending with SendGrid is Fun"content=Content("text/plain","and easy to do anywhere, even with Python")mail=Mail(from_email,to_email,subject,content)response=sg.client.mail.send.post(request_body=mail.get())几行代码就能发一封邮件。Mail 类会自动帮你处理 personalization 对象，不用手动拼 JSON。对大多数场景来说，这种写法够用了。
第二种是直接调 API，自己组装请求体：
sg=sendgrid.SendGridAPIClient(api_key=os.environ.get('SENDGRID_API_KEY'))data={"personalizations":[{"to":[{"email":"test@example.com"}],"subject":"Sending with SendGrid is Fun"}],"from":{"email":"test@example.com"},"content":[{"type":"text/plain","value":"and easy to do anywhere, even with Python"}]}response=sg.client.mail.send.post(request_body=data)这种方式更灵活，适合需要精细控制的场景。比如要加附件、用模板、批量发送，都可以在这种结构上做扩展。文档里还有更完整的示例，需要的时候可以查。
不止发邮件
除了发邮件，这个库还支持 SendGrid v3 的所有 API 端点。
比如查退信列表：
response=sg.client.suppression.bounces.get()支持流式接口的写法，代码链条清晰。也支持传统的路径字符串方式：
response=sg.client._("suppression/bounces").get()另外还带了入站邮件解析的辅助模块，可以处理通过 webhook 接收到的邮件。这个功能在需要做邮件自动回复或工单系统的场景里会用到。
什么场景适合用
如果你的项目需要发事务性邮件，比如注册验证码、密码重置、通知推送，这个库很合适。API 方式比 SMTP 稳定，送达率也更高。SendGrid 有免费额度，小项目够用了。
如果你要做复杂的邮件路由、解析，可能需要更多基础设施。但作为发送端，sendgrid-python 够用了。文档里还有常见用例的示例代码，照着改就行。
代码是 MIT 协议的，可以商用。社区也比较活跃，有问题能查到解决方案。
小结
sendgrid-python 是个务实的工具。代码简洁，文档完整，几行代码就能集成邮件发送。对于需要邮件功能的 Python 项目来说，值得试试。
题能查到解决方案。
小结
sendgrid-python 是个务实的工具。代码简洁，文档完整，几行代码就能集成邮件发送。对于需要邮件功能的 Python 项目来说，值得试试。
