第二章：调试环境搭建——ROS2环境安装、AMR驱动包编译、调试工具链配置

说实话，调试环境搭建这件事，看着简单，但坑是真不少。我见过太多人花了一周装环境，最后发现是版本对不上。嗯，咱们今天就把这事捋清楚。

2.1 ROS2环境安装——选对版本，少走弯路

ROS2现在主流是Humble和Galactic。我个人习惯用Humble，因为它支持到2024年，稳定性也最好。你想想看，如果选了个快过期的版本，后面升级驱动包时得多头疼。

安装命令其实很简单，但有几个细节要注意：

# 设置locale（这一步很多人跳过，结果中文乱码）
sudo apt update && sudo apt install locales
sudo locale-gen en_US en_US.UTF-8
sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8

# 添加ROS2源
sudo apt install software-properties-common
sudo add-apt-repository universe

# 安装ROS2 Humble桌面版（包含Rviz2等工具）
sudo apt install ros-humble-desktop

# 安装编译工具
sudo apt install python3-colcon-common-extensions

安装完后，记得把source命令加到.bashrc里：

echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

验证一下：ros2 run demo_nodes_cpp talker，如果能看到“Hello World”输出，说明环境成了。

2.2 AMR驱动包编译——colcon的坑与技巧

驱动包编译，说白了就是把你的电机驱动、激光雷达驱动、IMU驱动等打包成ROS2节点。我建议用colcon而不是catkin，因为colcon对Python和C++混合项目支持更好。

先创建一个工作空间：

mkdir -p ~/amr_ws/src
cd ~/amr_ws
colcon build

然后把你的驱动包放到src/目录下。这里有个关键点——依赖检查。很多驱动包依赖其他ROS2包，比如nav_msgs、sensor_msgs。如果缺了，编译会报错。

编译命令也很讲究：

# 只编译修改过的包（快很多）
colcon build --packages-select your_driver_package

# 编译并运行测试
colcon build --packages-select your_driver_package --cmake-args -DBUILD_TESTING=ON

# 如果遇到链接错误，试试清理重编
colcon build --packages-select your_driver_package --cmake-clean-cache

我记得有一次，编译一个激光雷达驱动，死活报找不到libpcap。后来发现是系统里装了libpcap0.8，但驱动需要libpcap-dev。嗯，这种坑防不胜防。

2.3 调试工具链配置——Rviz2、Foxglove、PlotJuggler

这三样工具，是我调试AMR的“三剑客”。各有各的用处，缺一不可。

2.3.1 Rviz2——可视化调试的基石

Rviz2是ROS2自带的3D可视化工具。安装很简单，装桌面版ROS2时已经带了。启动命令：

ros2 run rviz2 rviz2

但光启动没用，你得配置显示内容。我一般会添加这几个显示项：

• RobotModel：显示机器人模型，检查URDF是否正确
• LaserScan：显示激光雷达数据，看有没有遮挡或异常
• Odometry：显示里程计轨迹，判断定位是否漂移
• TF：显示坐标系变换，这是AMR调试的核心

2.3.2 Foxglove——现代版调试利器

Foxglove比Rviz2更轻量，而且支持Web端。我个人特别喜欢它的面板布局功能，可以同时看数据曲线、3D视图和日志。

安装方式：

# 通过Snap安装（推荐）
sudo snap install foxglove-studio

# 或者用AppImage
wget https://get.foxglove.dev/desktop/latest/foxglove-studio-*.AppImage
chmod +x foxglove-studio-*.AppImage
./foxglove-studio-*.AppImage

连接ROS2时，记得先启动ros2 bag或者直接连接实时话题。Foxglove支持ros2协议，不需要额外配置。

2.3.3 PlotJuggler——数据曲线分析神器

PlotJuggler专门用来画数据曲线。调试PID参数、分析传感器噪声时，这东西比Rviz2好用一百倍。

安装：

sudo apt install ros-humble-plotjuggler

启动后，选择“Start”然后订阅话题。比如你想看电机速度，就订阅/motor_speed话题。PlotJuggler会自动解析消息类型，你只需要选择要显示的字段。

我常用的调试场景：

• PID调参：同时显示目标速度和实际速度，看超调量和响应时间
• IMU数据分析：看加速度计和陀螺仪的噪声水平，判断是否需要滤波
• 里程计对比：同时显示轮式里程计和激光里程计，看偏差趋势

2.4 工具链集成——让它们协同工作

光装好工具还不够，得让它们配合起来。我一般会写一个启动脚本，一键启动所有调试工具：

#!/bin/bash
# 启动ROS2核心
ros2 daemon start

# 启动Rviz2（加载预设配置）
ros2 run rviz2 rviz2 -d ~/amr_ws/config/default.rviz &

# 启动PlotJuggler（加载预设布局）
ros2 run plotjuggler plotjuggler -l ~/amr_ws/config/default.xml &

# 启动Foxglove（通过Web界面）
foxglove-studio &

echo "调试环境已启动，祝你好运！"

嗯，这里要注意，Rviz2和PlotJuggler的配置文件要提前保存好。我习惯把配置文件放在工作空间的config/目录下，这样换机器时直接拷贝。

2.5 知识体系总览

下面这张图，是我自己总结的调试环境搭建逻辑。你看一眼，心里就有数了：

这张图把整个调试环境搭建的逻辑串起来了。从底层ROS2环境，到驱动编译，再到三件套工具，最后落到具体的调试场景和避坑点。你照着这个思路走，基本不会迷路。

---