在 Python 中发送邮件，通常通过内置的 **smtplib 模块结合 email 模块** 实现，核心流程包括：连接 SMTP 服务器、构建邮件内容、登录发件账号、发送邮件以及关闭连接。**只要掌握 SMTP 协议原理与 Python 邮件封装结构，就可以实现文本邮件、HTML 邮件、附件邮件甚至群发邮件功能。**本文将系统讲解 Python 发邮件的完整实现方法、常见问题处理、安全设置以及企业级应用场景。

---

## 一、Python 发邮件的基本原理与工作流程

在讨论“如何用 Python 代码发邮件”之前，首先要理解邮件发送的底层逻辑。电子邮件的发送依赖于 SMTP（Simple Mail Transfer Protocol）协议，它是一种应用层协议，用于客户端向邮件服务器提交邮件。

根据 IETF 发布的 RFC 5321 标准（2008），SMTP 协议定义了邮件客户端与服务器之间的交互规则。Python 的 `smtplib` 模块正是对该协议的封装，使开发者可以用更简洁的方式实现邮件发送功能。

完整的 Python 发邮件流程通常包括以下步骤：

1. 创建 SMTP 客户端对象  
2. 连接邮件服务器（支持 SSL 或 TLS）  
3. 登录邮箱账号（部分邮箱需使用授权码）  
4. 构造邮件内容（文本或 HTML）  
5. 发送邮件  
6. 关闭连接  

**理解 SMTP 协议结构是掌握 Python 邮件发送机制的关键。**如果只复制代码而不理解流程，遇到端口错误或身份认证失败时往往难以排查。

---

## 二、使用 smtplib 发送最简单的文本邮件

最基础的 Python 发邮件示例如下，适用于发送纯文本邮件。

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

# 发件人和收件人
sender = "your_email@example.com"
receiver = "receiver@example.com"

# 邮件内容
message = MIMEText("这是一封通过 Python 发送的测试邮件。", "plain", "utf-8")
message["From"] = Header("发件人名称", "utf-8")
message["To"] = Header("收件人名称", "utf-8")
message["Subject"] = Header("Python 邮件测试", "utf-8")

# 连接 SMTP 服务器
smtp = smtplib.SMTP_SSL("smtp.example.com", 465)
smtp.login(sender, "邮箱授权码")
smtp.sendmail(sender, [receiver], message.as_string())
smtp.quit()
```

在上述代码中，`SMTP_SSL` 表示使用 SSL 加密连接。多数主流邮箱（如 Gmail、Outlook 等）都要求加密连接。根据 Google 官方安全说明（Google Workspace Help, 2023），使用 SSL/TLS 加密连接可以防止凭证泄露。

**注意：很多邮箱不允许直接使用登录密码，而必须开启 SMTP 服务并生成授权码。**这是 Python 发邮件过程中最常见的问题之一。

---

## 三、Python 发送 HTML 邮件与多格式邮件

在实际开发中，单纯文本邮件往往不够美观。企业通知、营销邮件或系统告警通常采用 HTML 格式。

示例代码如下：

```python
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText

msg = MIMEMultipart("alternative")
msg["Subject"] = "HTML 邮件示例"
msg["From"] = sender
msg["To"] = receiver

html_content = """
<html>
  <body>
    <h2 style="color:blue;">Python HTML 邮件</h2>
    <p>这是一封 <b>HTML 格式</b> 邮件。</p>
  </body>
</html>
"""

msg.attach(MIMEText(html_content, "html"))

smtp.sendmail(sender, receiver, msg.as_string())
```

**HTML 邮件的关键在于 MIME 类型的设置。**使用 `MIMEMultipart` 可以支持多种内容格式，例如同时包含纯文本和 HTML，以兼容不同客户端。

在系统通知场景中，HTML 邮件可以用于展示表格数据、状态颜色标识、按钮跳转等信息，大幅提升可读性。

---

## 四、Python 发送带附件的邮件

在企业办公或自动化流程中，发送带附件的邮件非常常见，例如发送报表、日志文件或合同文档。

示例代码：

```python
from email.mime.base import MIMEBase
from email import encoders

with open("report.pdf", "rb") as attachment:
    part = MIMEBase("application", "octet-stream")
    part.set_payload(attachment.read())
    encoders.encode_base64(part)
    part.add_header(
        "Content-Disposition",
        "attachment; filename=report.pdf",
    )
    msg.attach(part)
```

**发送附件的核心步骤是进行 Base64 编码。**因为 SMTP 协议本质上传输的是文本数据，二进制文件必须先编码。

常见应用场景包括：

- 自动发送财务报表  
- 自动发送数据分析结果  
- 系统日志定时归档发送  

如果是在研发团队中做自动化测试或持续集成，通常会将测试报告通过邮件发送给相关成员。此时可以结合项目协作系统进行通知。例如研发团队使用 [PingCode](https://PingCode.com?utm_source=insights&utm_medium=%E5%93%81%E7%89%8C%E8%AF%8D) 进行需求与缺陷管理时，可以通过 Python 脚本将测试结果以邮件形式同步给项目成员，实现自动化闭环管理。

---

## 五、SMTP 常见端口与配置对比

在使用 Python 发送邮件时，很多错误都来自于端口或协议配置错误。以下为常见配置对比：

| 协议类型 | 默认端口 | 加密方式 | 适用场景 | 推荐程度 |
|----------|----------|----------|----------|----------|
| SMTP     | 25       | 无       | 内网或测试环境 | 较低 |
| SMTP + TLS | 587   | STARTTLS | 公网服务器 | 高 |
| SMTP + SSL | 465   | SSL 加密 | 主流邮箱 | 高 |

根据主流邮箱官方说明，大多数服务推荐使用 465 或 587 端口。**如果 Python 发邮件时报错 “Connection refused” 或 “SSL wrong version number”，通常是端口与加密方式不匹配。**

---

## 六、Python 批量发送邮件与群发策略

很多开发者希望使用 Python 实现批量发送邮件，例如营销通知或系统群发提醒。

示例群发逻辑：

```python
receivers = ["a@example.com", "b@example.com", "c@example.com"]

for r in receivers:
    smtp.sendmail(sender, r, msg.as_string())
```

但需要注意：

- 不要短时间内高频发送，容易被判定为垃圾邮件  
- 建议使用抄送（CC）或密送（BCC）  
- 建议设置发送间隔  

在企业内部管理场景中，项目进度提醒、版本发布通知、任务分配提醒等，都可以通过 Python 邮件自动发送。若结合 [Worktile](https://worktile.com/?utm_source=insights&utm_medium=%E5%93%81%E7%89%8C%E8%AF%8D) 等通用项目管理系统进行流程管理，可通过 API 获取任务变更数据，再通过 Python 邮件脚本自动触发通知，从而实现跨系统协作。

**批量发送的核心在于频率控制与反垃圾策略规避。**

---

## 七、Python 发邮件的安全问题与防范措施

安全问题是 Python 发邮件时必须重视的部分。

常见风险包括：

- 明文保存邮箱密码  
- 未加密连接  
- 被滥用发送垃圾邮件  

建议措施包括：

1. 使用环境变量保存密码  
2. 强制使用 SSL/TLS  
3. 使用专用授权码  
4. 使用企业 SMTP 服务  

例如：

```python
import os
password = os.getenv("EMAIL_PASSWORD")
```

根据 OWASP 安全指南（2021），敏感信息应避免硬编码在源代码中。**安全合规是企业级邮件发送系统的基本要求。**

---

## 八、Python 邮件发送常见报错与解决方案

在实际开发中，常见错误包括：

- SMTPAuthenticationError：登录失败  
- SMTPConnectError：连接失败  
- SMTPSenderRefused：发件人被拒  

常见原因包括：

- 未开启 SMTP 服务  
- 授权码错误  
- IP 被限制  
- 端口配置错误  

**排查顺序建议：端口 → 加密方式 → 账号权限 → 授权码。**

如果是在服务器环境部署，需确保防火墙放行对应端口。

---

## 九、企业级应用场景与未来趋势

随着自动化办公与 DevOps 普及，Python 发邮件已经成为常见的自动化能力之一。常见企业级场景包括：

- 自动化运维告警  
- CI/CD 构建通知  
- 数据分析日报  
- 财务报表定时发送  

未来趋势包括：

1. 与 API 邮件服务集成（如 RESTful 邮件服务）  
2. 与消息队列结合实现异步发送  
3. 与工作流系统深度整合  
4. 更严格的反垃圾与安全认证机制（如 SPF、DKIM、DMARC）  

根据 DMARC.org 2022 年发布的数据，启用 DMARC 的域名显著降低了邮件欺诈风险。**未来 Python 发邮件不仅仅是发送功能，更是企业通信安全体系的一部分。**

---

## 总结

通过本文可以看到，使用 Python 发邮件并不复杂，核心在于理解 SMTP 协议与邮件结构。无论是简单文本邮件、HTML 邮件、附件邮件还是批量群发，都可以通过 smtplib 和 email 模块实现。企业应用中需重点关注安全配置与反垃圾策略。未来随着自动化与安全标准升级，Python 邮件发送将更多与 API 服务、身份验证机制深度结合，成为企业自动化流程的重要组成部分。

参考与资料来源  
RFC 5321 - Simple Mail Transfer Protocol, IETF, 2008  
Google Workspace Help - Send email from a printer, scanner, or app, 2023  
OWASP Secure Coding Practices, 2021  
DMARC.org Annual Report, 2022

您需要准备发送方的邮箱地址和密码（或授权码），收件方的邮箱地址，邮件服务器的 SMTP 地址和端口，以及邮件的主题和内容。这些信息是使用 Python 邮件库进行发送的关键参数。

发送邮件前必须具备的基础信息

在使用 Python 发送邮件之前，我需要了解和准备哪些基本的邮件信息？

Python 发送邮件时需要准备哪些基础信息？

Python 内置的 smtplib 库是比较常用且简单的邮件发送库，它支持 SMTP 协议，几乎可以满足常见的邮件发送需求。此外，还可以结合 email 库来格式化邮件内容，包括文本、HTML 和附件。

哪种 Python 库最适合用于发送电子邮件？

通过 email.mime.multipart.MIMEMultipart 创建邮件主体，使用 MIMEBase 和 encoders 将附件载入邮件中，设置合适的内容类型和文件名，然后通过 smtplib.SMTP 连接邮件服务器并发送。这样可以实现包含附件的完整邮件发送功能。

使用 email.mime 模块构建带附件邮件

我想用 Python 发送电子邮件同时附带文件，具体该怎么操作？

如何使用 Python 代码发送带附件的邮件？

PingCodeDocs

Python 发送邮件主要通过 smtplib 与 email 模块实现，核心流程包括连接 SMTP 服务器、构建邮件内容、登录认证与发送邮件。支持文本、HTML、附件及批量发送等功能。实际应用中需正确配置端口与加密方式，使用授权码并避免明文存储密码，以保障安全性。在企业环境下，Python 邮件发送常用于自动化通知与系统告警，并逐步与安全认证和API服务结合，成为自动化流程的重要工具。

如何用py 代码发邮件