Ubuntu 20.04下快速部署realsense SDK 2.0的完整指南

1. 环境准备与依赖安装

在Ubuntu 20.04上部署realsense SDK 2.0之前，我们需要先准备好基础环境。我实测过多次，这个环节如果没处理好，后面编译阶段会出现各种奇怪的问题。首先确保你的系统已经更新到最新状态：

sudo apt update && sudo apt upgrade -y

接下来安装核心依赖项。这里有个小技巧：不要一次性安装所有依赖，而是分批次进行。这样如果某个包安装失败，更容易定位问题。我整理了一个经过验证的依赖清单：

# 基础编译工具链 sudo apt install -y git cmake build-essential # 图形界面相关依赖 sudo apt install -y libgtk-3-dev libglfw3-dev libssl-dev # USB和设备管理依赖 sudo apt install -y libudev-dev libusb-1.0-0-dev pkg-config

特别提醒一下，libglfw3-dev这个包在某些镜像源里可能叫libglfw-dev。如果遇到找不到包的情况，可以尝试更换软件源或者直接搜索可用包名。我遇到过几次这种情况，最后发现是源不同导致的命名差异。

2. 获取SDK源码与权限配置

现在我们来获取realsense SDK的源代码。官方推荐使用git克隆特定版本，这里以v2.48.0为例：

git clone -b v2.48.0 https://github.com/IntelRealSense/librealsense

进入目录后，有个关键步骤很多人会忽略——配置USB设备权限。这个坑我踩过，如果不做这步，普通用户无法直接访问摄像头设备：

cd librealsense sudo cp config/99-realsense-libusb.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules && sudo udevadm trigger

这个操作实际上是在系统里添加了一条udev规则，让所有用户都能访问realsense设备。完成后建议重启系统，确保规则生效。有次我忘了重启，调试了半天才发现是权限问题。

3. 编译与安装SDK

编译环节是最容易出问题的部分。根据我的经验，建议新建一个build目录来保持源码目录干净：

mkdir build && cd build

然后是关键的cmake配置。这里有几个重要参数需要注意：

• -DCMAKE_BUILD_TYPE=Release：使用发布模式编译，性能更好
• -DBUILD_EXAMPLES=true：编译示例程序，强烈建议开启
• -DBUILD_GRAPHICAL_EXAMPLES=true：如果需要图形界面工具就开启

完整编译命令如下：

cmake ../ -DCMAKE_BUILD_TYPE=Release -DBUILD_EXAMPLES=true make -j$(nproc) sudo make install

这里有个实用技巧：-j$(nproc)会自动检测你的CPU核心数，并行编译加快速度。我在8核机器上实测，编译时间从15分钟缩短到3分钟左右。

编译完成后，建议运行单元测试确保一切正常：

ctest

4. 设备测试与常见问题排查

安装完成后，插上realsense摄像头（必须是USB3.0接口），运行官方查看器测试：

realsense-viewer

如果一切正常，你应该能看到设备列表。点击左侧的开关按钮，就能看到实时画面了。但根据我的经验，新手常会遇到这些问题：

1. 设备未识别：首先检查lsusb命令输出，确认设备出现在列表中。如果没有，尝试更换USB接口（必须是蓝色的USB3.0接口）

2. 权限问题：如果提示没有权限，重新执行udev规则配置并重启

3. GLIBC版本冲突：这种情况通常发生在较旧的系统上，解决方案是升级系统或手动编译新版glibc

4. 内核模块冲突：某些Linux发行版会自带realsense内核模块，需要先卸载：

   sudo apt remove x86-64-linux-gnu-realsense

我建议第一次使用时，先运行内置的示例程序。比如尝试运行rs-capture，这个简单的示例能帮你快速确认基础功能是否正常。

5. 开发环境配置与进阶使用

如果你想基于SDK进行开发，还需要配置开发环境。这里分享几个实用技巧：

Python开发：

pip install pyrealsense2

ROS集成： 如果你要用ROS，建议使用官方提供的ROS包：

sudo apt install ros-noetic-realsense2-camera

性能优化： 在realsense-viewer中，可以调整这些参数提升性能：

• 降低分辨率（从1080p降到720p）
• 关闭不用的传感器（如同时使用RGB和深度时，可以关闭红外）
• 调整帧率（30fps通常足够）

我在实际项目中发现，合理配置这些参数可以让CPU占用率从90%降到30%左右。

6. 版本管理与升级建议

维护realsense SDK时，版本管理很重要。我建议：

1. 定期检查GitHub上的Release页面，关注安全更新
2. 升级前先备份现有配置
3. 使用git管理你的修改：

   git checkout -b my_customizations

如果要升级到新版本，最安全的方式是：

git fetch --all git checkout v2.xx.x # 替换为目标版本 make clean # 然后重新编译安装

记住：不要直接覆盖安装，一定要先清理旧版本。有次我偷懒没做clean操作，结果运行时出现了奇怪的段错误。