升级Nuke 14后出现No module named 'PySide2.QtWebSockets'错误求助

核心原因 #

Nuke 14自带的Python 3.9环境中，预装的PySide2可能是裁剪版本，缺少QtWebSockets模块；而你用系统pip安装的PySide2并没有被Nuke的Python环境识别到。

解决步骤 #

1. 定位Nuke专属的Python解释器
   打开Nuke 14的脚本编辑器，执行以下代码获取路径：

   import sys
   print(sys.executable)
   

   输出的路径类似：

   • Windows: C:\Program Files\Nuke14.0v1\python\python.exe
   • Mac: /Applications/Nuke14.0v1/Nuke14.0v1.app/Contents/Frameworks/Python.framework/Versions/3.9/bin/python3.9
   • Linux: /usr/local/Nuke14.0v1/python/bin/python3.9

2. 用Nuke的Python安装完整PySide2
   打开系统终端，使用上述路径的pip工具安装/升级PySide2：

   # 替换为你获取到的Nuke Python路径
   /path/to/nuke14/python/bin/pip3 install --upgrade PySide2
   

   如果遇到权限问题，加上--user参数：

   /path/to/nuke14/python/bin/pip3 install --user --upgrade PySide2
   

   可选：指定适配Nuke的PySide2版本
   Nuke 14通常适配Qt 5.15.x系列，可指定版本安装避免兼容性问题：

   /path/to/nuke14/python/bin/pip3 install --user PySide2==5.15.2
   

3. 验证安装结果
   重启Nuke 14，在脚本编辑器中执行：

   import PySide2.QtWebSockets
   

   无报错则说明QtWebSockets模块已成功安装。

额外排查点 #

• 检查PySide2加载路径：执行import PySide2; print(PySide2.__file__)，确认加载的是你刚安装的完整版本，而非Nuke预装的裁剪版。
• 清理PYTHONPATH干扰：如果你的系统环境变量PYTHONPATH指向了其他PySide2目录，可能导致Nuke加载错误版本，可临时清空该变量后重启Nuke测试。

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