macOS RealSense 深度相机开发环境搭建librealsense 四步装好与高频报错速查【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense本文带你完成 macOS 上安装 librealsense SDK、搭建 RealSense 深度相机开发环境的完整流程。你有 C/C 开发经验、正准备上手深度感知项目就够不需要深度相机背景。SDK 提供深度/彩色双流输出与内外参标定编译完成后通过 pipeline API 直接取帧即可开工。先说清两个已知限制当前版本 RealSense Viewer 图形界面在 macOS 上不受支持IMU 动觉数据也被禁用。所以本文用rs-enumerate-devices和rs-hello-realsense两个命令行工具做跑通验证避免你在 GUI 上白费功夫。 前置检查系统要求与依赖版本确认最低要求以官方 macOS 安装文档为准macOS 12Monterey及以上——12 上 libusb 类工具必须用sudo运行这是系统 USB 安全策略所致Xcode Command Line Tools 或 Xcode 6.0Homebrew 已安装CMake 3.10libusb、pkg-config、openssl 可借 brew 一并装上终端里依次执行下面三条输出是版本号或路径而不是报错就继续xcode-select -p # 命令行工具安装路径 cmake --version # 需 3.10 及以上 brew --version # Homebrew再一次性装齐四个构建依赖brew install cmake libusb pkg-config openssl️ 构建流程拉源码、配 CMake、编译克隆源码并建立构建目录克隆仓库后单独建build/目录CMake 的所有产物都落在里面源码目录保持干净git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense mkdir build cd build配置 macOS 专属的 CMake 参数相比 LinuxmacOS 要多加两个关键开关BUILD_GRAPHICAL_EXAMPLES引入 OpenGL 图形示例FORCE_RSUSB_BACKENDON让 SDK 走 libusb 后端而不是系统默认 UVC 驱动——这是深度流能正常出数据的先决条件cmake .. -DBUILD_EXAMPLEStrue -DBUILD_GRAPHICAL_EXAMPLEStrue -DFORCE_RSUSB_BACKENDONCMake 构建阶段末尾出现-- Configuring done与-- Generating done即算成功缺依赖会在这一步直接报出来。用 make 编译 SDK并行编译产物是核心库librealsense2.dylib加各示例与工具的可执行文件make -j2耗时视机器约 5~10 分钟末尾出现Built target即完成。✅ 跑通验证确认设备识别与深度流输出最小验证两步。第一步枚举设备sudo ./tools/enumerate-devices/rs-enumerate-devices列表里出现相机序列号 环境就绪看到No device detected. Is it plugged in?则是没插相机或漏了sudo。第二步执行sudo ./examples/hello-realsense/rs-hello-realsense终端持续刷新The camera is facing an object X meters away说明深度流工作正常。深度帧经 OpenCV 显示出来就是这个样子——人形剪影即深度数据⚠️ 高频报错速查编译失败与找不到设备报错原文一句话原因修复ld: library not found for -lusb-1.0brew 装的 libusb 不在编译器默认搜索路径/bin/launchctl setenv LIBRARY_PATH /usr/local/lib后重新编译No device detected. Is it plugged in?macOS 12 需要提权才能访问 USB给工具命令加sudoCould NOT find OpenSSL开 CHECK_FOR_UPDATES 时 CMake 找不到 brew 的 openssl 位置export OPENSSL_ROOT_DIR$(brew --prefix openssl)后重新 configure三条都是官方文档明确记录的已知问题照改即可不必深究系统配置。 延伸文档、示例与深度质量工具打包分发时如何捆绑 libusb见官方 macOS 安装文档深度、彩色、点云取用模式看示例目录用 OpenCV 显示深度画面参考 getting_started_with_openCV.mdPython 项目直接用 wrappers/python/ 里的绑定仓库自带 Depth Quality Tool 做深度质量评估其 Z 精度评估的几何原理如下图下一步插好相机跑一遍rs-hello-realsense确认距离输出然后从 examples/ 里挑一个示例作为项目起点。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考