Python后台应用：系统托盘/菜单栏图标显示后代码无法执行排查

绝大多数系统托盘库的启动函数（比如pystray的run()、rumps的run()）都是阻塞式调用——它会持续占用当前线程处理托盘的交互事件（菜单点击、图标 hover 等），导致线程卡在这个函数里，后续的循环任务代码根本没机会执行。

把系统托盘的启动逻辑放到单独线程里运行，让主线程（或另一个独立线程）去执行你的长期循环任务，两者互不阻塞。

代码调整示例 #

main.py 修改 #

import threading
import time
from systray import start_systray

def long_running_task():
    # 你的后台循环任务逻辑
    while True:
        print("后台任务正在运行...")
        time.sleep(3)

if __name__ == "__main__":
    # 把托盘启动放到子线程，daemon=True确保主线程结束时托盘线程自动退出
    tray_thread = threading.Thread(target=start_systray, daemon=True)
    tray_thread.start()
    
    # 主线程执行后台任务
    long_running_task()

systray.py 调整（以pystray为例） #

import pystray
from PIL import Image

def start_systray():
    # 加载托盘图标
    icon_img = Image.open("app_icon.png")
    
    # 定义菜单操作
    def quit_app(icon, item):
        icon.stop()
    
    def show_version(icon, item):
        print("应用版本：v1.2.0")
    
    # 创建菜单
    menu_items = (
        pystray.MenuItem("查看版本", show_version),
        pystray.MenuItem("退出应用", quit_app)
    )
    
    # 启动托盘（这里的run()会阻塞当前子线程，但不影响主线程）
    tray_icon = pystray.Icon("background_app", icon_img, "后台应用", menu_items)
    tray_icon.run()

关键注意事项 #

• 标记托盘线程为daemon=True：避免主线程结束后，托盘线程残留导致程序无法正常退出。
• 如果任务需要和托盘交互（比如更新托盘提示文本），要加threading.Lock()保证线程安全，防止竞态问题。
• 不管用pystray跨平台库，还是Windows的pywin32、macOS的rumps，核心思路都是把托盘的阻塞启动逻辑放到独立线程里。

内容的提问来源于stack exchange，提问作者Tom