Python案例怎么推送系统通知？

wen python案例 2026-06-06 61

Python案例：如何高效推送系统通知？一文掌握桌面与服务器端通知实现

📖 文章导读

为什么需要在Python中推送系统通知？ - 常见应用场景
Python推送系统通知的三种主流方式
- 桌面通知（Windows/macOS/Linux）
- 服务器端通知（Webhook、邮件、钉钉/微信机器人）
- 跨平台通知库 plyer 与 notify-py
实战案例一：用 plyer 在Windows/macOS/Linux发送桌面通知
实战案例二：通过 win10toast 实现Windows原生通知
实战案例三：利用 requests 发送企业微信机器人通知
常见问题与解答（FAQ）
SEO优化建议与总结

为什么需要在Python中推送系统通知？

在日常开发中,我们经常遇到这样的场景：

Python案例怎么推送系统通知？

脚本/程序执行完毕：用户希望知道耗时任务（如数据爬取、文件下载、模型训练）是否完成。
监控报警：服务器CPU或内存超阈值,需要立即通知运维人员。
自动化运维：定时任务执行成功或失败,需要发送提醒。
桌面应用：用户进行长时间操作后,希望弹出Toast通知提示结果。

Python作为最流行的胶水语言，提供了多种与操作系统交互的API，使得推送系统通知变得简单高效，根据Google搜索趋势，python send notification 相关搜索量在过去两年增长超过40%,可见这一需求非常普遍。

Python推送系统通知的三种主流方式

方式	适用平台	优点	缺点
`plyer`	Windows/macOS/Linux	跨平台统一API	macOS需安装额外库
`win10toast`	Windows 10/11	原生外观、交互性好	仅限Windows
Webhook/API	任意平台	可远程通知、集成方便	需要网络、第三方服务

核心区别：

桌面通知：用于用户本地设备,适合GUI应用或长时间后台任务。
服务器通知：通过HTTP请求发送到聊天工具（钉钉、微信、Slack）或邮件,适合远程运维。

实战案例一：跨平台桌面通知（plyer）

plyer 是Kivy社区维护的跨平台库，支持Windows、macOS、Linux。

安装：

pip install plyer

代码实现：

from plyer import notification
def send_plyer_notification(title: str, message: str, app_name: str = "Python通知"):
    """
    发送跨平台桌面通知
    :param title: 通知标题
    :param message: 通知正文
    :param app_name: 应用名称，部分平台会显示
    """
    try:
        notification.notify(
            title=title,
            message=message,
            app_name=app_name,
            timeout=10  # 通知持续秒数，macOS可能不生效
        )
    except Exception as e:
        print(f"通知发送失败: {e}")
# 使用示例
if __name__ == "__main__":
    send_plyer_notification(
        title="数据处理完成",
        message="今日销售数据已成功写入数据库，共处理1,234条记录。",
        app_name="DataPipeline"
    )

代码精讲：

timeout参数：在Windows上控制通知自动消失时间,Linux可能不支持。
异常捕获：如果用户系统缺少通知服务（如Linux无D-Bus）,不会阻塞程序。

实战案例二：Windows原生通知（win10toast）

如果你只需要Windows平台，win10toast 提供了更原生的Windows Toast通知样式,支持点击回调。

安装：

pip install win10toast

代码实现：

from win10toast import ToastNotifier
def send_windows_toast(title: str, message: str, duration: int = 5,
                       icon_path: str = None, threaded: bool = True):
    """
    发送Windows 10/11原生通知
    :param icon_path: 自定义图标路径（推荐ico格式）
    :param threaded: 是否线程内运行，建议True避免阻塞
    """
    toaster = ToastNotifier()
    try:
        toaster.show_toast(
            title=title,
            msg=message,
            duration=duration,
            icon_path=icon_path,
            threaded=threaded
        )
    except Exception as e:
        print(f"Windows通知失败: {e}")
# 使用示例
if __name__ == "__main__":
    send_windows_toast(
        title="更新提醒",
        message="软件v2.1.0已下载完成，点击安装。",
        duration=8,
        icon_path=r"C:\path\to\icon.ico"
    )

进阶技巧：

点击回调：win10toast 支持 callback_on_click 参数,可以绑定用户点击后打开指定页面。
线程安全：threaded=True 确保主程序不因通知弹窗而卡住。

实战案例三：服务器端通知（企业微信机器人）

对于远程运维场景，企业微信/钉钉机器人的Webhook是一种便捷选择，无需注册第三方邮件服务,免费且即时。

获取Webhook地址：

在企业微信中创建机器人 -> 复制Webhook URL（如 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx）。

安装requests（如未安装）：

pip install requests

代码实现：

import requests
import json
def send_wecom_notification(webhook_url: str, content: str, msg_type: str = "text"):
    """
    发送企业微信机器人通知
    :param webhook_url: 机器人Webhook地址
    :param content: 消息内容（支持Markdown）
    :param msg_type: 消息类型，text/markdown等
    """
    headers = {"Content-Type": "application/json"}
    if msg_type == "text":
        payload = {
            "msgtype": "text",
            "text": {"content": content}
        }
    elif msg_type == "markdown":
        payload = {
            "msgtype": "markdown",
            "markdown": {"content": content}
        }
    else:
        raise ValueError("仅支持text或markdown类型")
    try:
        response = requests.post(webhook_url, headers=headers, data=json.dumps(payload), timeout=10)
        if response.status_code == 200:
            print("通知发送成功")
        else:
            print(f"通知发送失败，状态码: {response.status_code}, 响应: {response.text}")
    except requests.exceptions.RequestException as e:
        print(f"网络异常: {e}")
# 使用示例
if __name__ == "__main__":
    webhook = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your_actual_key"
    message = "**警告**：服务器CPU使用率已超过90%，请及时排查。\n> 时间：2025-03-10 14:23\n> 实例：web-01"
    send_wecom_notification(webhook, message, msg_type="markdown")

代码精讲：

Markdown支持：企业微信机器人支持丰富的Markdown格式，可制作带标题、引用、列表的报警信息。
超时设置：timeout=10 避免网络问题导致程序挂起。
错误处理：检查返回状态码和响应体,便于调试。

常见问题与解答（FAQ）

❓ Q1：为什么我的plyer通知在macOS上不显示？

A：macOS下plyer依赖 pyobjc,需额外安装：

pip install pyobjc

如果仍无效，检查系统是否开启了“请勿打扰”模式或未授予通知权限。

❓ Q2：win10toast通知一闪而过，怎么设置常驻？

A：Windows Toast通知不能常驻，但可以通过设置较大的duration（如60秒）延长显示，如果需要永久显示，建议改用系统托盘图标方案（如 pystray）。

❓ Q3：服务器端通知如何确保送达？

A：可加入重试机制，例如使用 tenacity 库：

from tenacity import retry, stop_after_attempt, wait_fixed
@retry(stop=stop_after_attempt(3), wait=wait_fixed(2))
def send_with_retry(webhook_url, content):
    send_wecom_notification(webhook_url, content)