ROS 多节点独立终端一键启动方案(解决端口冲突)
适用场景:在无人机/机器人项目中,需要同时启动相机驱动、视觉检测、通信节点等多个 ROS 节点,且希望每个节点的输出显示在独立的终端窗口中,便于分别观察调试信息,避免所有输出混杂在同一个终端里。
本方案同时解决了多个roslaunch同时启动导致的roscore端口占用(Address already in use)和run_id冲突 问题。
📌 目录
🖥️ 最终效果
执行一键命令后,会弹出 5 个独立终端窗口,分别运行:
| 终端标题 | 运行内容 |
|---|---|
ROSCORE | roscore(ROS 主节点) |
RealSense Camera | roslaunch realsense2_camera rs_camera.launch |
Apriltag Landing | roslaunch apriltag_landing test.launch |
UAV Receiver | roslaunch uav_communication uav_receiver.launch |
rqt_image_view | rqt_image_view(图像显示工具) |
每个窗口实时输出对应节点的日志,互不干扰,关闭任一窗口即终止对应节点。
📦 前置条件
- 操作系统:Ubuntu 18.04 / 20.04(或其它 ROS 支持的版本)
- ROS 已安装(Melodic 或 Noetic)
- 已创建 ROS 工作空间(例如
uav_ws) - 以下功能包已下载并编译:
realsense2_cameraapriltag_landinguav_communicationrqt_image_view
如果你使用不同的包名或工作空间,请对应修改脚本中的路径和包名。
🚀 操作步骤(逐条指令)
1. 确认 ROS 版本
打开终端(Ctrl+Alt+T),输入:
echo $ROS_DISTRO
- 若输出
noetic→ 脚本中使用/opt/ros/noetic - 若输出
melodic→ 脚本中使用/opt/ros/melodic - 若输出其他版本,同样替换即可。
2. 创建脚本目录
假设你的功能包名为 apriltag_landing(请替换为你的实际包名),进入该包并创建 scripts 文件夹:
cd ~/uav_ws/src/apriltag_landing # 请修改为你的工作空间和包路径
mkdir -p scripts
cd scripts
~/uav_ws是你的工作空间根目录,如果不是,请替换。apriltag_landing是你的功能包名,如果不是,请替换。
3. 生成启动脚本
复制以下整段命令(从 cat 到 EOF)粘贴到终端并回车,即可一步创建 start_all.sh 文件。
⚠️ 务必根据你的 ROS 版本和工作空间修改脚本内的路径(见注释)。
cat > start_all.sh << 'EOF'
#!/bin/bash
# =====================================================
# 一键启动所有 ROS 节点,每个节点独立终端显示
# 适用于 ROS Noetic / Melodic,请按实际情况修改路径
# =====================================================
# ----- 请修改以下两行以匹配你的环境 -----
ROS_DISTRO_PATH="/opt/ros/noetic" # 改为 /opt/ros/melodic 或其他
WORKSPACE_PATH="$HOME/uav_ws" # 改为你的工作空间路径
# --------------------------------------
source $ROS_DISTRO_PATH/setup.bash
source $WORKSPACE_PATH/devel/setup.bash
# 1. 启动 roscore(独立终端)
gnome-terminal --title="ROSCORE" -- bash -c "
source $ROS_DISTRO_PATH/setup.bash;
source $WORKSPACE_PATH/devel/setup.bash;
roscore;
exec bash"
# 等待 roscore 完全启动(3~5 秒)
sleep 3
# 2. 启动各功能节点(请修改为你的实际 launch 文件路径)
gnome-terminal --title="RealSense Camera" -- bash -c "
source $ROS_DISTRO_PATH/setup.bash;
source $WORKSPACE_PATH/devel/setup.bash;
roslaunch realsense2_camera rs_camera.launch;
exec bash"
gnome-terminal --title="Apriltag Landing" -- bash -c "
source $ROS_DISTRO_PATH/setup.bash;
source $WORKSPACE_PATH/devel/setup.bash;
roslaunch apriltag_landing test.launch;
exec bash"
gnome-terminal --title="UAV Receiver" -- bash -c "
source $ROS_DISTRO_PATH/setup.bash;
source $WORKSPACE_PATH/devel/setup.bash;
roslaunch uav_communication uav_receiver.launch;
exec bash"
gnome-terminal --title="rqt_image_view" -- bash -c "
source $ROS_DISTRO_PATH/setup.bash;
source $WORKSPACE_PATH/devel/setup.bash;
rqt_image_view;
exec bash"
EOF
如果报错
gnome-terminal: command not found,请安装:sudo apt install gnome-terminal,或改用xterm(见后文故障排查)。
4. 赋予执行权限
chmod +x start_all.sh
5. 添加别名(可选,方便一键启动)
将别名写入 ~/.bashrc,之后只需输入 startall 即可启动:
echo 'alias startall="~/uav_ws/src/apriltag_landing/scripts/start_all.sh"' >> ~/.bashrc
source ~/.bashrc
- 请将
~/uav_ws/src/apriltag_landing/scripts/start_all.sh替换为你脚本的实际绝对路径。
6. 测试运行
- 如果有残留 ROS 进程,先清理:
killall roscore rosmaster 2>/dev/null - 在任意终端输入:
或直接执行脚本:startall~/uav_ws/src/apriltag_landing/scripts/start_all.sh
观察是否弹出 5 个终端,且各节点正常运行无报错。
📝 脚本内容详解
| 部分 | 说明 |
|---|---|
source /opt/ros/noetic/setup.bash | 加载 ROS 环境变量,请根据实际 ROS 版本修改。 |
source ~/uav_ws/devel/setup.bash | 加载工作空间环境变量,请根据实际工作空间路径修改。 |
gnome-terminal --title="..." -- bash -c "..." | 打开一个新终端,并执行双引号内的命令。 |
sleep 3 | 等待 roscore 完全启动,避免后续节点连接失败(可适当延长)。 |
exec bash | 使命令执行完毕后终端保持打开,便于查看历史输出。 |
所有新终端内部都需要重新 source 环境,因为它们是独立的 shell 进程。
🔧 故障排查
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
gnome-terminal: command not found | 未安装 gnome-terminal | 安装:sudo apt install gnome-terminal;或改用 xterm,将脚本中 gnome-terminal --title="标题" -- bash -c "..." 替换为 xterm -T "标题" -e "bash -c '...; exec bash'" |
部分终端闪退,提示 Address already in use | 之前有 roscore 残留 | 运行 killall roscore rosmaster 后重试 |
找不到 realsense2_camera 等包 | 工作空间未编译或包未安装 | 确认 ~/uav_ws/devel/setup.bash 存在,并执行 catkin_make(或 catkin build) |
别名 startall 无效 | 未 source 或路径写错 | 执行 source ~/.bashrc,并检查别名中的路径是否正确 |
| 节点启动后立即退出 | roscore 未完全启动 | 增加 sleep 时间(如 sleep 5) |
📦 多设备迁移清单
当你需要将本方案部署到另一台相同/相似设备时,请按以下步骤操作:
- 复制脚本文件到目标设备的相同路径(或你自定义的路径)。
- 检查 ROS 版本:
echo $ROS_DISTRO,修改脚本中的/opt/ros/noetic为实际版本。 - 检查工作空间路径:修改脚本中
$WORKSPACE_PATH变量为你的工作空间根目录。 - 检查功能包名:脚本中
roslaunch的包名和 launch 文件名需与目标设备一致(例如apriltag_landing test.launch)。 - 赋予执行权限:
chmod +x start_all.sh。 - 添加别名(可选):将别名路径改为脚本实际路径。
- 确保所有依赖包已编译,然后运行测试。
💡 总结
本方案解决了两个核心需求:
- 独立终端显示:每个节点单独一个终端,方便调试。
- 稳定的 roscore 管理:先启动 roscore,其他节点连接同一 master,避免端口冲突。
通过将脚本置于功能包 scripts 目录下,便于版本管理和团队协作。
希望这份笔记能帮助你高效管理 ROS 多节点启动流程。如有问题,欢迎在评论区交流讨论。
最后更新:2026-09-01
适用 ROS 版本:Melodic / Noetic
测试平台:Ubuntu 20.04 + ROS Noetic
528



被折叠的 条评论
为什么被折叠?



