MacOS 14(M1)下PyQt6间歇性缺失cocoa平台插件求解决方案

• 强制指定Qt插件路径
  在Python代码开头加入以下配置，直接指向venv内的Qt平台插件目录（替换python3.x为你实际的Python版本，比如3.10）：

  import os
  import sys
  
  venv_path = sys.prefix
  os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = f"{venv_path}/lib/python3.10/site-packages/PyQt6/Qt6/plugins/platforms"
  

  或者启动应用时通过终端临时设置环境变量：

  QT_QPA_PLATFORM_PLUGIN_PATH=./venv/lib/python3.10/site-packages/PyQt6/Qt6/plugins/platforms python your_app.py
  

• 修复venv目录权限
  M1的系统权限管控可能导致插件文件被标记为不可访问，执行以下命令修复PyQt6相关目录权限：

  chmod -R 755 ./venv/lib/python3.x/site-packages/PyQt6
  chmod -R 755 ./venv/lib/python3.x/site-packages/PyQt6/Qt6/plugins
  

• 锁定依赖版本并清理缓存
  在requirements.txt中明确锁定所有Qt相关依赖，避免自动更新导致文件结构损坏：

  PyQt6==6.6.0
  PyQt6-Qt6==6.6.0
  PyQt6-sip==13.6.0
  

  然后清空pip缓存并重新安装依赖：

  pip cache purge
  pip install -r requirements.txt --no-cache-dir
  

• 排除系统全局Qt干扰
  如果MacOS全局安装了Qt，会和venv内的版本产生路径冲突，启动应用前先清空相关环境变量：

  unset QT_PLUGIN_PATH
  unset QT_QPA_PLATFORM_PLUGIN_PATH
  python your_app.py
  

• 重新创建带完整拷贝的venv
  M1架构下符号链接可能导致插件路径失效，创建venv时使用--copies参数生成完整文件拷贝：

  python3 -m venv --copies ./new_venv
  source ./new_venv/bin/activate
  pip install PyQt6==6.6.0
  

内容的提问来源于stack exchange，提问作者Matthew-F