如何创建仅单实例运行且可唤起已有窗口的wxPython应用？

我之前也遇到过这个需求，wx.SingleInstanceChecker确实只能阻止多实例，但要实现唤起已有窗口，核心是要加上进程间通信（IPC），让第二个实例通知第一个实例激活窗口。下面是一个跨平台的完整实现方案：

核心思路 #

1. 用wx.SingleInstanceChecker检测是否已有实例运行；
2. 第一个实例启动一个后台TCP服务器，监听特定端口等待激活信号；
3. 第二个实例检测到已有实例时，向该端口发送激活信号后退出；
4. 第一个实例收到信号后，在UI线程中激活并聚焦主窗口。

完整代码示例 #

import wx
import socket
import threading

# 定义一个唯一的IPC端口，选一个不常用的端口避免冲突
IPC_PORT = 9999

class SingleInstanceApp(wx.App):
    def OnInit(self):
        # 初始化单实例检查器，用带端口的唯一标识避免冲突
        self.instance_checker = wx.SingleInstanceChecker(f"wxSingleInstanceDemo-{IPC_PORT}")
        
        if self.instance_checker.IsAnotherRunning():
            # 向已有实例发送激活信号
            self._send_activate_signal()
            return False  # 退出当前实例

        # 启动后台IPC服务器监听激活信号
        self._start_ipc_server()

        # 创建主窗口
        self.main_frame = wx.Frame(None, title="单实例WxApp", size=(400, 300))
        self.main_frame.Show()
        return True

    def _start_ipc_server(self):
        """在后台线程启动TCP服务器，避免阻塞UI"""
        def server_runner():
            server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
            # 设置端口复用，避免程序退出后端口残留
            server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
            server_socket.bind(("localhost", IPC_PORT))
            server_socket.listen(1)

            while True:
                client_conn, _ = server_socket.accept()
                # 读取客户端发送的信号
                signal = client_conn.recv(1024).decode().strip()
                if signal == "ACTIVATE_WINDOW":
                    # 必须用wx.CallAfter在UI线程执行窗口操作
                    wx.CallAfter(self._activate_main_window)
                client_conn.close()

        # 启动守护线程，主程序退出时自动结束
        server_thread = threading.Thread(target=server_runner, daemon=True)
        server_thread.start()

    def _send_activate_signal(self):
        """向已有实例的IPC服务器发送激活信号"""
        try:
            client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
            client_socket.connect(("localhost", IPC_PORT))
            client_socket.send(b"ACTIVATE_WINDOW")
            client_socket.close()
        except ConnectionRefusedError:
            # 可能已有实例正在退出，无需处理
            pass

    def _activate_main_window(self):
        """激活并聚焦主窗口的逻辑"""
        frame = self.main_frame
        # 如果窗口最小化，先恢复
        if frame.IsIconized():
            frame.Iconize(False)
        # 将窗口提升到前台
        frame.Raise()
        # 设置焦点到窗口
        frame.SetFocus()
        # 可选：让任务栏图标闪烁提醒用户
        frame.RequestUserAttention(wx.USER_ATTENTION_INFO)

if __name__ == "__main__":
    app = SingleInstanceApp()
    app.MainLoop()

关键细节说明 #

• 端口选择：选一个不常用的端口（比如9999），如果担心冲突，可以把端口号写入临时文件，让第二个实例读取，但固定端口实现更简单。
• 线程安全：后台服务器线程不能直接操作UI控件，必须用wx.CallAfter把操作放到UI线程执行，否则会导致程序崩溃。
• 跨平台兼容：TCP Socket在Windows、Linux、macOS上都能正常工作，相比系统特定的API（比如Windows的Win32消息）更通用。
• 守护线程：服务器线程设置为daemon=True，这样主程序退出时线程会自动终止，不会残留后台进程。

测试方法 #

1. 运行脚本，打开主窗口；
2. 再次运行脚本，此时不会弹出新窗口，而是已有窗口会被激活并聚焦（如果最小化会恢复）。

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