Python办公自动化邮件发送服务实战：SMTP、附件与定时任务

办公自动化里最容易被低估的一环，是“结果怎么送出去”。报表生成后如果留在服务器上，审批结束后如果只靠人眼刷新，流程就没有真正结束。邮件发送服务正是把自动化流程最后一公里补上的基础设施：Python 程序把日报、告警、附件发到指定邮箱，SMTP 服务器负责投递，业务方只看见一封准时到达、内容正确的邮件。py100--lv2-089办公自动化-邮件发送服务这个题目很适合作为 Python 入门到进阶之间的一道综合练习，因为它在看似简单的“发信”背后，牵扯到环境配置、网络协议、异常处理、配置分离、批量任务和日常维护等真实工程问题。

这篇文章会围绕“用 Python 实现一个办公自动化邮件发送服务”展开，先讲邮件发送链路中每个角色的作用，再给最小可用代码，然后把它扩展成能发 HTML、附件、批量个性化邮件的服务，最后补充配置、日志、定时任务、常见报错和上线前的检查项。读完以后，你至少能独立完成一个可复现、可排查、可维护的邮件发送模块，而不是只会复制一封能跑通一次的邮件。

1. 先理解邮件发送服务在办公自动化里的位置

1.1 办公自动化为什么需要邮件发送模块

办公自动化通常是一连串“输入、处理、输出”的动作。例如每天从数据库读取销售数据，生成 Excel 报表，再把报表发给管理层；例如审批系统检测到某个申请已经通过，需要通知申请人；例如监控程序发现服务响应变慢，需要发送一条告警给值班人员。如果这些动作只停留在“程序生成文件”，流程并没有真正结束，因为人还在等着结果。

邮件发送模块就是连接“程序结果”和“人工动作”的桥梁。它本身不负责核心业务，却决定了自动化链条是否可靠。相比即时聊天软件，邮件在企业场景里仍然是正式通知、归档审核、跨组织协作的重要通道。把发送逻辑收敛成一个独立服务，而不是散落在各个业务函数里，才能统一处理 SMTP 连接、附件格式、失败重试和日志。

1.2 SMTP、发件客户端和“服务”的关系

邮件发送采用的是 SMTP 协议，即简单邮件传输协议。Python 的smtplib是这个协议的客户端实现，它做的事情是把一封格式化好的邮件文本交给发件方的 SMTP 服务器。发件方 SMTP 服务器再负责后续的路由和转发，最终把邮件投递到收件人邮箱。

这里容易混淆的是“服务”这个词。办公自动化场景里说的“邮件发送服务”，通常不是指自己搭一套 SMTP 服务器，而是指封装好的一段 Python 发送代码、一个后台任务、或者一个小型 API，它依赖企业邮箱或公共邮箱提供的 SMTP 服务完成实际投递。

1.3 一封邮件从 Python 到收件人的完整链路

一封普通邮件的发送流程可以概括为：组装邮件对象、连接 SMTP 服务器、身份认证、提交发送命令、服务器收取并投递。收件人是否立即看到，还取决于双方服务商的过滤策略、网络延迟和客户端刷新时间。

一个典型调用过程是：

import smtplib server = smtplib.SMTP_SSL("smtp.example.com", 465, timeout=10) server.login("sender@example.com", "授权码") server.send_message(msg) server.quit()

这五步背后其实有大量隐藏工作。send_message会遍历邮件的收件人地址，server会先发送MAIL FROM，再为每个收件人发送RCPT TO，最后发送DATA邮件正文。看到这里就应该明白，为什么发送一封邮件也需要设置超时、处理认证异常、考虑收件人无效等问题。这些一旦出错，程序不会像本地函数调用那样立刻报出可读的错误，而是把错误藏在协议交互里，所以后面必须单独讲排错。

2. 开发前的准备：Python、虚拟环境与测试邮箱

2.1 Python 环境检查与虚拟环境创建

邮件发送代码本身不需要高版本 Python，Python 3 的标准库smtplib和email已经够用。为避免和系统 Python 环境互相污染，建议先为项目创建虚拟环境。先确认当前 Python 版本：

python --version

不同操作系统激活方式不同，下面两条命令二选一：

# Windows PowerShell .venv\Scripts\activate # macOS / Linux source .venv/bin/activate

创建虚拟环境和安装依赖的命令如下：

python -m venv .venv pip install --upgrade pip pip install python-dotenv pip install schedule

如果你使用的是 VS Code，那么还需要注意一个关键操作：激活虚拟环境后，在 VS Code 里按Ctrl+Shift+P，找到Python: Select Interpreter，选择当前项目下的.venv解释器。否则终端环境是激活了虚拟环境，编辑器却可能仍在使用全局解释器，导致运行代码时ModuleNotFoundError。

2.2 标准库和第三方库如何取舍

Python 发送邮件最基础的是两个标准库：

• smtplib：负责 SMTP 协议交互。
• email下的相关模块：负责构造 MIME 邮件对象。

如果项目需求只是发固定文本邮件，标准库就足够。但办公自动化里经常出现 HTML 内容、Excel 附件、多人收件和定时任务，所以可以借助辅助库：

• python-dotenv：从.env文件读取配置，避免把密码写进源码。
• schedule或APScheduler：在 Python 进程内做定时发送。
• pandas或openpyxl：读取 Excel 里的收件人和个性化字段。
• yagmail：对smtplib做二次封装，少写模板化代码。

第三方库不是越多越好。它减少的是样板代码，增加的是版本管理和依赖安装成本。一个值得长期维护的邮件服务，应当让核心发送逻辑依赖标准库，把 Excel 解析、定时调度这类能力拆成单独模块。

2.3 准备一个可测试的 SMTP 账号

开发阶段不建议直接向真实用户邮箱发送测试邮件。更好的做法是准备一个专用测试邮箱，并且在第一次跑通前，只在代码里写自己的测试地址。

以 QQ 邮箱为例，使用 SMTP 时要求开启“POP3/SMTP 服务”，并生成授权码。这个授权码不是邮箱登录密码，而是第三方客户端专用密码。163 邮箱、企业邮箱也类似，只是入口名称可能不同，通常叫“客户端授权码”或“SMTP 授权码”。

因此，真正需要确认的信息有四项：

实际项目中，这些值会因为邮箱服务商版本升级而产生差异。如果原始材料没有明确给出邮箱版本，落地前必须先登录对应邮箱管理后台确认协议和端口，不要拿网上旧教程直接套。

2.4 快速验证 Python 环境可用的三行代码

环境是否可用，不需要先写完整项目。先造一封极简单的测试邮件对象并打印，能验证email模块是否正常：

from email.mime.text import MIMEText msg = MIMEText("环境验证", "plain", "utf-8") msg["Subject"] = "test" print(msg.as_string())

如果能打印出包含Content-Type和Subject的文本，说明 Python 基础库没有问题。真正需要担心的是网络出站访问，例如本地机器能否访问smtp.qq.com:465。在 Windows 下可以用telnet测试，在 Linux/macOS 下可以用nc或curl：

curl -v smtp://smtp.qq.com:465 --connect-timeout 5

这个命令不一定会成功完成完整握手，但能看出端口是否可达。如果超时，说明网络层已经拦住了 SMTP 连接，代码层面再怎么改都没用。

3. 用 50 行代码先跑通第一封邮件

3.1 一个最小项目结构的雏形

第一封邮件可以直接写在main.py单文件里，目录保持简单即可：

mail_demo/ ├── .venv/ # 虚拟环境 ├── .env # SMTP 账号和授权码 ├── config.py # 读取 .env 并输出配置 ├── main.py # 邮件发送入口 └── requirements.txt # 依赖清单

用.env存放敏感信息，.gitignore必须把.env排除掉。首次可以这样写.env：

SMTP_HOST=smtp.qq.com SMTP_PORT=465 SMTP_USER=test_sender@example.com SMTP_PASS=你的授权码 DEFAULT_RECEIVER=test_receiver@example.com

3.2 用 smtplib 和 MIMEText 发送纯文本

config.py可以使用os.getenv读取环境变量。为了方便本地开发，再用python-dotenv自动加载.env文件：

import os from dotenv import load_dotenv load_dotenv() SMTP_HOST = os.getenv("SMTP_HOST", "smtp.example.com") SMTP_PORT = int(os.getenv("SMTP_PORT", "465")) SMTP_USER = os.getenv("SMTP_USER", "") SMTP_PASS = os.getenv("SMTP_PASS", "") DEFAULT_RECEIVER = os.getenv("DEFAULT_RECEIVER", "")

然后是发送函数。以下代码覆盖了“连接、认证、发送、退出”四个环节，并对认证失败做基本提示：

import smtplib from email.mime.text import MIMEText from email.utils import formataddr import config def send_text_email(subject: str, body: str, receiver: str) -> None: msg = MIMEText(body, "plain", "utf-8") msg["From"] = formataddr(("自动化通知", config.SMTP_USER)) msg["To"] = receiver msg["Subject"] = subject server = smtplib.SMTP_SSL(config.SMTP_HOST, config.SMTP_PORT, timeout=10) try: server.login(config.SMTP_USER, config.SMTP_PASS) server.send_message(msg) print(f"邮件已发送: {receiver}") except smtplib.SMTPAuthenticationError: print("认证失败，请检查授权码是否填写正确") finally: server.quit() if __name__ == "__main__": send_text_email( subject="办公自动化测试邮件", body="这是一封来自 Python 发送服务的测试文本邮件。", receiver=config.DEFAULT_RECEIVER, )

注意SMTP_SSL适用于 465 端口。如果使用 587 端口，需要改用普通SMTP再执行starttls()，逻辑会多一步。

3.3 使用 587 端口时的差异

587 端口本身使用明文起始连接，然后再通过 STARTTLS 升级为加密连接。代码示例如下：

import smtplib server = smtplib.SMTP(config.SMTP_HOST, config.SMTP_PORT, timeout=10) server.ehlo() server.starttls() server.ehlo() server.login(config.SMTP_USER, config.SMTP_PASS) server.send_message(msg) server.quit()

调用starttls()前先执行ehlo()是协议要求，意思是告诉服务器自己是哪个客户端。第二次ehlo()发生在加密链路建立后，之后发送的认证信息才会被加密保护。很多初学者漏掉starttls()，导致发送时直接出现“必须加密”的报错。

3.4 运行与验证

运行脚本：

python main.py

正常输出是：

邮件已发送: test_receiver@example.com

然后去收件邮箱确认，检查是否进入收件箱、垃圾箱或被拦截。第一次调通时，建议在邮件正文中附带当前时间，方便判断延迟：

from datetime import datetime body = f"当前时间: {datetime.now():%Y-%m-%d %H:%M:%S}"

如果邮件没有收到，不要立即重复运行。先查看程序退出时的异常类型，再登录发件邮箱查看是否被服务商拦截。重复重试有时会触发账号的风控限制，这在办公自动化里尤其要注意。

4. 扩展成可用的邮件模块：HTML、附件、批量与个性化

4.1 MIME 结构决定了整封邮件能装什么

纯文本邮件用MIMEText就够，但办公场景里邮件经常同时包含 HTML 正文和 Excel 附件。此时邮件正文必须由一个多部件容器来承载，也就是MIMEMultipart。

可以这样理解：MIMEMultipart是一个邮件礼盒，里面可以放MIMEText表示的正文，也可以放MIMEApplication表示的二进制附件，还可以再套一层MIMEImage表示内嵌图片。收件人的客户端会按Content-Type和Content-Disposition决定如何展示邮件。

下面是一个更通用的邮件发送模块。为了避免代码散落，我把收件人、抄送、密送、HTML 和附件都封装到一个函数里。

import os import smtplib from email.mime.application import MIMEApplication from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.utils import formataddr import config def build_mail( subject: str, body: str, to: list[str], cc: list[str] | None = None, bcc: list[str] | None = None, html: bool = False, attachments: list[str] | None = None, ) -> tuple[MIMEMultipart, list[str]]: to = to if isinstance(to, list) else [to] cc = cc or [] bcc = bcc or [] msg = MIMEMultipart() msg["From"] = formataddr(("自动化通知", config.SMTP_USER)) msg["To"] = ", ".join(to) if cc: msg["Cc"] = ", ".join(cc) body_type = "html" if html else "plain" msg.attach(MIMEText(body, body_type, "utf-8")) for file_path in attachments or []: if not os.path.isfile(file_path): continue with open(file_path, "rb") as f: part = MIMEApplication(f.read()) part.add_header( "Content-Disposition", "attachment", filename=os.path.basename(file_path), ) msg.attach(part) all_recipients = to + cc + bcc return msg, all_recipients def send_email( subject: str, body: str, to: list[str], cc: list[str] | None = None, bcc: list[str] | None = None, html: bool = False, attachments: list[str] | None = None, ) -> None: msg, all_recipients = build_mail( subject=subject, body=body, to=to, cc=cc, bcc=bcc, html=html, attachments=attachments, ) server = smtplib.SMTP_SSL(config.SMTP_HOST, config.SMTP_PORT, timeout=15) try: server.login(config.SMTP_USER, config.SMTP_PASS) server.sendmail(config.SMTP_USER, all_recipients, msg.as_string()) finally: server.quit()

4.2 密送地址不要作为邮件的普通 head 输出

上面的build_mail没有把Bcc加入msg的消息头，这是一个对有意的处理。原因在于，如果直接把Bcc作为邮件头写入消息，收件人在某些客户端里可能看到你密送了哪些人，这就破坏了“密送”的本意。正确的做法是把密送地址只放在sendmail的收件人参数里，由 SMTP 服务器按信封收件人投递，而不是写进邮件内容本身。

同时要注意server.sendmail的第一个参数是发件人，第二个参数必须是所有真实要投递的地址，包括to、cc、bcc三部分的集合。多个地址直接放到列表里，SMTP客户端会循环发送RCPT TO。

4.3 如何发一份带 HTML 正文和 Excel 附件的日报

假设已完成一份日报数据，并生成了daily_report.xlsx。调用上面的函数只需要一个send_email：

html_content = """ <h2>2025-XX-XX 销售日报</h2> <p>今日销售额较昨日提升 5.2%，具体数据见附件表格。</p> """ send_email( subject="销售日报 2025-XX-XX", body=html_content, to=["manager@example.com"], cc=["leader@example.com"], html=True, attachments=["daily_report.xlsx"], )

发送 HTML 邮件时要特别小心，邮件客户端的安全策略可能屏蔽外部图片和脚本。邮件里应尽量使用简单表格，不要引用外站 JavaScript，也不要把 CSS 写得过于复杂。另外，很多反垃圾规则会把“只有一张图片、一个链接、没有正文”的邮件判定为垃圾邮件，所以即使是通知邮件，也要保留足够文字。

4.4 从 CSV 读取收件人并发送个性化正文

办公场景中经常会出现“给十来个部门负责人各发一封周报”的需求。这时主题和正文往往会根据收件人变化，不能把所有人写在同一个收件人列表里。最基础的做法是读取 CSV，一组一人发送，发送失败则记录。

准备receivers.csv：

name,email,department 张三,zhangsan@example.com,研发部 李四,lisi@example.com,市场部 王五,wangwu@example.com,销售部

发送脚本可以这样实现：

import csv from mail_sender import send_email def send_by_csv(csv_path: str): with open(csv_path, "r", encoding="utf-8-sig") as f: reader = csv.DictReader(f) for row in reader: body = f""" {row["name"]} 你好： 请查看 {row["department"]} 本周工作简报。 """ try: send_email( subject=f"周报通知：{row['department']}", body=body, to=[row["email"]], ) print(f"success: {row['email']}") except Exception as e: print(f"failed: {row['email']}, error: {e}")

utf-8-sig编码适合处理从 Windows Excel 导出的 CSV，可自动去掉 BOM，避免第一列出现\ufeff这类看不见的字符。CSV 里的姓名、部门等内容来自业务文件，发送前要在测试环境先打印几行，确认没有出现空值和乱码。

4.5 真正群发邮件时为什么要分批

如果只是通知二十个内部员工，逐封循环没有问题。但当收件人数达到几百甚至上千时，直接在循环里每封拨一次 SMTP 连接会非常慢，而一次性把所有人塞到sendmail里又容易触发服务商风控。合理做法是分批发送，每批人数控制在 20 到 50 人之间，批次之间稍微休眠几秒。

代码片段如下：

import time def send_in_batches(batch_file_path: str, batch_size: int = 30): recipients = load_recipients(batch_file_path) for i in range(0, len(recipients), batch_size): batch = recipients[i:i + batch_size] send_notice_to_many(batch) time.sleep(5)

分批不是“改一行代码”就能保证不封号，不同邮件服务商对频率的限制不一样，发送周期、正文相似度、链接数量都会影响结果。办公自动化里，宁可发送耗时更长，也不要一次触发大量退信，因为退信会直接消耗邮件服务商的信誉。

5. 配置管理、日志与定时任务，服务才能长期稳定

5.1 把账号信息从代码里拆出去是安全底线

很多入门代码会把邮箱地址和授权码直接写在.py文件里，这在本地测试没问题，一旦代码需要提交到 Git、交接给同事或部署到服务器，隐患立刻出现。授权码泄露后，攻击者不仅可能冒用你的邮箱，还可能让邮件服务商封禁账号。

建议把配置拆成三层：

python-dotenv只是本地开发时的便利工具，生产环境更推荐直接通过容器或者系统级环境变量注入密钥。无论用哪种方式，.gitignore里都应该包含.env：

.env logs/ __pycache__/

5.2 用 logging 记录每一次发送，而不是只靠 print

脚本刚写完时，print("邮件已发送")能看清结果。但当脚本进入定时任务，特别是凌晨运行、无人盯着终端时，唯一能证明它工作正常的是日志。推荐用标准库logging配置一份包含时间、等级和消息的文件日志，同时保留部分控制台输出。

import logging logging.basicConfig( filename="mail_service.log", level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s", encoding="utf-8", ) def log_send(subject: str, to: list[str], status: str, error: str = "") -> None: mail_list = ",".join(to) if status == "success": logging.info("mail success | subject=%s | to=%s", subject, mail_list) else: logging.error("mail failed | subject=%s | to=%s | error=%s", subject, mail_list, error)

记录日志时尽量做到“有一封邮件就有一条记录”。只记录成功会掩盖群发过程中的部分失败；只打印异常而没有主题和收件人，排查时无法定位是哪一批任务出了问题。

5.3 对可重试异常和不可重试异常做不同处理

发送报错不能一概重试。密码错误、邮箱服务未开通 SMTP、收件人地址语法错误这一类错误，重试多少次都是同样结果；连接超时、临时限流、服务器暂时繁忙这一类错误，过一段时间再发可能就成功了。

一个比较稳妥的写法是把重试限定在明确的网络异常范围：

import smtplib import socket import time def send_with_retry(send_func, retries: int = 3, delay: int = 5): for attempt in range(1, retries + 1): try: send_func() return except (ConnectionRefusedError, TimeoutError, socket.timeout, smtplib.SMTPServerDisconnected): if attempt == retries: raise time.sleep(delay)

如果某一封邮件连续重试三次都失败，应该把它写进“失败队列”，而不是直接丢弃。失败队列可以是一个文本文件、一个数据库表，也可以是一组 Python 对象，核心是保留原始收件人、主题、正文和最后一次错误，让运维人员能重新选择发送。

5.4 用计划任务实现“每天定时发日报”

定时发送可以是操作系统层级的，也可以是 Python 进程内调度的。

使用schedule的最小例子：

import schedule import time def daily_job(): send_report() schedule.every().day.at("09:30").do(daily_job) while True: schedule.run_pending() time.sleep(1)

这个写法虽然简单，但while True会一直占用一个终端。如果部署在服务器上，最好搭配nohup或其他进程管理工具，否则终端一关服务就停了。APScheduler 的BlockingScheduler更接近一个真正的定时任务进程：

from apscheduler.schedulers.blocking import BlockingScheduler scheduler = BlockingScheduler() scheduler.add_job(daily_job, "cron", day_of_week="mon-fri", hour=18, minute=0) scheduler.start()

定时任务的作者要站在“无人值守”的角度检查脚本：数据库连接是不是能自动重连，目标文件是不是已生成，发送失败的告警通道是不是独立于邮件本身。如果把告警也走邮件，而 SMTP 服务因为账号问题全部失败，运维就永远收不到通知。

6. 邮件发送报错到底怎么查：现象、日志与处理链路

6.1 先按顺序确认输入，而不是直接搜报错

遇到邮件发送报错时，大多数人会先看最后一行异常，然后复制到搜索引擎。更快的方式是按下述顺序检查：

1. 收件地址是否正确，批量名单里有没有空字符串或格式错误。
2. 发件账号在对应邮箱服务商后台是否已开启 SMTP 服务。
3. 授权码是不是第三方客户端专用码，而不是邮箱登录密码。
4. SMTP 地址和端口是否和当前邮箱服务商文档一致。
5. 本地网络能否连通 SMTP 地址和端口。
6. 代码里是否先starttls再login。
7. 再看日志中关联的主题、发件人和收件人信息。

其中前两步是 Excel、CSV、配置文件层面的问题，占到日常排错的三成以上。很多项目并不是 Python 代码有问题，而是名单里混入了一个错误邮箱，导致整批发送中断。

6.2 常见的 smtplib 异常对照表

6.3 本地能发，服务器上发不出的隐藏原因

这是部署阶段最容易被忽略的问题之一。本地测试可以发邮件，部署到云服务器后却报连接超时，原因通常是云厂商限制了出站方向的 25 端口，这是为了遏制垃圾邮件滥用常见的策略。但 SMTP 并不只有 25 端口可用，很多邮箱服务商也提供 465 和 587 端口。优先使用 465 或 587，就能绕开这个限制。

服务器还有一种情况是缺少 SMTP 服务商域名解析能力，或者解析到了局域网网关。可以执行：

nslookup smtp.qq.com

确认解析出的 IP 不是一个内网地址。若 DNS 正常但连接仍然超时，再排查防火墙规则和出站白名单。服务器部署时间一长，尤其要确认系统当前环境变量与安全组配置是否都指向了正确账号。

6.4 发送成功但收不到，问题很可能在反垃圾策略

很多脚本最后输出“邮件已发送”，收件人却一直没收到。这时候要区分“投递成功”和“进入收件箱”是两回事。sendmail返回成功，只代表发件方 SMTP 服务器已经接收并派发邮件，不代表收件人系统一定会放入收件箱。

可能出现的情况有：

• 发件人是个人 QQ 邮箱，收件人是企业邮箱，企业设置了严格的域名白名单。
• 邮件正文里只有一个链接和一张图片，被识别为营销邮件。
• 邮件标题包含“发票”“代开发票”等高风险词。
• 短时间内连续给同一域名发送大量相似邮件，触发对方反垃圾策略。

排查时先登录发件邮箱查看“已发送”，再查看“退信”和“被退回”邮件。如果发件箱没有退信，可尝试给其他邮箱服务商发一封完全不同的测试邮件，通过对比判断是不是内容或频道问题。办公自动化场景里，面向外部客户的重要邮件，更建议走企业邮箱，并且在群发前让少量真实用户内测。

6.5 三个实战中容易踩到的坑

第一个坑：直接把 QQ 邮箱的登录密码当成 SMTP 密码使用。QQ 邮箱、163 邮箱等常用客户端授权码，即使登录密码正确，也可能返回 535 认证失败。解决办法是登录邮箱后台重新生成授权码，不要直接在.env里反复试版本。

第二个坑：HTML 邮件内容写得很复杂，却在MIMEText构造时漏掉了html类型参数，最终收件人看到一堆<div>标签。正确写法是MIMEText(html_body, "html", "utf-8")，并且要保证邮件正文确实为合法 HTML。

第三个坑：批处理里面遇到某个收件人失败就不管后续收件人。一个稳健的批量脚本，应该记录每个收件人的发送结果，然后继续处理下一个。常用做法是在循环内部捕获异常，而不是直接抛出中断整个for。

7. 从“能发”到“可靠”：办公场景邮件服务的生产级建议

7.1 上线前检查清单

当邮件发送模块从练习变成办公流程的一部分时，建议临上线前逐项确认：

• 是否已经在测试环境用最小收件人列表完成完整发送。
• SMTP 账号、授权码、服务器地址是否全部存放在环境变量或密钥管理中。
• 附件生成路径是否足够稳定，文件是否会在每次运行前被清理或覆盖。
• 正文模板中的日期、收件人姓名、指标数据是否填写正确。
• 日志里是否记录了每次发送的主题、收件人、状态、错误信息和耗时。
• 群发名单是否经过人工抽样复核，避免把内部邮件发到外部人员。
• 是否有独立于邮件频道的异常告警，比如日志文件变化或脚本退出码。
• 发送频率控制在服务商建议范围内，是否有退信处理策略。
• 是否配置了失败邮件队列，能否单独一键重发。
• 代码是否提交到了 Git 仓库，.env是否真的没有被提交进去。

这条清单不要求邮件服务在第一天就达到生产级，但每完成一项，都会降低一次邮件事故的概率。办公自动化里最难受的并不是大家不会写代码，而是“邮件发了，但发给了不该收的人”或者“报表没有生成，但脚本一直显示成功”。

7.2 发送结果记录的结构化方式

邮件发送次数多了以后，自然会产生一个问题：“这封邮件到底发给了谁？几天前的报表有没有漏发？”靠日志文本搜索可以应急，但不适合长期审计。更好的做法是引入一张数据库表或中间表，把发送结果变成一个结构化记录。

以 SQLite 为例，可以建一张简单的email_send_log表：

CREATE TABLE email_send_log ( id INTEGER PRIMARY KEY AUTOINCREMENT, job_id TEXT NOT NULL, subject TEXT NOT NULL, recipient TEXT NOT NULL, status TEXT NOT NULL, error_message TEXT, created_at TEXT NOT NULL, duration_ms INTEGER );

每个发送任务先创建job_id，再逐收件人写入发送状态。这样就能回答三类问题：某封邮件发给过谁、某个收件人失败了多久、某次批量任务整体成功率是多少。如果不需要数据库，也可以把每批次写成 JSON Lines 文件：

{"job_id": "JOB20250101_001", "recipient": "zhangsan@example.com", "status": "success", "error": ""}

7.3 学习环境与生产环境不要共用一套配置

学习阶段如果不想依赖公共邮箱，也可以使用 MailHog、Mailpit 这类本地测试服务器。它们会接收 Python 发送的 SMTP 请求，并在 Web 页面展示邮件内容，不会真的投递到外部。这样能把“代码逻辑”和“网络投递”分开调试，比较适合练习。

7.4 办公场景中进一步做厚邮件服务的几条思路

邮件发送模块稳定之后，可以向三个方向继续完善。

第一是模板化。把日报、周报、审批通知的正文做成独立模板文件，正文里引用日期、部门、数据字段。代码只负责读取数据和渲染模板，不负责把 HTML 拼在函数里，这样即使非程序员也能调整文案。

第二是抽象出统一发送接口。邮件只是通知渠道之一，未来可能还会对接企业微信机器人、钉钉或短信。为了让业务代码不依赖具体渠道，可以先定义一个send_notification(title, content, receiver, channel)的接口，内部再路由到邮件或其他实现。邮件服务不应因为未来扩展而一上来做成微服务，但至少要把“发送详情”与业务逻辑解耦。

第三是加入更完整的失败处理机制。包括失败重试、退信队列、定时统计成功率、超过阈值自动暂停。办公场景里，失败率很低但持续存在的单封失败容易被忽略，积累一个季度后可能已经漏送了十几份重要通知。加入每天一次的汇总邮件，就会把这些问题暴露出来。

7.5 始终记住：邮件服务是在替业务传递责任

邮件发送服务越可靠，越要清楚它在办公自动化链路中的边界。它不负责决定哪些数据是对的还是错的，也不负责判断收件人该不该收到某封邮件。它承担的是传输职责，因此要格外关注内容完整、收件身份、权限范围和审计记录。

对刚完成py100--lv2-089这个任务的开发者来说，最有价值的练习方式是把代码当成一个要运行半年以上的内部工具来对待。先跑通一封纯文本邮件，再扩展 HTML、附件和批量发送，然后补日志和异常处理，最后加入定时任务和配置管理。这个过程中遇到的问题，几乎都会在真实办公项目里再次遇到。

自动化真正解决的问题不是把“手工”替换成“脚本”，而是让每一次发送都留下记录、每一封投递失败都有排查路径、每一次文案调整都经过确认。邮件发送服务做到这一步，才算从办公自动化练习变成了办公基础设施。