PyQt6打开MainWindow报错：找不到Qt平台插件cocoa，求解决

错误信息 #

qt.qpa.plugin: Could not find the Qt platform plugin "cocoa" in ""
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

zsh: abort python main.py

系统环境 #

• macOS Ventura 13.4.1
• Python 3.11.3

排查与解决步骤 #

• 检查PyQt6插件完整性
  先通过pip show PyQt6获取安装路径，进入路径下的PyQt6/Qt/plugins/platforms目录，确认是否存在libqcocoa.dylib文件。若缺失，彻底卸载后重装：

  pip uninstall -y PyQt6 PyQt6-Qt6
  pip install PyQt6
  

• 手动指定QT_PLUGIN_PATH
  若插件存在但无法被识别，可手动设置插件路径：

  • 代码中添加（替换为实际路径）：

    import os
    from PyQt6.QtCore import QCoreApplication
    
    plugin_path = "/path/to/your/site-packages/PyQt6/Qt/plugins"
    os.environ["QT_PLUGIN_PATH"] = plugin_path
    QCoreApplication.addLibraryPath(plugin_path)
    

  • 或终端运行时临时设置：

    QT_PLUGIN_PATH=$(python -c "import PyQt6; print(PyQt6.__path__[0] + '/Qt/plugins')") python main.py
    

• 排查Python环境冲突
  确认当前激活的虚拟环境（若使用）与pip、python命令一致，用which python和pip --version验证环境路径是否匹配，避免全局环境与虚拟环境的包冲突。

• 安装对应版本的Qt6依赖
  确保PyQt6与配套的Qt6版本一致，查看PyQt6版本后安装对应Qt6包：

  pip install PyQt6-Qt6==$(pip show PyQt6 | grep Version | cut -d' ' -f2)
  

• 检查插件目录权限
  执行ls -l /path/to/site-packages/PyQt6/Qt/plugins/platforms，确认当前用户对该目录及libqcocoa.dylib文件有可读权限，若权限不足，用chmod调整。

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