Linux环境下pip安装pyueye后运行提示ueye_api库缺失问题求助

报错共性说明 #

该ImportError: could not find any library for ueye_api属于pyueye使用过程中的高频共性问题，Windows、Linux、macOS平台均有大量使用者遇到过。核心原因是pip安装的pyueye仅为IDS相机驱动的Python封装层，本身不包含IDS官方提供的底层ueye_api驱动动态库，仅装pyueye缺失底层依赖必然触发该报错。

Linux平台解决方案 #

• 第一步：下载对应相机型号、CPU架构的IDS官方uEye Linux驱动安装包，驱动版本尽量与安装的pyueye版本匹配，避免跨大版本兼容问题
• 第二步：执行官方驱动安装脚本，安装完成后libueye_api.so类动态库默认会写入/usr/lib或/usr/local/lib等系统库路径
• 第三步：如果安装后仍报错，可手动指定动态库路径：
  1. 执行sudo find / -name "libueye_api.so*"查找动态库实际所在文件夹路径
  2. 临时生效：运行Python脚本前执行export PYUEYE_DLL_PATH="你的动态库所在文件夹路径"
  3. 永久生效：把上述export语句添加到~/.bashrc（Bash环境）或~/.zshrc（Zsh环境）中，执行source ~/.bashrc或对应配置文件生效
• 第四步：部分发行版需要执行sudo ldconfig刷新系统动态库缓存后再运行代码

Windows平台解决方案 #

• 第一步：安装对应相机型号的IDS官方Windows版uEye驱动，安装时建议勾选「添加驱动路径到系统环境变量」选项
• 第二步：如果安装时未勾选环境变量配置，可手动找到驱动安装目录下ueye_api.dll（32位系统）或ueye_api_64.dll（64位系统）所在的文件夹，将路径添加到系统Path环境变量
• 第三步：不想修改系统环境变量的话，可在Python代码导入pyueye前手动指定路径：

import os
os.environ["PYUEYE_DLL_PATH"] = "C:\\替换为你的ueye_api文件所在文件夹路径"
from pyueye import ueye

• 第四步：重启IDE或命令行工具使环境变量生效后再运行代码

验证步骤 #

安装驱动后可先打开IDS官方自带的uEye Cockpit工具，确认相机能正常被识别、采图正常后再运行自定义Python代码，排除硬件连接、驱动本身安装失败的问题。

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