0

0

如何使用Python发送电子邮件?smtplib模块教程

蓮花仙者

蓮花仙者

发布时间:2025-07-06 13:09:01

|

212人浏览过

|

来源于php中文网

原创

python发送邮件的核心在于利用smtplib模块与smtp服务器通信,并用email模块构建邮件内容。常见认证问题包括:1.密码错误或未启用授权码,需使用邮箱生成的专用密码;2.smtp地址或端口错误,应根据服务商配置正确参数;3.网络或防火墙限制,需检查端口访问权限;4.ssl/tls协议不匹配,应根据端口选择加密方式。对于html或附件邮件,需使用mimetext设置subtype为html,或通过mimemultipart组合多部分内容。整个流程需注意编码、加密连接及邮件内容封装。

如何使用Python发送电子邮件?smtplib模块教程

Python发送电子邮件,核心在于利用其内置的smtplib模块与邮件服务商的SMTP服务器进行通信。它允许我们像命令行一样,一步步地与邮件服务器“对话”,发送指令,最终把邮件送出去。同时,email模块则负责把我们想发的内容——无论是纯文本、HTML还是附件——“包装”成邮件服务器能理解的标准格式。

如何使用Python发送电子邮件?smtplib模块教程

要用Python发邮件,我们通常会经历这么几个步骤,看似繁琐,实则逻辑清晰:连接服务器、登录、构建邮件内容,最后发送。

如何使用Python发送电子邮件?smtplib模块教程

最基本的纯文本邮件发送流程是这样的:

立即学习Python免费学习笔记(深入)”;

import smtplib
from email.mime.text import MIMEText
from email.header import Header # 为了处理中文主题等

# 邮件配置
sender = '你的发件邮箱@example.com' # 替换为你的邮箱
password = '你的邮箱授权码或密码' # 替换为你的授权码或密码
receivers = ['收件人邮箱@example.com'] # 可以是列表,发送给多人

# 邮件服务器配置 (以Gmail为例,其他服务商请查询其SMTP设置)
# 对于Gmail,通常需要开启两步验证并生成应用专用密码
smtp_server = 'smtp.gmail.com'
smtp_port = 587 # 推荐使用587端口,配合TLS加密

# 邮件内容
msg = MIMEText('这是一封由Python发送的测试邮件,内容很简单。', 'plain', 'utf-8')
msg['From'] = Header("你的名字 <{}>".format(sender), 'utf-8')
msg['To'] = Header("收件人名称 <{}>".format(','.join(receivers)), 'utf-8')
msg['Subject'] = Header("Python邮件发送测试", 'utf-8')

try:
    # 连接SMTP服务器
    server = smtplib.SMTP(smtp_server, smtp_port)
    server.ehlo() # 向服务器标识身份
    server.starttls() # 启动TLS加密
    server.ehlo() # 再次标识身份,以适应TLS连接

    # 登录邮箱
    server.login(sender, password)

    # 发送邮件
    server.sendmail(sender, receivers, msg.as_string())
    print("邮件发送成功!")

except smtplib.SMTPAuthenticationError:
    print("认证失败:请检查用户名和密码(或授权码),以及是否开启了应用专用密码。")
except smtplib.SMTPConnectError as e:
    print(f"连接服务器失败:{e}。请检查SMTP服务器地址和端口是否正确,网络连接是否正常。")
except Exception as e:
    print(f"发送邮件时发生错误:{e}")
finally:
    if 'server' in locals() and server:
        server.quit() # 关闭连接

这里我特意用了Header来处理主题和发件人名称,因为直接用字符串在某些情况下(比如中文)可能会出现乱码。starttls()是关键,它把一个普通的SMTP连接升级为加密连接,这是目前大多数邮件服务商推荐的方式。

如何使用Python发送电子邮件?smtplib模块教程

使用smtplib发送邮件时常见的认证问题和解决方案有哪些?

认证问题,简直是初次尝试Python发邮件的“拦路虎”。我个人就遇到过好几次,明明代码逻辑没问题,但就是提示认证失败。这背后其实有不少原因。

百度GBI
百度GBI

百度GBI-你的大模型商业分析助手

下载
  • 密码错误或授权码未启用: 最直接的,就是你输入的密码不对。但现在很多大型邮箱服务商,比如Gmail、QQ邮箱、网易邮箱,出于安全考虑,当你通过第三方客户端(比如Python脚本)登录时,不再允许使用你的账户登录密码,而是需要生成一个“客户端专用授权码”或“应用专用密码”。如果你用的是普通登录密码,那基本是认证不通过的。

    • 解决方案: 登录你的邮箱网页版,在“账户安全”或“设置”中寻找“POP3/IMAP/SMTP服务”或“客户端授权码”相关的选项,开启它并生成一个专用密码。将这个专用密码填入代码的password变量。
  • SMTP服务器地址或端口错误: 每个邮件服务商的SMTP服务器地址和端口都可能不同。常见的SMTP服务器地址是smtp.xxx.com,端口通常是25(不加密或旧式),465(SSL加密),或587(TLS加密,推荐)。

    • 解决方案: 仔细核对你的邮件服务商提供的SMTP服务器地址和端口。例如,Gmail是smtp.gmail.com:587(TLS)或smtp.gmail.com:465(SSL)。如果用465端口,你需要使用smtplib.SMTP_SSL而不是smtplib.SMTP
  • 防火墙或网络限制: 有时候,公司的网络防火墙或者你自己的电脑防火墙可能会阻止Python脚本连接到外部的SMTP端口。

    • 解决方案: 检查你的防火墙设置,确保587465端口没有被阻止。如果是在公司内网,可能需要联系IT部门。
  • SSL/TLS协议问题: 邮件服务商可能要求使用加密连接。如果你的代码没有正确启用TLS (starttls()) 或者使用了错误的加密方式(比如尝试用普通SMTP连接465端口),也会导致连接失败或认证问题。

    • 解决方案: 对于587端口,务必在connect之后、login之前调用server.starttls()。对于465端口,直接使用server = smtplib.SMTP_SSL(smtp_server, smtp_port)来建立连接。

这些问题,很多时候都是细节上的疏忽,但它们会直接导致整个邮件发送流程卡死。所以,遇到问题时,第一反应就是检查这些配置细节,特别是那个授权码。

如何使用Python发送包含附件或HTML内容的邮件?

发送纯文本邮件只是个开始,实际工作中,我们更常需要发送带有格式的HTML邮件,或者附带文件。email模块就是为这些复杂需求而生的。它提供了一套类来构建多部分邮件(MIMEMultipart),让你能把文本、HTML、图片、文件等“打包”在一起。

发送HTML邮件,本质上是把邮件正文的subtypeplain改成html

from email.mime.text import MIMEText
from email.

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

718

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

219

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1561

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1168

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1142

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

188

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

111

2025.08.07

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

23

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.8万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号