Python调用C++ SFML共享库在macOS下无法打开GUI窗口问题咨询

macOS平台对GUI程序有两个专属限制，是你遇到问题的核心诱因：

1. 所有GUI渲染、事件处理逻辑必须运行在应用主线程，且需要绑定到系统主事件循环NSRunLoop
2. 只有后缀为.app的应用包执行时，系统会自动初始化GUI上下文；直接通过命令行程序（比如Python解释器）调用共享库中的GUI代码时，系统不会自动创建GUI上下文，而你直接编译C++为可执行文件运行时，编译器会自动链接GUI启动逻辑，所以可以正常显示窗口。

以下方案按改造成本从低到高排列：

• 方案1：补充SFML事件处理逻辑
  你当前的代码没有消费窗口事件，macOS下如果不处理系统事件队列，窗口会默认处于隐藏状态。修改C++的渲染循环，加入事件处理逻辑即可：

  while (window.isOpen())                                                         
  {                                                                               
      sf::Event event;
      // 消费所有窗口事件
      while (window.pollEvent(event)) {
          if (event.type == sf::Event::Closed)
              window.close();
      }
      std::cout << 1;                    
      window.clear();                                                            
      window.display();                                                          
  }
  

• 方案2：Python侧初始化GUI上下文
  不需要修改C和构建配置，只需要在Python调用C函数前，先初始化macOS的应用上下文：
  1. 先安装依赖：pip install pyobjc-core pyobjc-framework-Cocoa
  2. 修改Python代码为：

  from Cocoa import NSApplication, NSApp
  from build.test import *                                                           
                                                                                    
  def main():
      # 初始化macOS应用实例
      NSApplication.sharedApplication()
      # 把应用提到前台显示
      NSApp.activateIgnoringOtherApps_(True)                                                                     
      openWindow()                                                                   
                                                                                    
  if __name__ == "__main__":                                                         
      main()
  

• 方案3：C侧内置GUI初始化逻辑
  不需要修改Python代码，直接在C层处理上下文初始化，需要修改构建配置：
  1. 修改CMakeLists.txt，新增Cocoa框架依赖：

  make_minimum_required(VERSION 3.10)                                               
                                                                                    
  project(main)                                                                      
                                                                                    
  find_package(pybind11)                                                             
  find_package(SFML 2.5 COMPONENTS REQUIRED graphics system)                         
                                                                                    
  pybind11_add_module(test main.cpp)                                                 
  target_link_libraries(test PUBLIC sfml-graphics sfml-system "-framework Cocoa")
  

  2. 修改C++代码，在创建窗口前初始化应用上下文：

  #include <SFML/Graphics.hpp>                                                        
  #include <pybind11/pybind11.h> 
  #include <iostream>
  #include <Cocoa/Cocoa.h>                                      
                                                                                    
  namespace py = pybind11;                                                            
                                                                                    
  void openWindow() {
      // 初始化macOS GUI上下文
      [NSApplication sharedApplication];
      [[NSApplication sharedApplication] activateIgnoringOtherApps:YES];
                                                                    
      sf::RenderWindow window(sf::VideoMode(500, 500), "SFML");                       
      while (window.isOpen())                                                         
      {                                                                               
          sf::Event event;
          while (window.pollEvent(event)) {
              if (event.type == sf::Event::Closed)
                  window.close();
          }
          std::cout << 1;                    
          window.clear();                                                            
          window.display();                                                          
      }                                                                              
  }                                                                                  
                                                                                    
  PYBIND11_MODULE(test, handle) {                                                    
      handle.def("openWindow", &openWindow);                                          
  }
  

• 不要使用tmux、screen这类终端复用工具运行程序，这类工具会剥离GUI上下文权限
• 可以在系统设置>隐私与安全性>辅助功能中，把你使用的Python解释器（可通过which python命令查看路径）加入允许列表，授予GUI相关权限
• 运行时可以打开活动监视器，查看Python进程对应的窗口是否已经创建，确认是窗口隐藏还是未创建成功

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