宇树Go2机器狗3D雷达实战：Livox Mid360从安装到避坑全记录（Ubuntu 20.04适配版）

最新推荐文章于 2026-04-08 09:59:10 发布

原创

最新推荐文章于 2026-04-08 09:59:10 发布 · 767 阅读

宇树Go2机器狗3D雷达实战：Livox Mid360从安装到避坑全记录（Ubuntu 20.04适配版）

如果你正在为宇树Go2机器狗寻找一个性价比高、性能又足够强悍的3D感知方案，那么Livox Mid360绝对是一个绕不开的选项。它不像Velodyne那样昂贵，也不像一些单线雷达那样信息稀疏，在科研和原型开发中找到了一个绝佳的平衡点。但当你兴冲冲地打开官方仿真包，准备在Ubuntu 20.04上大干一场时，迎面而来的很可能是一连串的编译错误和Gazebo版本冲突。这篇文章，就是为你准备的。它不是一份简单的操作手册，而是一份融合了实战经验、原理分析和成本考量的深度指南，旨在帮你避开我踩过的所有坑，让Livox Mid360在Go2上顺利“安家”，并真正发挥其三维感知的威力。

1. 环境准备与核心依赖梳理

在开始动手之前，我们必须对Ubuntu 20.04下的ROS和Gazebo生态有一个清醒的认识。很多教程默认的环境是Ubuntu 18.04 + ROS Melodic + Gazebo 9，而Ubuntu 20.04默认搭配的是ROS Noetic和Gazebo 11。这个版本跃迁带来了底层API的变动，尤其是Ignition Math库从math4升级到了math6，这正是导致Livox官方仿真包编译失败的根本原因。

首先，确保你的基础环境是干净的。我强烈建议使用一个全新的ROS工作空间来管理Go2和Livox的相关功能包，这样可以避免与系统或其他项目的依赖产生冲突。

# 创建并初始化一个专用于本项目的ROS工作空间
mkdir -p ~/go2_livox_ws/src
cd ~/go2_livox_ws
catkin_make
source devel/setup.bash

接下来，你需要准备好宇树Go2的官方ROS驱动和仿真包。通常，你需要从宇树的GitHub仓库或官方渠道获取unitree_ros和unitree_gazebo这两个核心包。将它们克隆或放置到你的src目录下。同时，Livox Mid360的官方SDK和ROS驱动（用于真实雷达）也建议一并准备，虽然仿真阶段用不到，但为后续真机部署做铺垫是个好习惯。

这里有一个关键点：仿真负载管理。Go2本身是一个高自由度的复杂动力学模型，其平衡控制器计算量不小。如果再叠加高频率的3D激光雷达点云仿真，对CPU的负担是巨大的。因此，在仿真中启用雷达时，明智的做法是暂时屏蔽掉URDF模型中的深度相机和单目相机插件，以释放计算资源，确保仿真的实时性。你可以在Go2的xacro描述文件中，通过注释掉相应的Gazebo插件标签来实现。

注意：在Ubuntu 20.04上，Gazebo 11的启动和模型加载可能比旧版更慢。如果你的网络环境不佳，首次启动时Gazebo下载在线模型会非常耗时甚至失败。提前将常用模型（如ground_plane）下载到本地~/.gazebo/models目录，或使用离线世界文件，能极大提升体验。

2. Livox激光雷达仿真包深度适配与编译

现在进入核心环节：让Livox的官方仿真包在Ubuntu 20.04上跑起来。官方仓库livox_laser_simulation默认是为更旧的系统设计的，直接catkin_make几乎百分之百会失败。我们需要进行一系列针对性的手术式修改。

第一步，获取仿真包代码：

cd ~/go2_livox_ws/src
git clone https://github.com/Livox-SDK/livox_laser_simulation.git

第二步，修改C++编译标准。 打开livox_laser_simulation/CMakeLists.txt文件，找到关于编译标准的设置。旧版本可能设置为c++11，为了更好的兼容性，我们将其提升到c++14或c++17。这通常是第一个需要修改的地方。

# 在CMakeLists.txt中找到类似的行，并进行修改
# 将
add_compile_options(-std=c++11)
# 改为
add_compile_options(-std=c++17)

第三步，也是最关键的一步，修复Ignition Math头文件路径。 这个错误信息通常会提示找不到ignition/math4/ignition/math.hh。因为Gazebo 11使用的是Ignition Math库的第6版。我们需要修改源代码中的包含路径。

修改头文件：打开 livox_laser_simulation/include/livox_laser_simulation/livox_ode_multiray_shape.h
```
// 将
#include <ignition/math4/ignition/math.hh>
// 改为
#include <ignition/math6/ignition/math.hh>
```
修改源文件：打开 livox_laser_simulation/src/livox_ode_multiray_shape.cpp
```
// 同样进行修改
#in
```