讲师中心 微信公众号
AI工具推荐 视频效率加速

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

浅婷酱_8485

浅婷酱_8485

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

|

292人浏览过

|

来源于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发邮件的“拦路虎”。我个人就遇到过好几次,明明代码逻辑没问题,但就是提示认证失败。这背后其实有不少原因。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限

下载
  • 密码错误或授权码未启用: 最直接的,就是你输入的密码不对。但现在很多大型邮箱服务商,比如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端口。

    • 解决方案: 检查你的防火墙设置,确保587或465端口没有被阻止。如果是在公司内网,可能需要联系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邮件,本质上是把邮件正文的subtype从plain改成html:

from email.mime.text import MIMEText
from email.

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

1838

2023.08.03

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

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

2924

2023.09.04

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

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

6224

2023.10.24

字符串介绍
字符串介绍

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

6089

2023.11.24

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

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

7694

2024.03.22

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

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

11594

2024.04.29

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

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

5979

2025.07.29

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

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

6607

2025.08.07

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn