如何从外部唤起Windows系统托盘内的Python Tkinter单实例应用

核心思路 #

通过Windows系统的**互斥量（Mutex）**检测是否已有应用实例在运行，若存在则向后台实例发送消息触发窗口唤起，新实例直接退出；若不存在则正常启动应用。

步骤1：安装依赖 #

需要pywin32库实现系统级互斥量和消息通信：

pip install pywin32

步骤2：修改代码实现单实例控制 #

以下是完整的修改后代码，关键逻辑已添加注释：

import tkinter as tk
from tkinter import Tk
from PIL import Image, ImageTk
import pystray
import win32api
import win32con
import win32mutex
import win32gui

# 全局唯一互斥量名称，避免与其他应用冲突
MUTEX_NAME = "Global\\EdboxTrackerAppMutex"
# 自定义消息标识，用于触发窗口显示
WM_SHOW_MY_WINDOW = win32con.WM_USER + 1001

def find_running_instance():
    """枚举系统窗口，找到已运行的应用主窗口句柄"""
    def window_callback(handle, extra_data):
        window_title = win32gui.GetWindowText(handle)
        # 匹配主窗口标题，需与App类中设置的title一致
        if window_title == "Edbox Tracker":
            extra_data.append(handle)
        return True
    
    handles = []
    win32gui.EnumWindows(window_callback, handles)
    return handles[0] if handles else None

class App:
    def __init__(self):
        self.root = Tk()
        self.root.title("Edbox Tracker")  # 设置主窗口标题，用于后续查找
        self.system_tray_icon = None
        # rest of your code
        # ...

        # 注册自定义消息的处理函数
        self.root.bind(f"<Message>{WM_SHOW_MY_WINDOW}", self.on_show_trigger)
        # 获取主窗口句柄
        self.window_handle = self.root.winfo_id()

        # 绑定窗口关闭事件到隐藏逻辑
        self.root.protocol("WM_DELETE_WINDOW", self.hide_window)

        # 初始化托盘菜单
        self.menu = (
            pystray.MenuItem('Quit', self.quit_window),
            pystray.MenuItem('Show', self.show_window_action)
        )

    def on_show_trigger(self, event):
        """收到唤起消息时，执行窗口显示逻辑"""
        self.show_window_action(None, None)

    def show_window_action(self, icon, item):
        if self.system_tray_icon:
            self.system_tray_icon.stop()
        self.root.deiconify()
        # 将窗口激活并放到前台
        win32api.SetForegroundWindow(self.window_handle)
        # 更新托盘菜单（移除Show选项）
        image = Image.open("hrm.ico")
        self.menu = [item for item in self.menu if item.text != 'Show']
        self.system_tray_icon = pystray.Icon("name", image, "Edbox Tracker", self.menu)

    def hide_window(self):
        self.root.withdraw()
        # 更新托盘菜单（恢复Show选项）
        image = Image.open("hrm.ico")
        self.menu = (
            pystray.MenuItem('Quit', self.quit_window),
            pystray.MenuItem('Show', self.show_window_action)
        )
        self.system_tray_icon = pystray.Icon("name", image, "Edbox Tracker", self.menu)
        # 后台线程运行托盘，避免阻塞Tk主循环
        import threading
        threading.Thread(target=self.system_tray_icon.run, daemon=True).start()

    def quit_window(self, icon, item):
        self.system_tray_icon.stop()
        self.root.destroy()

if __name__ == "__main__":
    try:
        # 创建全局互斥量，检测是否已有实例运行
        mutex = win32mutex.CreateMutex(None, False, MUTEX_NAME)
        if win32api.GetLastError() == win32con.ERROR_ALREADY_EXISTS:
            # 找到后台实例的窗口句柄
            running_handle = find_running_instance()
            if running_handle:
                # 发送自定义消息触发窗口唤起
                win32api.SendMessage(running_handle, WM_SHOW_MY_WINDOW, 0, 0)
            # 新实例直接退出
            exit(0)
    except Exception as e:
        print(f"实例检测失败: {e}")
        exit(1)

    # 无现有实例，正常启动应用
    app = App()
    app.root.mainloop()

关键细节说明 #

1. 互斥量检测：Global\\前缀确保在多用户环境下也能正确检测实例。
2. 窗口查找：通过窗口标题匹配后台实例，需保证主窗口标题唯一。
3. 消息通信：自定义消息避免与系统内置消息冲突，触发后台实例的show_window_action逻辑。
4. 托盘线程优化：将托盘运行放到后台线程，解决原代码中托盘阻塞Tk主循环的问题。

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