UUV Simulator 一站式部署指南：从零搭建Ubuntu20.04、ROS Noetic与Gazebo11仿真环境

1. 环境准备：虚拟机与Ubuntu20.04部署

水下机器人仿真开发的第一步是搭建稳定的基础环境。我推荐使用VMware Workstation Pro 17作为虚拟机平台，它的快照功能能让你在配置出错时快速回滚。实测在Windows 10/11系统上运行稳定，对硬件资源的调度也足够高效。

安装虚拟机时有个容易忽略的细节：务必在BIOS中开启Intel VT-x/AMD-V虚拟化支持。我遇到过不少开发者卡在虚拟机启动报错，最后发现是主板设置问题。检查方法很简单——打开任务管理器→性能选项卡，查看"虚拟化"是否显示"已启用"。

Ubuntu20.04的ISO镜像建议从阿里云镜像站下载，速度比官网快得多：

wget https://mirrors.aliyun.com/ubuntu-releases/20.04.6/ubuntu-20.04.6-desktop-amd64.iso

虚拟机配置参数需要特别注意：

• 内存分配：至少8GB（运行Gazebo时内存占用会飙升到6GB以上）
• CPU核心：建议分配4-6个物理核心（我的i7-12700分配了6核）
• 磁盘空间：50GB起步（建议选择动态分配模式）

安装Ubuntu时有个实用技巧：在分区步骤选择"自定义分区"，单独创建15GB的/home分区。这样重装系统时个人文件不会丢失，实测节省了大量配置恢复时间。

2. ROS Noetic的深度配置指南

ROS Noetic作为最后一个支持Python2的LTS版本，其稳定性经过多年验证。但官方源的下载速度可能很慢，这里分享我的三阶加速方案：

1. 替换中科大源：

sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.ustc.edu.cn@g' /etc/apt/sources.list

2. 添加ROS国内镜像：

sudo sh -c '. /etc/lsb-release && echo "deb http://mirrors.ustc.edu.cn/ros/ubuntu/ `lsb_release -cs` main" > /etc/apt/sources.list.d/ros-latest.list'

3. 安装时使用apt-fast替代apt（需先安装）：

sudo apt install aria2 sudo add-apt-repository ppa:apt-fast/stable sudo apt install apt-fast

安装核心组件时建议选择ros-noetic-desktop-full，它包含了RViz、Gazebo等关键工具。我遇到过只装基础包导致后期依赖缺失的情况，来回折腾反而更耗时。

环境变量配置有个常见坑点：很多教程会直接修改.bashrc，但这样在VS Code等IDE中可能不生效。更稳妥的做法是：

echo "source /opt/ros/noetic/setup.bash" | sudo tee -a /etc/profile.d/ros.sh

3. Gazebo11的优化安装方案

Gazebo11需要单独配置源，官方推荐的安装方式有时会因网络问题失败。经过多次测试，我总结出更稳定的分步安装法：

1. 先安装依赖库：

sudo apt install curl gnupg2 lsb-release curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key | sudo apt-key add -

2. 添加清华镜像源：

sudo sh -c 'echo "deb https://mirrors.tuna.tsinghua.edu.cn/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list'

模型库导入是另一个耗时环节。原始方法通过git克隆经常中断，可以改用wget直接下载压缩包：

wget https://github.com/osrf/gazebo_models/archive/refs/heads/master.zip unzip master.zip -d ~/.gazebo/

提升Gazebo运行效率的关键配置：

• 在~/.ignition/fuel/config.yaml中配置模型缓存路径
• 设置环境变量禁用不必要的插件：

echo "export GAZEBO_PLUGIN_PATH=/usr/lib/x86_64-linux-gnu/gazebo-11/plugins" >> ~/.bashrc

4. UUV Simulator的实战部署

创建工作空间时有个效率技巧：使用catkin-tools替代传统catkin_make：

sudo apt install python3-catkin-tools mkdir -p ~/catkin_ws/src cd ~/catkin_ws catkin init

克隆代码库时添加--depth=1参数可以大幅减少下载量：

git clone --branch noetic --depth=1 https://github.com/arturmiller/uuv_simulator.git

依赖安装环节最容易出问题的是geographiclib数据集。手动下载比自动安装更可靠：

wget https://raw.githubusercontent.com/arturmiller/uuv_simulator/noetic/uuv_simulator/scripts/install_geographiclib_datasets.sh chmod +x install_geographiclib_datasets.sh ./install_geographiclib_datasets.sh

编译时的黄金法则：

1. 先单独编译uuv_simulator包
2. 再整体编译工作空间

catkin build uuv_simulator catkin build

测试时如果遇到[ERROR] [WallTime: ...] [Errno 2]报错，通常是模型路径问题。检查GAZEBO_MODEL_PATH是否包含：

/usr/share/gazebo-11/models ~/catkin_ws/src/uuv_simulator/uuv_gazebo_worlds/models

5. 避坑指南与性能调优

内存泄漏问题：长时间运行Gazebo后会出现内存暴涨。解决方法是在启动脚本添加：

export MALLOC_ARENA_MAX=1

显卡加速配置：在VMware中开启3D加速：

1. 虚拟机设置→显示器→加速3D图形
2. 安装VMware Tools后执行：

sudo apt install mesa-utils glxinfo | grep "OpenGL renderer"

网络代理配置（仅限合法合规用途）： 如果遇到git克隆失败，可以配置git代理：

git config --global http.proxy http://proxy.example.com:8080

实时性优化：修改Ubuntu内核参数：

sudo sysctl -w kernel.sched_rt_runtime_us=950000

可视化调优：在~/.gazebo/gui.ini中调整：

[geometry] width=1280 height=720

6. 扩展应用场景

成功部署基础环境后，可以尝试这些进阶操作：

1. 添加传感器插件：

cd ~/catkin_ws/src git clone https://github.com/arturmiller/uuv_sensor_plugins

2. 导入自定义水下模型：

<include> <uri>model://rov_heavy</uri> <pose>0 0 -10 0 0 0</pose> </include>

3. 多机器人协同仿真：

roslaunch uuv_gazebo_worlds ocean_waves.launch robots:="rexrov rexrov2"

4. 与ROS2桥接（需安装ros1_bridge）：

sudo apt install ros-noetic-ros1-bridge

5. 录制仿真数据：

rosbag record -O test.bag /rexrov/pose_gt /rexrov/thruster_manager/input