使用L515激光雷达相机时报pyrealsense2模块未找到错误如何解决
pyrealsense2模块NotFoundError排查步骤
- 验证Python环境一致性
你安装依赖用的pip3和运行代码的Python解释器可能不属于同一个环境,是该问题最常见诱因。执行以下命令确认版本路径匹配:
若路径不一致,使用运行代码的解释器直接调用pip安装:pip3 -V python3 --version
如果你使用conda虚拟环境,优先使用conda源安装:python3 -m pip install opencv-python pyrealsense2conda install -c conda-forge pyrealsense2 - 检查系统版本与架构兼容性
官方pip源的pyrealsense2预编译包仅支持64位Python、3.7~3.10版本,ARM架构设备、Python 3.11+版本暂不支持直接通过pip安装。- Ubuntu系统需要先安装底层依赖包再安装Python绑定:
sudo apt-get install librealsense2-dkms librealsense2-utils librealsense2-dev - Windows系统需要确认安装的是64位Python,32位Python无法正常加载pyrealsense2。
- Ubuntu系统需要先安装底层依赖包再安装Python绑定:
- 补充安装Intel RealSense SDK
pyrealsense2仅为Python接口,底层依赖Intel官方RealSense SDK 2.0:- Windows端先安装Intel RealSense SDK 2.0,安装时勾选添加到系统环境变量选项,完成后重启命令行再安装Python包。
- Ubuntu端完成前述apt安装步骤后,将当前用户加入video用户组,避免权限问题:
sudo usermod -aG video $USER
- 安装后验证
安装完成后在对应Python环境下执行import pyrealsense2,无报错即为安装成功。
内容的提问来源于stack exchange,提问作者James Marlin
相关产品推荐
相关产品推荐

