1. 仿真环境搭建失败：ROS版本不兼容、Gazebo与ROS接口配置错误、依赖库缺失

说实话，仿真环境搭建这个坎，我见过太多人栽跟头了。我自己刚入行那会儿，也在这上面折腾了好几天。你想想看，好不容易把代码写好了，结果环境搭不起来，连个机器人模型都加载不出来，那感觉确实挺憋屈的。

这一节，我就把最常见的三个坑——ROS版本不兼容、Gazebo与ROS接口配置错误、依赖库缺失——掰开揉碎了讲清楚。嗯，咱们一个一个来。

ROS和Ubuntu的版本绑定，说白了就是一套固定的组合拳。我个人习惯是，装系统之前先查清楚这张表：

为什么非要这么严格？因为ROS和Gazebo之间的通信依赖一套叫gazebo_ros_pkgs的接口包。这个包的版本必须和ROS主版本对齐。我在项目中遇到过有人用Ubuntu 20.04装了ROS Melodic，结果死活跑不起来，查了半天才发现是版本错配。

⚠️ 警告：千万不要尝试在Ubuntu 20.04上装ROS Melodic。虽然有些教程说可以手动编译，但我试过，坑太多，不推荐。

检查版本是否匹配，可以用这条命令：

# 查看ROS版本
rosversion -d

# 查看Gazebo版本
gazebo --version

# 如果ROS和Gazebo都装了，检查接口包
rospack find gazebo_ros

如果rospack find找不到gazebo_ros，说明接口包没装对。这时候别慌，往下看。

接口配置错误，说白了就是ROS和Gazebo之间没搭上线。最常见的表现是：你启动Gazebo，但ROS话题里看不到/gazebo/link_states之类的信息。

为什么会这样？因为gazebo_ros_pkgs这个包没装，或者装错了源。

正确的安装方式分两步：

以ROS Noetic为例，命令如下：

# 第一步：安装Gazebo 11
curl -sSL http://get.gazebosim.org | sh

# 第二步：安装ROS接口包
sudo apt install ros-noetic-gazebo-ros-pkgs ros-noetic-gazebo-ros-control

💡 小技巧：装完之后，记得运行一下source /opt/ros/noetic/setup.bash，否则ROS找不到新装的包。

我曾经遇到过一个案例：同事装完Gazebo后，直接运行roslaunch gazebo_ros empty_world.launch，结果报错说找不到gazebo_ros。我过去一看，他忘了装ros-noetic-gazebo-ros-pkgs。嗯，这种低级错误其实挺常见的。

验证接口是否配置成功，可以启动一个空世界看看：

roslaunch gazebo_ros empty_world.launch

# 在另一个终端查看话题
rostopic list | grep gazebo

如果看到/gazebo/model_states、/gazebo/link_states这些话题，说明接口通了。

依赖库缺失，说白了就是系统里少了某个.so文件或者Python包。这种问题最烦人，因为报错信息往往不直观。

我总结了一套排查流程，你照着做就行：

举个例子，如果你遇到这样的报错：

error while loading shared libraries: libignition-math4.so.4: cannot open shared object file: No such file or directory

这说明缺了libignition-math4这个库。用apt-file找一下：

sudo apt-file update
apt-file search libignition-math4.so.4

找到后直接安装对应的包就行：

sudo apt install libignition-math4-dev

  🔑 核心原则：不要手动下载.so文件放到系统目录里。用包管理器安装，否则下次更新系统又得重来。

还有一种情况是Python依赖缺失。比如你写了一个ROS节点，import了rospy之外的库，但没在package.xml里声明。这时候ROS会报ImportError。我的习惯是，在package.xml里把所有依赖都写清楚：

<build_depend>rospy</build_depend>
<exec_depend>rospy</exec_depend>
<exec_depend>numpy</exec_depend>
<exec_depend>opencv-python</exec_depend>

然后运行rosdep install自动安装：

rosdep install --from-paths src --ignore-src -r -y

这个命令会读取所有package.xml，然后自动装好缺失的依赖。我个人觉得，这是最省心的做法。

下面这张图，我把仿真环境搭建失败的三个核心问题串起来了。你可以把它当作一个排查路线图：

这张图的核心逻辑是：遇到环境搭建失败，先判断是哪个层面的问题——版本、接口还是依赖。然后顺着分支往下查。我个人习惯是从版本开始查，因为版本错了后面全白搭。

最后，分享几个我踩过的坑，你遇到了可以直接跳过：

嗯，这一节的内容就这些。环境搭建是仿真联调的第一步，也是最容易出问题的一步。把这三个坑填平了，后面的路就好走了。

可可精品资料库