Python批量打包发送文件夹：zip后自动发送邮件附件

用Python把文件夹压缩成zip，再通过smtplib自动作为邮件附件发送，一键完成打包+发送，完整可运行代码。

场景痛点

每周要把项目文件夹打包成zip，然后作为附件发给客户或领导。手动压缩、打开邮箱、上传附件、填写收件人，一套流程下来十几分钟。用Python脚本把这两步串起来：自动压缩文件夹，自动发邮件带附件，跑一下就完事。

用到的库

zipfile    # 标准库，打包
pathlib    # 标准库
smtplib    # 标准库，发邮件
email      # 标准库，构造邮件

完整代码

import smtplib
import zipfile
from pathlib import Path
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email import encoders


def zip_folder(folder_path: str, output_zip: str) -> str:
"""把整个文件夹打包成zip"""
src = Path(folder_path).resolve()
out = Path(output_zip)
out.parent.mkdir(parents=True, exist_ok=True)

with zipfile.ZipFile(out, 'w', zipfile.ZIP_DEFLATED) as zf:
for file in src.rglob('*'):
if file.is_file():
# arcname保留文件夹名作为顶层目录
arcname = Path(src.name) / file.relative_to(src)
zf.write(file, arcname=str(arcname))
print(f"打包完成: {out}")
return str(out)


def send_email_with_attachment(
smtp_host: str,
smtp_port: int,
sender: str,
password: str,
recipients: list,
subject: str,
body: str,
attachment_path: str
):
"""发送带附件的邮件"""
msg = MIMEMultipart()
msg['From'] = sender
msg['To'] = ', '.join(recipients)
msg['Subject'] = subject

# 邮件正文
msg.attach(MIMEText(body, 'plain', 'utf-8'))

# 添加附件
p = Path(attachment_path)
part = MIMEBase('application', 'octet-stream')
part.set_payload(p.read_bytes())
encoders.encode_base64(part)
# filename用UTF-8编码，避免中文文件名乱码
part.add_header('Content-Disposition', f'attachment; filename="{p.name}"')
msg.attach(part)

# 连接SMTP服务器发送
with smtplib.SMTP_SSL(smtp_host, smtp_port) as server:
server.login(sender, password)
server.sendmail(sender, recipients, msg.as_string())
print("邮件发送成功")


if __name__ == "__main__":
# 第一步：打包文件夹
zip_file = zip_folder(
folder_path="./本周报表",
output_zip="./output/本周报表.zip"
)

# 第二步：发送邮件
send_email_with_attachment(
smtp_host="smtp.qq.com",
smtp_port=465,
sender="your@qq.com",
password="邮箱授权码",
recipients=["boss@example.com"],
subject="本周报表",
body="领导好，附件是本周报表打包，请查收。",
attachment_path=zip_file
)

代码讲解

zip_folder：遍历文件夹所有文件，用arcname = src.name / relative_path保证压缩包里以文件夹名作为顶层目录，解压后不会散落一堆文件。
MIMEMultipart：多部分邮件容器，可以同时放正文和附件。
MIMEBase + encoders.encode_base64：把附件二进制内容用Base64编码，这是邮件传输附件的标准格式。
smtplib.SMTP_SSL：用SSL加密连接SMTP服务器。QQ邮箱用smtp.qq.com:465，163邮箱用smtp.163.com:465，企业微信邮箱对应各自地址。
邮箱密码用的是授权码不是登录密码，在邮箱设置里开启SMTP服务后生成。