企业官网建设流程全解析

macOS 上 RealSense 深度相机开发环境搭建指南

【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense

第一次在 Mac 上碰 RealSense 硬件？librealsense 是 RealSense 深度相机的官方开源 SDK，在 macOS 上能从源码构建出完整的深度、彩色取流能力和配套工具，帮你把相机真正跑起来，而不用先啃一遍 SDK 内部实现。

跑起来之前的检查清单

开始编译前，花两分钟把下表过一遍，能省掉大半的排查时间：

把环境一次搭齐

这节带你走「装依赖 → 拉代码 → 编译 → 验证」的最短路径，全程不超过 30 分钟。先用一条 brew 命令把构建需要的依赖装齐：

brew install cmake libusb pkg-config openssl

再拉取源码并进入干净的构建目录：

git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense && mkdir build && cd build

配置时务必带上FORCE_RSUSB_BACKEND=ON，让 SDK 走 libusb 直连相机而不是系统的 UVC 驱动；配置完直接用make并行编译：

sudo xcode-select --reset cmake .. -DBUILD_EXAMPLES=true -DBUILD_GRAPHICAL_EXAMPLES=true -DFORCE_RSUSB_BACKEND=ON make -j4

编译完先别急着看流。macOS 12 以上有 USB 权限管控，大多数依赖 libusb 的程序必须加sudo才能摸到相机——这是本平台的默认姿势，不是你的配置问题：

30 秒确认相机在线

sudo examples/rs-enumerate-devices

输出里出现相机的名字、序列号或固件版本，就说明驱动、库、设备三者都通了。需要提醒的是：当前版本的 RealSense Viewer 不支持 macOS，所以命令行枚举就是标准验证手段，别在 Viewer 上浪费时间。

编译报错或相机没反应时先查这两处

仓库文档里被反复提到的两个坑基本覆盖了 macOS 上的九成问题。

• 编译或链接阶段报ld: library not found for -lusb-1.0：brew 装的 libusb 不在默认链接路径里，一行修复：

/bin/launchctl setenv LIBRARY_PATH /usr/local/lib

• 命令能跑但枚举不到设备：去掉sudo再试一次没用的话，反过来补上sudo，同时换一根线、换个 USB 口，直连 Mac 而不是插转接器。

接下来可以玩什么

环境通了之后，examples 示例代码 里的rs-depth、rs-pointcloud可以直接编译运行，看看深度帧和点云长什么样；tools 工具集 里有深度质量评估、数据录制回放；doc 目录 收录了官方文档，macOS 的完整说明在 installation_osx.md。跑起来之后你会发现深度流其实就是一张灰度图，像素值就是距离：

【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense