运行FLIR PySpin采集示例报错：module 'PySpin' has no attribute 'System'

运行FLIR相机Python SDK的Acquisition.py时遇到以下错误：

AttributeError: module 'PySpin' has no attribute 'System'

已尝试卸载同名小写pyspin库、重新安装匹配Python版本的PySpin wheel、重新下载完整SDK程序包，但问题仍未解决。以下是几个可能的原因及排查方案：

• Python环境大小写敏感性干扰
  Windows系统默认Python对模块名大小写不敏感，即便卸载了小写pyspin，若残留文件或环境路径存在冲突，仍可能加载错误模块。在Python交互环境执行以下命令，查看当前加载的PySpin实际路径：

  import PySpin
  print(PySpin.__file__)
  

  若输出路径并非FLIR官方SDK的PySpin目录，需手动删除该路径下的PySpin相关文件，或调整sys.path的优先级。

• PySpin安装不完整或损坏
  即便wheel版本匹配，仍可能存在安装不完整的情况。完全卸载后重新安装：

  pip uninstall -y PySpin
  # 替换为你的SDK wheel文件路径
  pip install spinnaker_python-3.1.0.79-cp310-cp310-win_amd64.whl
  

  安装后在Python交互环境验证：

  import PySpin
  print(dir(PySpin))
  

  若输出中无System，说明安装的模块存在问题，可能是wheel文件损坏或SDK与系统位数（32/64位）不匹配。

• 本地文件或路径优先级干扰
  若运行Acquisition.py的当前目录下存在PySpin.py/pyspin.py文件，Python会优先加载本地文件而非SDK模块。检查并删除/重命名这类文件。
  也可在Acquisition.py开头添加代码，查看模块搜索路径：

  import sys
  print(sys.path)
  

  确认FLIR SDK的PySpin路径在sys.path靠前位置，若不在，可手动添加：

  import sys
  # 替换为SDK中PySpin的实际路径
  sys.path.insert(0, "C:\\path\\to\\spinnaker_python\\PySpin")
  

• SDK与Python版本兼容性问题
  当前使用的Spinnaker SDK 3.1.0.79搭配Python 3.10，虽wheel文件名显示匹配，但可能存在隐性兼容问题。查阅FLIR官方文档确认SDK支持的Python版本列表，尝试更换为官方明确支持的Python版本，或下载对应版本的最新稳定版SDK。

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