You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Mac OS系统中成功安装pyrealsense2模块?

Mac OS 安装pyrealsense2实操方案

直接执行pip安装会提示ERROR: No matching distribution found for pyrealsense2,是因为Intel官方未针对Mac OS平台提供预编译的pip安装包,brew默认安装的librealsense也没有开启python绑定编译选项,需要手动从源码编译python绑定,成功安装的操作步骤如下:

  • 安装基础依赖
    执行命令:brew install cmake libusb pkg-config openssl
  • 拉取官方稳定版源码
    拉取Intel官方开源的librealsense仓库代码,切换到v2.54.2稳定版本标签,避免使用开发分支代码
  • 配置编译参数
    先激活你要安装pyrealsense2的python环境(虚拟环境、conda环境都要提前激活),再执行以下命令:
    mkdir build && cd build
    cmake .. \
    -DBUILD_PYTHON_BINDINGS=ON \
    -DBUILD_EXAMPLES=OFF \
    -DBUILD_GRAPHICAL_EXAMPLES=OFF \
    -DPYTHON_EXECUTABLE=$(which python3) \
    -DCMAKE_BUILD_TYPE=Release
    
    若编译时提示找不到libusb,可在cmake参数末尾添加-Dlibusb_DIR=$(brew --prefix libusb)/lib/cmake/libusb-1.0
  • 编译并部署python绑定
    执行编译命令:make -j$(sysctl -n hw.ncpu)
    编译完成后,进入build/wrappers/python目录,找到后缀为.so的pyrealsense2相关文件,将该文件复制到当前python环境的site-packages目录即可。
    site-packages目录查询命令:python3 -c "import site; print(site.getsitepackages()[0])"
  • 验证安装
    执行命令:python3 -c "import pyrealsense2; print(pyrealsense2.__version__)",输出版本号即安装成功。

注意事项:

  • M系列芯片的Mac请确保终端未开启Rosetta转译,编译生成的arm64架构绑定才可正常导入使用
  • 每次切换python环境都需要重新编译对应版本的绑定,不同python版本的编译产物不通用

内容的提问来源于stack exchange,提问作者Rafael Lourenço

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.28 04:24:02