MacOS下Cython+PyInstaller打包的Tkinter菜单栏异常问题

问题背景 #

• Python解释器直接运行Tkinter程序时，菜单栏功能正常；经Cython编译+PyInstaller打包后，终端运行可执行文件时菜单栏初始无法点击，切出再切回应用后恢复正常。
• 打包为.app文件时，菜单栏完全不显示，仅能看到Finder菜单。
• 环境版本：Python 3.8.2、Cython 3.0.0、PyInstaller 5.13.0，Windows平台打包无此问题。

解决思路 #

1. 修复终端运行时菜单栏初始不可点击问题 #

MacOS的Tkinter菜单栏依赖窗口焦点状态，打包后可能存在焦点延迟绑定的情况：

• 强制窗口焦点：在窗口初始化后添加焦点强制获取代码，确保启动时窗口激活：

  def main():
      global root 
      root = tk.Tk()
      root.title("Simple Editor")
      
      # 先完成窗口UI初始化
      root.update()
      # 强制提升窗口并获取焦点
      root.lift()
      root.focus_force()
     
      create_menus()
      # ... 后续代码不变
  

• 延迟初始化菜单栏：将菜单栏创建逻辑延迟执行，给Tkinter足够时间完成与MacOS系统UI的绑定：

  def main():
      global root 
      root = tk.Tk()
      root.title("Simple Editor")
      
      # 延迟100ms初始化菜单栏
      root.after(100, create_menus)
      
      input_text = tk.Text(root, height=10, width=30 )
      input_text.pack(expand=True, fill=tk.BOTH)
      # ... 后续绑定代码不变
      root.mainloop()
  

2. 修复.app文件无菜单栏问题 #

MacOS的.app包需要正确的plist配置才能识别为GUI应用，否则系统不会加载应用级菜单栏：

• 修改PyInstaller Spec文件：添加MacOS特定的plist配置，确保应用被识别为GUI程序：
  在生成的spec文件中，找到BUNDLE部分，补充plist参数：

  app = BUNDLE(
      coll,
      name='SimpleEditor.app',
      icon=None,
      bundle_identifier='com.yourdomain.simpleeditor',
      plist={
          'CFBundleName': 'Simple Editor',
          'CFBundleDisplayName': 'Simple Editor',
          'NSRequiresAquaSystemAppearance': True,
          'LSUIElement': False  # 确保应用显示菜单栏
      }
  )
  

• 使用窗口模式打包：打包时必须添加-w（--windowed）参数，避免.app关联终端窗口：

  pyinstaller -w --specpath ./specs --distpath ./dist yourscript.spec
  

• 检查Cython编译选项：编译时避免过度优化导致Tkinter符号丢失，使用基础编译命令：

  cythonize -i yourscript.pyx
  

3. 代码细节修正 #

原代码中存在一处绑定错误：root.bind('<Command-q>', lambda e:sys.exit)未调用sys.exit()，导致快捷键无法触发退出，修正为：

root.bind('<Command-q>', lambda e:sys.exit())

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