在Python的世界里，smtplib 是标准库中专门用于发送电子邮件的基石级模块。不同于yagmail这类第三方封装库，smtplib直接实现了RFC 821（SMTP协议），让你能够从最底层掌控邮件发送的每一个细节。虽然它的API比起yagmail略显“原始”，但正是这种“原始”给了你更大的灵活性和稳定性——没有黑盒封装，没有隐式的魔法行为，所有MIME类型、认证方式、连接策略都一目了然。

在实际生产环境中，smtplib的身影无处不在：金融交易系统中每一笔成交确认邮件；企业内部运维平台的巡检报告批量分发；SaaS平台用户注册后的验证链接投递；甚至你每天收到的GitHub通知邮件，背后都可能站着smtplib。它的核心价值在于零依赖、强可控、协议级别准确。对于需要定制化邮件头、特殊字符集处理、复杂附件结构的场景，smtplib + email 标准库的组合拳目前仍然是Python生态中最可靠的选择。

很多人误以为smtplib过于底层以至于难以使用，其实只要搭好 email 库构造邮件内容的桥梁，它就会变成你最得力的工具。

一、smtplib的安装

因为smtplib是Python的内置标准库，所以不需要任何安装步骤，只要你的Python环境正常，直接 import smtplib 即可使用。这一点让它特别适合那些没法随意安装第三方包的受限环境（比如某些银行的生产服务器）。

python

import smtplib
print(smtplib.__doc__)   # 查看模块文档

二、基本用法——从零手写第一封邮件

以下4个步骤，带你完成从建立连接到发送纯文本邮件的完整流程。

1. 连接SMTP服务器并开启安全模式

python

import smtplib

# 连接QQ邮箱的SMTP（使用SSL直接加密）
smtp_obj = smtplib.SMTP_SSL('smtp.qq.com', 465)
# 也可以使用普通SMTP再启动TLS：smtp = smtplib.SMTP('smtp.qq.com', 587); smtp.starttls()

2. 登录邮箱（使用授权码，而非原始密码）

python

sender = 'your_email@qq.com'
password = 'your_authorization_code'   # 从邮箱设置中获取
smtp_obj.login(sender, password)

3. 构造最简单的纯文本邮件（借助email库）

python

from email.message import EmailMessage

msg = EmailMessage()
msg['From'] = sender
msg['To'] = 'receiver@example.com'
msg['Subject'] = 'Python smtplib 测试邮件'
msg.set_content('你好，这是使用Python标准库smtplib发送的第一封邮件！')

4. 发送并断开连接

python

smtp_obj.send_message(msg)
smtp_obj.quit()
print("邮件发送成功！")

三、高级用法——真正发挥标准库的威力

smtplib的真正强大之处在于与 email 标准库的深度配合，可以实现HTML邮件、附件、内嵌图片、多收件人等复杂场景。

1. 发送HTML格式的邮件（同时带纯文本备用内容）

python

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

msg = MIMEMultipart('alternative')
msg['Subject'] = '新闻周报'
msg['From'] = sender
msg['To'] = receiver

# 纯文本版本与HTML版本共存，邮件客户端会自动选择渲染
text_part = MIMEText('您的邮件客户端不支持HTML显示，这是备用文本。', 'plain', 'utf-8')
html_part = MIMEText('<h2>📰 本周聚焦</h2><p>Python 3.13 性能提升显著！</p>', 'html', 'utf-8')
msg.attach(text_part)
msg.attach(html_part)

smtp_obj.send_message(msg)

2. 添加附件（支持任意类型的文件）

python

from email.mime.base import MIMEBase
from email import encoders
import os

filename = '季度报告.pdf'
with open(filename, 'rb') as f:
    part = MIMEBase('application', 'octet-stream')
    part.set_payload(f.read())
    encoders.encode_base64(part)
    part.add_header('Content-Disposition', f'attachment; filename="{os.path.basename(filename)}"')
    msg.attach(part)

3. 群发与密送

smtplib本身支持一次性将同一封邮件发送给多个收件人，通过 msg['To'] 和 msg['Cc'] 头字段实现可见性控制。

python

to_list = ['alice@corp.com', 'bob@corp.com']
cc_list = ['audit@corp.com']

msg['To'] = ', '.join(to_list)
msg['Cc'] = ', '.join(cc_list)

# 最终收件人集合（所有实际送达地址）
all_recipients = to_list + cc_list
smtp_obj.send_message(msg, from_addr=sender, to_addrs=all_recipients)

4. 使用异常处理增强健壮性

python

import smtplib

try:
    with smtplib.SMTP_SSL('smtp.gmail.com', 465) as server:
        server.login(sender, password)
        server.send_message(msg)
except smtplib.SMTPAuthenticationError:
    print("认证失败，请检查授权码或密码")
except smtplib.SMTPRecipientsRefused:
    print("收件人地址无效")
except Exception as e:
    print(f"发送失败: {e}")

四、三个深度的实际应用场景（附完整案例）

场景一：向全公司发送带Excel附件的销售日报（定时任务+数据驱动）

这个场景非常适合销售助理或运营人员，每天17:00自动抓取数据库中的当日业绩，生成Excel并群发给销售团队。

python

import smtplib
import pandas as pd
from email.message import EmailMessage
from datetime import datetime
import schedule
import time

def send_daily_sales():
    # 模拟从数据库或API获取数据
    data = {
        '销售代表': ['张三', '李四', '王五'],
        '订单金额': [23000, 18500, 42000],
        '完成率': [0.92, 0.74, 1.08]
    }
    df = pd.DataFrame(data)
    filename = f'sales_{datetime.now().strftime("%Y%m%d")}.xlsx'
    df.to_excel(filename, index=False)
    
    msg = EmailMessage()
    msg['Subject'] = f'销售日报 {datetime.now().strftime("%Y-%m-%d")}'
    msg['From'] = 'data_robot@company.com'
    msg['To'] = 'sales_team@company.com'
    msg.set_content('各位同事，今日销售数据见附件。')
    
    with open(filename, 'rb') as f:
        msg.add_attachment(f.read(), maintype='application', subtype='vnd.openxmlformats-officedocument.spreadsheetml.sheet', filename=filename)
    
    with smtplib.SMTP_SSL('smtp.company.com', 465) as server:
        server.login('data_robot@company.com', 'auth_code')
        server.send_message(msg)
    print(f'{datetime.now()} 日报已发出')

# 每天17:00执行（需要保持脚本运行或配合cron）
schedule.every().day.at("17:00").do(send_daily_sales)
while True:
    schedule.run_pending()
    time.sleep(60)

场景二：智能家居异常警报系统

假设你家里有温度传感器和漏水传感器，一旦检测到异常，立即通过smtplib发送警报邮件，让你即使在外旅游也能第一时间知情。

python

import smtplib
import random
from email.message import EmailMessage
import time

def check_home_sensors():
    # 模拟读取传感器（实际可对接GPIO或API）
    fake_temperature = random.uniform(18, 35)
    water_leak = random.choice([True, False])  # 模拟漏水检测
    
    if fake_temperature > 30 or water_leak:
        msg = EmailMessage()
        msg['Subject'] = '🏠 家庭安全警报'
        msg['From'] = 'home_bot@personal.com'
        msg['To'] = 'owner@gmail.com'
        alert_body = f'异常报告:\n室温: {fake_temperature:.1f}°C\n漏水: {"是" if water_leak else "否"}'
        msg.set_content(alert_body)
        
        with smtplib.SMTP_SSL('smtp.gmail.com', 465) as server:
            server.login('home_bot@gmail.com', 'app_password')
            server.send_message(msg)
        print("警报邮件已发送！")
    else:
        print("一切正常")

# 每10分钟检查一次
while True:
    check_home_sensors()
    time.sleep(600)

场景三：GitHub仓库变更通知（监控指定仓库的commit）

作为技术Leader，你可能需要知道核心代码库的每一次push。利用smtplib配合GitHub API，当指定分支有新提交时立刻邮件通知。

python

import smtplib
import requests
import hashlib
from email.message import EmailMessage
import time

repo = 'python/cpython'
branch = 'main'
last_commit_hash = None

def check_new_commits():
    global last_commit_hash
    url = f'https://api.github.com/repos/{repo}/commits/{branch}'
    response = requests.get(url).json()
    latest_hash = response['sha']
    
    if last_commit_hash is None:
        last_commit_hash = latest_hash
        return
    
    if latest_hash != last_commit_hash:
        msg = EmailMessage()
        msg['Subject'] = f'📦 仓库 {repo} 有新提交'
        msg['From'] = 'monitor@devops.com'
        msg['To'] = 'tech_team@company.com'
        commit_info = f'作者: {response["commit"]["author"]["name"]}\n消息: {response["commit"]["message"]}\n链接: {response["html_url"]}'
        msg.set_content(commit_info)
        
        with smtplib.SMTP_SSL('smtp.exmail.qq.com', 465) as server:
            server.login('monitor@devops.com', 'token')
            server.send_message(msg)
        last_commit_hash = latest_hash
        print("新commit通知已发送")
    else:
        print("无新提交")

# 每5分钟检查一次
while True:
    check_new_commits()
    time.sleep(300)

五、尾声与互动

smtplib作为Python标准库中最古老也最稳定的组件之一，它不会主动帮你猜测用户名或自动处理附件mimetype，但正是这种“不替你做决定”的设计哲学，赋予了你完全的掌控力。无论你是要对接Exchange的特殊认证方案，还是要实现自定义的SMTP扩展命令，smtplib都能胜任。它把简单的事情保持简单（纯文本邮件只需几行代码），把复杂的事情变得可能（任何符合RFC的邮件结构都能构造）。

恭喜你，现在已经掌握了从零构建企业级邮件自动化系统的内核能力。那么，你想用它来做什么呢？是写一个监听服务器日志、发现ERROR级别日志就立刻发邮件的告警机器人？还是写一个每天自动抓取你关注的arXiv新论文并整理成摘要发送到邮箱的学术助手？又或者是给家里的老人写一个“一键报平安”的脚本，只要按下树莓派上的按钮，就能向你发送GPS定位与健康数据？大胆去实现吧——技术真正的价值，在于解决那些让你在意的实际问题。如果在代码调试中遇到 SMTPException 或者编码乱码的坑，欢迎在评论区贴出报错信息，我们一起讨论最佳实践。