Windows10下wxPython 4.1.0无法捕获常规按键事件求助

在Windows 10系统下使用Python 3.8 + wxPython 4.1.0开发桌面应用时，遇到常规按键检测失效的问题：仅能捕获Windows键、功能键等特殊按键，字母、数字、标点、ENTER、TAB等常规按键无法触发绑定的EVT_CHAR回调。
最初怀疑是控件层级吞噬事件，使用如下最简测试代码复现了完全一致的问题：

import wx

class TestPanel(wx.Panel):
    def __init__(self, *args, **kwds):
        wx.Panel.__init__(self, *args, **kwds)
        sizer=wx.BoxSizer(wx.VERTICAL)
        sizer.SetMinSize((300, 200))
        self.Text = wx.StaticText(self, label="Key Tests\n")
        sizer.Add(self.Text, 1, wx.EXPAND | wx.GROW | wx.ALL, 10)
        self.SetSizerAndFit(sizer)
        self.Layout()
        self.SetFocus()

        print("binding")
        self.Bind(wx.EVT_CHAR, self.OnKey)
        print("bound")

    def OnKey(self, event):
        print("called")
        print(event)
        lbl = f"{self.Text.GetLabel()}{event.GetKeyCode()}\n"
        self.Text.SetLabel(lbl)
        event.Skip()

class TestFrame(wx.Frame):
    def __init__(self, *args, **kwds):
        wx.Frame.__init__(self, *args, **kwds)

        panel = TestPanel(self, wx.ID_ANY)
        sizer=wx.BoxSizer(wx.VERTICAL)
        sizer.Add(panel, 1, wx.EXPAND)
        self.SetSizerAndFit(sizer)
        self.Layout()

class TestApp(wx.App):
    def OnInit(self):
        mainFrame = TestFrame(None, -1, "Test")
        self.SetTopWindow(mainFrame)
        mainFrame.Show()
        return 1

app = TestApp()
app.MainLoop()

运行代码后窗口可正常创建，仅在按下Windows键触发系统截图时，才会捕获到键码393，控制台对应输出如下：

binding
bound
called
<wx._core.KeyEvent object at 0x0385B340>

开发需求为捕获全量按键事件存入队列，供应用其他模块调用，需要定位配置遗漏点，实现常规按键的正常捕获。

wxPython的按键事件分发遵循两个核心规则：

• 按键事件只会发送给当前持有键盘焦点的可交互控件
• wx.Panel、wx.StaticText这类静态容器/展示控件默认不接收常规字符按键事件，仅在特殊系统按键触发时才会临时获得事件通知
  代码中调用self.SetFocus()试图给Panel设置焦点，但静态Panel本身不具备持有常规按键焦点的能力，焦点实际会被框架自动转移，因此常规按键的EVT_CHAR事件根本不会送达Panel的绑定回调。

根据需求场景选择对应实现即可：

方案1：全局捕获应用内所有按键（适配队列需求，优先选择） #

使用wx.EVT_CHAR_HOOK事件在Frame层级绑定，该事件会在所有子控件分发按键前优先触发，不需要处理焦点问题，可捕获全量按键：
直接修改测试代码的TestFrame部分即可：

class TestFrame(wx.Frame):
    def __init__(self, *args, **kwds):
        wx.Frame.__init__(self, *args, **kwds)
        panel = TestPanel(self, wx.ID_ANY)
        sizer=wx.BoxSizer(wx.VERTICAL)
        sizer.Add(panel, 1, wx.EXPAND)
        self.SetSizerAndFit(sizer)
        self.Layout()
        # 在Frame层绑定全局按键钩子
        self.Bind(wx.EVT_CHAR_HOOK, self.OnGlobalKey)
    
    def OnGlobalKey(self, event):
        # 此处可将event.GetKeyCode()、事件类型等信息存入自定义队列
        key_code = event.GetKeyCode()
        print(f"捕获按键：{key_code}")
        # 必须调用Skip，否则按键事件不会继续分发给子控件，会导致输入框、按钮等控件无法正常交互
        event.Skip()

方案2：让Panel本身可接收焦点 #

如果需要直接在Panel层绑定事件处理，重写AcceptsFocus方法告知框架当前控件可以持有焦点即可：

class TestPanel(wx.Panel):
    def __init__(self, *args, **kwds):
        wx.Panel.__init__(self, *args, **kwds)
        sizer=wx.BoxSizer(wx.VERTICAL)
        sizer.SetMinSize((300, 200))
        self.Text = wx.StaticText(self, label="Key Tests\n")
        sizer.Add(self.Text, 1, wx.EXPAND | wx.GROW | wx.ALL, 10)
        self.SetSizerAndFit(sizer)
        self.Layout()
        self.Bind(wx.EVT_CHAR, self.OnKey)
        # 若面板上无其他输入类控件，可绑定焦点丢失事件自动收回焦点
        self.Bind(wx.EVT_KILL_FOCUS, lambda e: self.SetFocus())
    
    # 重写方法声明控件可接收焦点
    def AcceptsFocus(self):
        return True

注意：如果Panel上放置了输入框、按钮等可交互控件，不要使用自动抢回焦点的逻辑，否则会导致其他控件无法正常获得焦点、无法输入。

• 所有按键事件处理完后如果不需要拦截事件，必须调用event.Skip()，否则会阻断正常的事件分发，导致界面控件交互异常
• EVT_CHAR_HOOK仅能捕获当前应用窗口激活状态下的按键，如果需要系统级全局热键，需要额外调用Windows API注册热键，wxPython原生不支持跨进程全局按键捕获

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