如何快速上手 RealSense 深度相机：librealsense 从零到三维感知的完整部署路径
【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense
librealsense 是 Intel 官方开源的 RealSense SDK，它把 D400、T265 等深度相机背后的复杂驱动、校准和流处理全部封装成一套 C++ 核心库，外加 Python、C#、OpenCV 等绑定。也就是说，你插上相机后，真正要解决的就是"装好、看流、用数据"三件事。这篇文章面向刚拿到深度相机、想把三维感知快速跑进自己项目的开发者。
🔩 三条命令装好 librealsense：从克隆到 Viewer 预览
先过一遍环境要求：
- 一台 Intel RealSense 深度相机（D400 系列或 T265）
- Linux 下推荐 Ubuntu 20.04 / 22.04，Windows 10/11 也可以
- CMake 3.8+、C++11 编译器、git；Linux 还要能编译内核模块
然后克隆仓库并进入目录：
git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense先给设备授权，再打上内核补丁。Linux 跑 RealSense 需要改过的 uvcvideo 驱动来支持深度相关的 UVC 格式，这两步缺一不可：
./scripts/setup_udev_rules.sh ./scripts/patch-realsense-ubuntu-lts.sh最后编译安装：
mkdir build && cd build cmake .. -DBUILD_EXAMPLES=true make -j$(nproc) sudo make install接上相机，运行realsense-viewer，能出图就说明整条链路通了。
Jetson 用户多一步：L4T 内核的模块加载方式特殊，要打专门的补丁脚本：
./scripts/patch-realsense-ubuntu-L4T.sh它会自动拉内核源码、打补丁、编译并插入模块，全程约 30 分钟，需要约 2.5 GB 空闲空间；完成后按上面的标准流程编译即可，详见 doc/installation_jetson.md。
🔍 看懂三路数据流：深度、红外与点云
深度图与红外图各在说什么
相机每帧给你深度、红外、彩色三路数据。深度流里每个像素的灰度值就是一个距离，所以近景发白、远景趋暗。想存几帧图像下来看，直接跑仓库里的 capture 示例：
./examples/capture/rs-capture红外流则是相机"自己看"的场景，低光环境下照样有清晰纹理，常用来核对深度缺失的位置是不是真的没有反射信号。
深度图参数怎么调
深度质量不满意时，别先怪相机。RealSense D 系列开放了高级模式，可以调激光功率、曝光时间、置信度阈值这类底层参数：
./examples/sensor-control/rs-sensor-control调完实时看深度流的变化，哪组参数噪声最少就用哪组。
把实时数据流录成 bag 再回放
算法还没调完又想反复验证？在 RealSense Viewer 里按录制键，多路流会同步存成 bag 文件：
拿到 bag 后离线回放，不用碰硬件：
realsense-viewer --playback 你的录制文件.bag回放里可以调播放速度、逐帧看对齐情况，这是调试同步和过滤器的标准做法。
📐 落地两件事：量箱子尺寸与实时三维重建
用 Python 做一个箱子尺寸测量器
不想写 C++ 的话，先装 Python 绑定：
pip install pyrealsense2wrappers/python/examples/下就有可直接跑的测量演示box_dimensioner_multicam_demo.py，思路是先用棋盘格做多相机外参标定，再用深度数据估出箱子的长宽高。物流场景里"拍照出货"这类需求，基本就是这套流程。
用 kinfu 做实时三维重建
进阶一点，仓库自带一个 KinectFusion 演示，直接消费深度流持续更新环境的 3D 模型，常用于建图和导航：
./wrappers/opencv/kinfu/rs-kinfu🛠 三个最容易踩的坑
- 插上相机没反应：多半是缺 USB 访问权限。在仓库根目录跑
./scripts/setup_udev_rules.sh；Windows 上则是驱动和注册表配置问题，按 doc/installation_windows.md 检查。 - 深度流出不来：通常说明内核补丁没打上。用
dmesg | tail -n 50查看是否有新的 uvcvideo 驱动注册，没有就重跑补丁脚本。 - 金属、玻璃反光面深度一团糟：这是主动式深度相机的物理特性，属正常现象。用
src/proc/里的空洞修复、时域滤波等后处理算子改善，说明见 doc/post-processing-filters.md。
想继续深入，翻这三个入口就够：总览文档 doc/readme.md、可直接编译的 C++ 示例 examples/、完整排障手册 doc/troubleshooting.md。
【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
