如何确保Tkinter Python可执行程序仅运行单个实例？

核心方案：基于本地套接字的进程检测与激活 #

相比psutil检测进程名的方式，本地套接字是更可靠的跨平台单实例实现方式——套接字绑定具有独占性，能精准判断实例是否存在，同时支持向已有实例发送激活信号，触发窗口前置聚焦。

完整实现代码 #

import socket
import sys
import os
import tkinter as tk
from tkinter import messagebox
import threading

# 生成跨平台的套接字标识
def get_socket_identifier():
    if sys.platform == 'win32':
        # Windows 使用本地回环TCP端口（避免命名管道的复杂处理）
        return ('localhost', 9999)
    else:
        # Linux/Unix 使用临时目录下的Unix域套接字文件
        return os.path.join('/tmp', 'tk_single_instance_app.sock')

# 尝试激活已有运行实例
def trigger_existing_instance(sock_id):
    try:
        if sys.platform == 'win32':
            s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
            s.connect(sock_id)
        else:
            s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
            s.connect(sock_id)
        s.send(b'activate')
        s.close()
        return True
    except (ConnectionRefusedError, FileNotFoundError):
        return False

def run_app():
    sock_id = get_socket_identifier()
    server_sock = None

    try:
        # 创建并绑定套接字
        if sys.platform == 'win32':
            server_sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
            server_sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
            server_sock.bind(sock_id)
        else:
            # Linux下清理残留的套接字文件
            if os.path.exists(sock_id):
                os.unlink(sock_id)
            server_sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
            server_sock.bind(sock_id)
        
        server_sock.listen(1)

        # 初始化Tkinter窗口
        root = tk.Tk()
        root.title("单实例Tk应用")
        root.geometry("400x300")

        # 将窗口前置并聚焦的函数
        def bring_window_to_front():
            root.attributes('-topmost', True)
            root.attributes('-topmost', False)
            root.focus_force()

        # 后台线程监听激活信号
        def listen_for_trigger():
            while True:
                conn, _ = server_sock.accept()
                data = conn.recv(1024)
                if data == b'activate':
                    # 用after将UI操作放到主循环执行
                    root.after(0, bring_window_to_front)
                conn.close()

        # 启动守护线程，随主进程退出自动结束
        threading.Thread(target=listen_for_trigger, daemon=True).start()

        root.mainloop()

    except socket.error:
        # 绑定失败，说明已有实例运行
        if trigger_existing_instance(sock_id):
            messagebox.showinfo("提示", "应用已在运行，将为您激活窗口")
        else:
            messagebox.showinfo("提示", "应用已在运行")
        sys.exit(1)
    finally:
        # 清理套接字资源
        if server_sock:
            server_sock.close()
        if sys.platform != 'win32' and os.path.exists(sock_id):
            os.unlink(sock_id)

if __name__ == "__main__":
    run_app()

关键细节说明 #

• 跨平台适配：Windows采用本地回环TCP端口，Linux采用Unix域套接字，均无需额外权限
• 窗口激活逻辑：通过-topmost属性强制窗口短暂置顶，再取消置顶，配合focus_force()确保窗口获得输入焦点
• 无阻塞监听：用守护线程处理套接字连接，不会阻塞Tkinter的主事件循环
• 资源清理：应用退出时自动关闭套接字，Linux下删除残留的套接字文件，避免下次启动绑定失败

PyInstaller打包提示 #

• 打包时无需特殊参数，PyInstaller会自动包含所需的标准库模块（socket、threading等）
• Windows下使用本地回环端口不会触发防火墙提示，无需额外配置

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