Ubuntu 20.04上Intel Realsense D435i驱动安装实战:从SDK2.0到ROS包的完整避坑手册
第一次接触Intel Realsense D435i时,我天真地以为按照官方文档就能轻松搞定所有安装。结果在Ubuntu 20.04上折腾了整整三天,遇到了无数个"坑"——从udev权限问题到OpenCV版本冲突,从GStreamer报错到catkin_make失败。这篇文章就是把我踩过的所有坑和解决方案系统整理出来,让你能一次性成功安装并运行D435i的SDK和ROS包。
1. 环境准备:那些容易被忽略的细节
很多人直接跳到SDK安装步骤,结果后面遇到各种奇怪问题。其实90%的安装失败都源于前期环境准备不充分。
1.1 系统更新与内核处理
首先确保你的Ubuntu 20.04是最新状态:
bash复制sudo apt update && sudo apt upgrade -y
sudo apt dist-upgrade
关键步骤:Realsense需要特定的内核模块支持,建议安装linux-generic内核:
bash复制sudo apt install --install-recommends linux-generic-hwe-20.04
安装完成后重启系统,使用uname -r确认内核版本在5.4以上。
1.2 必备依赖项安装
这些依赖项看似简单,但缺少任何一个都可能导致后续编译失败:
bash复制sudo apt install -y \
git cmake libssl-dev libusb-1.0-0-dev pkg-config \
libgtk-3-dev libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev \
python3-dev python3-pip
特别提醒:如果你计划使用Python开发,还需要安装:
bash复制pip3 install numpy pyrealsense2
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. SDK 2.0安装:两种方式与常见问题
官方提供了apt和源码编译两种安装方式,各有优缺点。
2.1 APT安装方式(推荐新手)
这是最快捷的方式,但可能会遇到版本滞后问题:
bash复制sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key F6E65AC044F831AC80A06380C8B3A55A6F3EFCDE
sudo add-apt-repository "deb https://librealsense.intel.com/Debian/apt-repo $(lsb_release -cs) main" -u
sudo apt update
sudo apt install librealsense2-dkms librealsense2-utils librealsense2-dev
常见问题1:E: 无法定位软件包 librealsense2-dkms
解决方案:先运行sudo apt update --fix-missing,然后重试。
测试安装:
bash复制realsense-viewer
如果看到设备但无法打开,很可能是权限问题:
bash复制sudo cp ~/.99-realsense-libusb.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
2.2 源码编译安装(适合定制需求)
如果你想使用最新特性或自定义编译选项,源码安装是更好的选择:
bash复制git clone https://github.com/Intel
