Linux Mint 22.1 Cinnamon下Python Keybinder绑定Super+V首次失效问题

在Linux Mint 22.1 Cinnamon环境下，使用Python的gi.repository.Keybinder或Xlib库绑定Super+V组合键时，首次按下只会在文本区域输入小写字母v，第二次按下才会触发自定义的按键处理逻辑（输出Key was pressed!）。其他组合键（如Alt+F3）可正常工作，且：

• 若取消menu@cinnamon.org小程序中Super_L的“显示菜单”绑定，首次按键即可正常触发
• 若在系统「键盘>快捷键」菜单中为Super+V分配命令，首次按键也正常

Cinnamon桌面默认将Super键设置为「按住显示主菜单」的触发键，首次按下Super+V时，系统优先处理Super键的长按检测逻辑，未将完整的组合键事件传递给自定义绑定，导致V键被单独解析为普通输入；第二次按下时Super键已处于按住状态，组合键事件才被正确识别并交给自定义处理。

方案1：修改Cinnamon的Super键行为 #

通过调整系统设置消除Super键的长按冲突：

• 打开Cinnamon「系统设置」→「面板」→ 找到主菜单小程序（对应menu@cinnamon.org）
• 取消「按住Super键显示菜单」的选项，或把触发方式改为「按一次Super键显示菜单」

方案2：修复Keybinder绑定代码 #

Keybinder默认允许事件继续传递，导致V键被系统处理为输入，修改代码阻止事件传递：

import gi
gi.require_version('Gtk', '3.0')
gi.require_version('Keybinder', '3.0')
from gi.repository import Keybinder, Gtk

class Application(Gtk.Application):
    def __init__(self):
        super().__init__(application_id="org.example.clipboardhistory", flags=0)
        self.connect("activate", self.on_activate)
        self.connect("startup", self.on_startup)

    def on_startup(self, app):
        print("Application started.")
        self.hold()

    def on_activate(self, app):
        pass

    def key_press(self, user_data=None):
        print("Key was pressed!")
        return True  # 返回True阻止事件继续传递，避免输入v

if __name__ == "__main__":
    app = Application()
    Keybinder.init()
    Keybinder.bind("<Mod4>V", app.key_press)  # 使用<Mod4>代替<Super>，对应X11的Super掩码
    app.run(None)

方案3：修复Xlib绑定代码 #

调整Xlib的按键抓取模式，阻止默认事件传递：

from Xlib import X, XK, display

# Connect to the X server
d = display.Display()
root = d.screen().root

# Get keycode for 'v' key
v_keysym = XK.string_to_keysym('v')
v_keycode = d.keysym_to_keycode(v_keysym)

# Get keycode for Super (Mod4Mask is standard for Super)
mod_mask = X.Mod4Mask

# 使用GrabModeSync抓取按键，阻止系统默认处理
root.grab_key(v_keycode, mod_mask, True,
              X.GrabModeSync, X.GrabModeSync)

print("Listening for Super+V...")

while True:
    event = d.next_event()
    if event.type == X.KeyPress:
        if event.detail == v_keycode and (event.state & mod_mask):
            print("Super+V pressed!")
            # 阻止事件继续传递，避免输入v
            d.allow_events(X.AsyncKeyboard, X.CurrentTime)
        else:
            # 其他事件正常放行
            d.allow_events(X.ReplayKeyboard, X.CurrentTime)

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