ubuntu 20.04 pyrealsense2
时间: 2025-07-04 22:20:17 浏览: 2
在 Ubuntu 20.04 上安装和配置 `pyrealsense2` 模块需要从源代码编译,因为目前没有针对 ARM 架构(如 NVIDIA Jetson 系列设备)的官方 PyPI 包。以下是详细的步骤说明:
### 安装依赖项
首先更新系统并安装必要的依赖包:
```bash
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y python3 python3-pip python3-dev \
git libssl-dev libusb-1.0-0-dev pkg-config libgtk-3-dev \
libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev
```
这些依赖项包括 Python 开发环境、Git 工具以及用于构建库的基础组件[^1]。
### 克隆 librealsense 仓库
使用 Git 获取最新的 librealsense 源码,并切换到合适的分支:
```bash
git clone https://github.com/IntelRealSense/librealsense.git
cd librealsense
git checkout v2.50.0 # 或者选择一个稳定的版本标签
```
确保你使用的是支持 Ubuntu 20.04 的版本。某些较旧的版本可能不完全兼容新系统[^1]。
### 配置与编译
创建一个构建目录并进入该目录进行 CMake 配置:
```bash
mkdir build && cd build
cmake ../ -DBUILD_PYTHON_BINDINGS=bool:true \
-DPYTHON_EXECUTABLE=$(which python3) \
-DCMAKE_BUILD_TYPE=Release \
-DBUILD_EXAMPLES=true \
-DBUILD_GRAPHICAL_EXAMPLES=false
```
如果系统提示找不到某些库或模块,请检查是否遗漏了依赖项。例如,`libglu1-mesa-dev` 是常见的图形相关依赖[^2]。
开始编译过程:
```bash
make -j$(nproc)
```
此步骤可能会花费一些时间,具体取决于你的硬件性能。
### 安装 Python 绑定
编译完成后,将生成的 Python 模块文件复制到 Python 的站点包目录中:
```bash
sudo make install
```
或者手动复制 `.so` 文件(适用于特定 Python 版本):
```bash
cp pyrealsense2.cpython-38-aarch64-linux-gnu.so /usr/local/lib/python3.8/dist-packages/
```
注意:实际文件名中的 `cpython-38-aarch64-linux-gnu.so` 部分会根据你的 Python 版本和架构略有不同。确认目标路径是否正确指向你的 Python 3.x site-packages 目录[^4]。
### 测试安装
打开 Python 解释器尝试导入 `pyrealsense2`:
```python
import pyrealsense2 as rs
print(rs.get_api_version()) # 应该输出当前 API 版本号
```
如果一切正常,你应该能够成功导入并且不会遇到任何错误消息。
---
阅读全文
相关推荐

















