九边1. 项目概述
libsurvive和pysurvive是用于SteamVR Lighthouse追踪系统的开源工具库，它们允许开发者在没有官方HTC Vive/Valve Index硬件的情况下，使用第三方设备与Lighthouse基站进行交互。这个教程将详细介绍在Ubuntu 22.04系统上从源码编译安装这两个库的完整过程，以及基础的使用方法。
作为长期从事VR/AR开发的从业者，我发现这套工具链对于研究空间定位算法、开发自定义追踪设备特别有价值。它解决了开源社区长期依赖商业SDK的痛点，为学术研究和原型开发提供了更多可能性。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 系统要求
推荐使用Ubuntu 22.04 LTS版本，这个长期支持版本提供了稳定的开发环境。实测在以下配置运行良好：
- CPU: Intel i5及以上
- RAM: 8GB及以上
- 存储: 至少20GB可用空间
- USB端口: 至少一个3.0端口
注意：虽然理论上支持其他Linux发行版，但不同发行版的依赖包管理方式差异较大，新手建议严格使用Ubuntu 22.04以避免兼容性问题。
2.2 基础依赖安装
首先更新软件包列表并安装编译工具链：
bash复制sudo apt update
sudo apt install -y build-essential cmake git wget
然后安装必要的开发库：
bash复制sudo apt install -y libusb-1.0-0-dev libjpeg-dev libglfw3-dev libeigen3-dev libjson-c-dev
这些依赖包分别提供以下功能支持：
- libusb: USB设备通信
- libjpeg: 图像处理
- glfw: OpenGL窗口管理
- eigen: 矩阵运算
- json-c: 配置文件解析
3. 源码编译安装
3.1 获取源码
建议在用户主目录下创建工作目录：
bash复制mkdir ~/survive_ws && cd ~/survive_ws
克隆libsurvive仓库（含子模块）：
bash复制git clone --recursive https://github.com/c