macOS下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.

已尝试步骤回顾 #

• 使用pip install --force-reinstall PySide6重新安装PySide6
• 确认PySide6安装目录中libqcocoa.dylib插件缺失
• 手动设置QT_QPA_PLATFORM_PLUGIN_PATH环境变量指向plugins目录，但错误仍存在

针对疑问的解决方案 #

1. 解决cocoa平台插件缺失问题（配置遗漏修复） #

（1）修正环境变量路径

你之前设置的路径指向了plugins根目录，但Qt平台插件实际存放在plugins/platforms子目录下，需调整环境变量：

import os
from PySide6 import __file__ as pyside_file
# 自动获取PySide6安装目录，避免手动写死路径出错
pyside_install_dir = os.path.dirname(pyside_file)
os.environ["QT_QPA_PLATFORM_PLUGIN_PATH"] = os.path.join(pyside_install_dir, "plugins", "platforms")

注意：必须在导入PySide6的UI模块（如QtWidgets）之前设置该环境变量。

（2）重新安装兼容版本的PySide6

macOS 15.3.1（Sequoia）属于较新系统，部分PySide6版本可能存在兼容性问题，尝试安装指定兼容版本：

pip uninstall -y PySide6
pip install PySide6==6.7.2  # 该版本对Sequoia兼容性更稳定

（3）手动补充缺失插件

如果重装后仍缺失libqcocoa.dylib，可从Qt官方对应版本的预编译包中提取该文件：

• 找到PySide6安装目录下的plugins/platforms文件夹（若不存在则创建）
• 将libqcocoa.dylib放入该目录，执行以下命令赋予执行权限：

chmod +x /path/to/PySide6/plugins/platforms/libqcocoa.dylib

2. 若libqcocoa.dylib已存在的处理方案 #

（1）检查插件依赖完整性

使用otool命令检查插件的动态库依赖是否正常：

otool -L /path/to/PySide6/plugins/platforms/libqcocoa.dylib

若输出中存在not found的依赖项，说明PySide6安装不完整，需重新安装。

（2）验证Python环境一致性

确认当前运行应用的Python环境与PySide6的安装环境一致：

# 查看当前Python路径
which python
# 查看PySide6安装路径
pip show PySide6 | grep Location

若路径不匹配，需切换到对应Python环境重新安装PySide6。

（3）解除macOS安全限制

macOS可能会阻止未签名的插件运行，可通过以下步骤解除：

1. 打开「系统设置」→「隐私与安全性」
2. 找到提示“已阻止使用libqcocoa.dylib”的条目，点击「允许」
3. 重启应用尝试运行

内容的提问来源于stack exchange，提问作者Barthélémy Coquoz