在桌面自动化或快捷键工具开发中，我们往往不希望程序一启动就全局捕获键盘，而是仅在某个特定窗口处于激活状态时才开启 pynput 的监听，同时把系统原有的按键输入屏蔽掉，防止干扰用户其他操作。实现这一目标需要解决两个问题：一是准确感知窗口的激活与失焦，二是在监听过程中拦截并丢弃按键事件。
一、为什么不能直接全局监听
pynput.keyboard.Listener 一旦启动，就会向系统注册底层钩子，所有按键都会先经过我们的回调。如果在任意时刻都开启，用户写文档、切软件时按键可能被吞或触发脚本逻辑，体验很差。更严重的是，若脚本自身依靠键盘模拟去操作目标窗口，全局监听会形成递归捕获，导致线程阻塞或死循环。
因此合理的做法是：程序空闲时不挂钩子，仅当目标窗口成为前台窗口才启动 Listener；窗口失去焦点时立即停止。这样既能精准控制作用范围，也降低了系统资源占用。判断窗口状态在 Windows 下最可靠的方式是使用 pywin32 调用系统 API。
二、检测窗口激活状态
我们可以用 win32gui.GetForegroundWindow 获取当前前台窗口句柄，再用 GetWindowText 读取标题，或者比较句柄是否等于目标进程窗口。下面代码演示如何轮询检测某个标题包含“记事本”的窗口是否激活：
import win32gui
import time
def is_target_active(keyword):
# 获取当前前台窗口句柄
hwnd = win32gui.GetForegroundWindow()
if hwnd == 0:
return False
title = win32gui.GetWindowText(hwnd)
# 标题中包含关键字则认为是目标窗口
return keyword in title
if __name__ == '__main__':
while True:
if is_target_active('记事本'):
print('目标窗口已激活')
else:
print('目标窗口未激活')
time.sleep(1)
上面的函数每秒检查一次，实际项目中可以把轮询间隔缩短到 0.2 秒，或者结合 win32gui 的 SetWinEventHook 监听焦点切换事件，避免忙等。拿到激活状态后，我们就能决定何时启动或停止 pynput 的 Listener。
需要注意的是，某些程序标题会动态变化，比如浏览器带上网页标题。此时更稳妥的是通过进程 ID 比对：用 GetWindowThreadProcessId 取前台窗口的 pid，再和自己启动的目标进程 pid 比较，这样不受标题改动影响。
三、在激活时启用监听并屏蔽输入
pynput 的 on_press 回调如果返回 False，Listener 会停止；但我们想要的是“屏蔽系统输入但继续监听”，所以不能在首次按键就返回 False 退出，而是始终返回 None 表示不终止监听，同时不把事件传给系统。实际上 pynput 的底层钩子默认就会拦截，只要我们不手动转发，系统就收不到该按键。
以下示例展示了一个管理类，窗口激活时调用 start，失焦时调用 stop，在监听中直接吞掉所有按键：
from pynput import keyboard
import win32gui
import time
class WindowScopedListener:
def __init__(self, keyword):
self.keyword = keyword
self.listener = None
def _on_press(self, key):
# 此处可加入自定义逻辑，例如记录按键
# 返回 None 且不转发即可屏蔽系统输入
return None
def _is_active(self):
hwnd = win32gui.GetForegroundWindow()
if hwnd == 0:
return False
return self.keyword in win32gui.GetWindowText(hwnd)
def start(self):
if self.listener is None:
self.listener = keyboard.Listener(on_press=self._on_press)
self.listener.start()
print('监听已启动，系统输入被屏蔽')
def stop(self):
if self.listener is not None:
self.listener.stop()
self.listener = None
print('监听已停止')
def run(self):
try:
while True:
if self._is_active():
if self.listener is None:
self.start()
else:
if self.listener is not None:
self.stop()
time.sleep(0.2)
except KeyboardInterrupt:
self.stop()
if __name__ == '__main__':
manager = WindowScopedListener('记事本')
manager.run()
运行后，只有当记事本窗口在最前时，键盘事件才会被 Listener 捕获且不会落到系统；切到其他窗口，Listener 销毁，输入恢复正常。如果只想屏蔽部分按键，可在 _on_press 里判断 key 是不是指定组合，非目标按键可调用系统底层 API 转发，但 pynput 本身不提供转发能力，需要借助 SendInput 另行实现。
这种设计的优点是逻辑清晰、无界面依赖；缺点是轮询稍微占 CPU，高频场景建议改用事件钩子。另外在 macOS 或 Linux 上，窗口检测需使用对应平台的库，如 macOS 的 AppKit 或 Linux 的 Xlib，但 pynput 屏蔽输入的方式是一致的。
四、常见误区与注意事项
有人尝试用 keyboard 模块代替 pynput，但 keyboard 在Windows下同样全局钩子，且屏蔽需要写 block_key，粒度较粗。pynput 的 Listener 对象非线程安全，stop 必须在不同线程或主循环里调用，不能在被拦截的回调中直接 stop 自己，否则可能抛异常。
还有一个坑：若脚本以管理员权限运行，而目标窗口是普通权限，GetForegroundWindow 可能返回 0 或无法读取标题，此时需要提权一致或改用 pid 匹配。调试阶段建议打印 hwnd 与 title 确认检测逻辑正确，再接入屏蔽，避免把自己系统锁死。
| 方案 | 优点 | 缺点 |
|---|---|---|
| 轮询前台窗口 | 实现简单，兼容性好 | 有轻微 CPU 占用 |
| WinEventHook 监听 | 实时响应，无忙等 | 代码复杂，需处理回调线程 |
| pid 比对 | 不受标题变化影响 | 需先获取目标 pid |
综合来看，小型工具用轮询加标题或 pid 检测已经足够。当你的自动化脚本需要在特定窗口内独占键盘时，上述模式能稳妥地做到“激活才监听、失焦即释放、输入可屏蔽”。