使用pynput时线程与热键响应问题及二次启动报错求助

初始实现与问题 #

我尝试用pynput库监听热键：按下F12启动线程，该线程在控制台无限循环打印消息；按下ESC停止应用。Example类继承Thread并重写run方法，代码如下：

src/index.py #

import pynput
from lib.listener import HotkeyListener

if __name__ == "__main__":
    on_press = HotkeyListener()
    listener = pynput.keyboard.Listener(on_press=on_press.on_press, suppress=True)
    listener.run()

listener.py #

from .Example import Example
import pynput

class HotkeyListener:
    def __init__(self):
        self.example = Example()

    def on_press(self, key):
        if key == pynput.keyboard.Key.f12:
            print("Starting Thread...")
            self.example.start()

        if key == pynput.keyboard.Key.esc:
            self.example.join()
            print("Exiting application...")
            return False  # 停止监听器

example.py #

from threading import Thread
from .delay import rand_sleep

class Example(Thread):
    def run(self):
        while True:
            print("Hello, I am an Example :) ?")  # 该消息会输出到控制台
            rand_sleep(1, 2)

初始问题

按下F12启动线程后，应用无法响应ESC等其他热键，同时有以下疑问：

1. 如何让线程运行时应用仍能响应其他热键？
2. 该场景下正确的线程管理方式是什么，避免无限循环卡顿？
3. 有没有更高效的热键监听+线程实现方式？

更新后的问题 #

参考回复后实现了可用方案，但再次按F12启动线程时出现RuntimeError: threads can only be started once，代码如下：

from threading import Thread, Event, Number
from .delay import rand_sleep

class Example(Thread):
    def __init__(self, event: Event) -> None:
        super().__init__()
        self.event = event

    def run(self):
        counter: Number = 0
        while not self.event.is_set():
            print("Hello, I am an Example :)? ")
            rand_sleep(1, 2)
            counter += 1
            if counter > 5:
                self.event.set()
                
class HotkeyListener:
    def __init__(self):
        self.thread_event = threading.Event()
        self.example = Example(self.thread_event)

    def on_press(self, key):
        if key == pynput.keyboard.Key.f12:
            print("---------------------", self.example)
            # 输出示例：--------------------- <Example(Thread-1, stopped 9676)>
            self.example.start()

        if key == pynput.keyboard.Key.esc:
            self.thread_event.set()
            self.example.join()
            print("Exiting application...")
            return False  # 停止监听器

解决方案 #

针对初始问题的解答 #

1. 让线程运行时响应其他热键
   初始代码的核心问题是：ESC按键回调里调用self.example.join()会阻塞监听线程（pynput的监听器逻辑在单独线程执行），而Example线程是无限循环，导致监听线程被卡死，无法处理后续按键。
   解决方式：不要在按键回调里调用join()，改用threading.Event作为线程停止信号，让线程自行判断退出时机，避免阻塞监听线程。

2. 正确的线程管理方式

   • 使用threading.Event替代while True，通过事件状态控制线程启停，实现优雅终止。
   • 将线程设为守护线程（daemon=True），主线程退出时守护线程会自动终止，避免程序无法正常退出。
   • 线程的等待（join()）逻辑放在主线程中执行，不要占用监听线程的资源。

3. 更高效的热键监听+线程实现方式

   • 用pynput的HotKey类替代直接在on_press中判断按键，代码更简洁且监听效率更高。
   • 线程实例按需创建，每次启动新线程时生成新的实例，避免重复启动问题。
   • 分离热键监听与线程控制逻辑，降低代码耦合度。

针对更新后RuntimeError的解决 #

同一个Thread实例只能调用一次start()，线程结束后无法再次启动，这是报错的核心原因。解决方法如下：

修改HotkeyListener逻辑，动态管理线程实例

from threading import Thread, Event
import pynput
from .Example import Example

class HotkeyListener:
    def __init__(self):
        self.thread_event = Event()
        self.example_thread = None

    def on_press(self, key):
        if key == pynput.keyboard.Key.f12:
            # 检查当前线程是否处于运行状态
            if not self.example_thread or not self.example_thread.is_alive():
                # 重置停止事件
                self.thread_event.clear()
                # 创建新的线程实例并启动
                self.example_thread = Example(self.thread_event)
                self.example_thread.start()
                print("启动新线程...")
            else:
                print("线程已在运行！")

        if key == pynput.keyboard.Key.esc:
            if self.example_thread and self.example_thread.is_alive():
                self.thread_event.set()
                self.example_thread.join()
            print("退出应用...")
            return False  # 停止监听器

修改Example类，优化线程终止逻辑

from threading import Thread, Event
from .delay import rand_sleep

class Example(Thread):
    def __init__(self, event: Event) -> None:
        super().__init__(daemon=True)  # 设置为守护线程
        self.event = event

    def run(self):
        counter = 0
        while not self.event.is_set():
            print("Hello, I am an Example :)? ")
            rand_sleep(1, 2)
            counter += 1
            if counter > 5:
                self.event.set()
        print("示例线程已停止。")

优化后的完整流程 #

1. 按下F12时，自动检查线程状态，仅在未运行时创建新实例并启动，避免重复启动报错。
2. 线程通过Event状态判断是否继续运行，能优雅终止，不会出现无限循环卡顿。
3. 按下ESC时，先发送停止信号等待线程结束，再退出监听器，主线程随之正常退出。
4. 线程设为守护线程，即使主线程意外退出，线程也会自动终止，避免资源泄漏。

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