如何使用Tkinter/Python检测键盘/鼠标按下的按键？

核心逻辑是点击录制按钮后进入捕获状态，临时全局监听所有键盘、鼠标按下事件，拿到第一个触发的按键后立刻退出捕获状态、移除临时监听，再将捕获到的按键和目标操作做绑定即可。

• 不要硬编码按键名称，捕获事件时直接从事件对象提取keysym（键盘）或num（鼠标按键）字段生成标准Tkinter绑定序列，避免不同系统、键盘布局带来的兼容问题
• 捕获阶段要拦截事件传递，避免按下的按键触发其他已绑定的功能
• 录制时要给用户明确的状态提示，比如点击按钮后将按钮文字改为「请按下任意按键/鼠标键...」，捕获完成后再恢复
• 临时监听要用bind_all做全局绑定，不要只绑定按钮组件，否则点击其他区域时无法捕获事件

import tkinter as tk
from tkinter import ttk, messagebox

class CustomKeyBinder:
    def __init__(self, root):
        self.root = root
        self.root.title("自定义按键绑定演示")
        self.is_capturing = False
        self.current_bind_key = None
        self.temp_bind_list = []

        # 基础界面
        ttk.Label(root, text="绑定操作：触发提示弹窗").pack(padx=20, pady=10)
        self.capture_btn = ttk.Button(root, text="点击录制触发按键", command=self.start_capture)
        self.capture_btn.pack(padx=20, pady=5)
        self.key_status = ttk.Label(root, text="当前绑定：未设置", foreground="gray")
        self.key_status.pack(padx=20, pady=10)

    def start_capture(self):
        # 进入捕获状态
        self.is_capturing = True
        self.current_bind_key = None
        self.capture_btn.config(text="请按下任意按键/鼠标键...")
        # 临时绑定所有键盘、鼠标按下事件
        self.temp_bind_list.append(self.root.bind_all("<KeyPress>", self.capture_event, add="+"))
        # 覆盖常用鼠标按键：左/中/右/滚轮/侧键
        for mouse_event in ["<ButtonPress-1>", "<ButtonPress-2>", "<ButtonPress-3>",
                            "<ButtonPress-4>", "<ButtonPress-5>", "<ButtonPress-6>", "<ButtonPress-7>"]:
            self.temp_bind_list.append(self.root.bind_all(mouse_event, self.capture_event, add="+"))

    def capture_event(self, event):
        if not self.is_capturing:
            return
        # 生成绑定序列和显示名称
        if event.type == tk.EventType.KeyPress:
            bind_seq = f"<KeyPress-{event.keysym}>"
            show_name = event.keysym
        else:
            bind_seq = f"<ButtonPress-{event.num}>"
            mouse_name_map = {
                1: "鼠标左键", 2: "鼠标中键", 3: "鼠标右键",
                4: "滚轮上滚", 5: "滚轮下滚",
                6: "鼠标侧键(后退)", 7: "鼠标侧键(前进)"
            }
            show_name = mouse_name_map.get(event.num, f"鼠标按键{event.num}")
        
        # 退出捕获状态，清空临时绑定
        self.is_capturing = False
        for bind_id in self.temp_bind_list:
            self.root.unbind(bind_id)
        self.temp_bind_list.clear()

        # 绑定新按键到目标操作，先解绑旧绑定避免重复
        if self.current_bind_key:
            self.root.unbind_all(self.current_bind_key)
        self.current_bind_key = bind_seq
        self.root.bind_all(bind_seq, self.target_action)

        # 更新界面状态
        self.capture_btn.config(text="点击重新录制触发按键")
        self.key_status.config(text=f"当前绑定：{show_name}", foreground="black")
        # 拦截事件，避免触发其他默认逻辑
        return "break"

    def target_action(self, event):
        # 这里替换成你需要触发的自定义操作
        messagebox.showinfo("触发成功", "已按下绑定的按键")

if __name__ == "__main__":
    root = tk.Tk()
    app = CustomKeyBinder(root)
    root.mainloop()

• 鼠标事件不要只绑定左键，需要覆盖中键、右键、滚轮、常用侧键，否则用户按这些按键时无法捕获
• 重新绑定新按键前一定要解绑旧的按键绑定，否则会出现多个按键同时触发同一操作的问题
• 捕获事件的回调函数最后要返回"break"，阻止事件继续传播，否则捕获阶段按下的按键会触发其他组件的默认行为，比如在输入框中录入字符、点击触发其他按钮等
• 不要使用bind绑定单个组件，必须用bind_all做全局绑定，否则焦点不在目标组件上时无法捕获按键

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