告别手动开终端！用Python写ROS2 Launch文件，一键启动你的机器人项目
用Python自动化ROS2 Launch文件：告别繁琐的多终端启动
每次调试机器人项目都要手动打开五六个终端窗口的日子该结束了。想象一下这样的场景：你正在开发一个移动机器人原型，需要同时启动传感器驱动、SLAM算法、导航模块等多个节点。每次修改代码后，都要重复输入一堆ros2 run命令，不仅浪费时间，还容易出错。ROS2的Launch文件正是为解决这个痛点而生，而Python编写的Launch文件更是将自动化发挥到极致。
1. 为什么需要Launch文件自动化
在ROS2开发中，一个完整的机器人系统通常由多个相互协作的节点组成。以典型的移动机器人为例，可能需要同时运行：
- 激光雷达驱动节点
- 摄像头驱动节点
- SLAM建图节点
- 导航规划节点
- 底盘控制节点
- 可视化工具节点
手动启动的弊端显而易见：
- 需要记忆每个节点的包名和可执行文件名
- 每次调试都要重复输入大量命令
- 难以保持节点启动顺序的一致性
- 参数配置分散在各个终端，难以管理
# 典型的手动启动方式示例 ros2 run lidar_driver lidar_node ros2 run camera_driver camera_node ros2 run slam_toolbox slam_node ros2 run navigation navigation_node ros2 run robot_controller controller_node ros2 run rviz2 rviz2相比之下，Python编写的Launch文件提供了以下优势：
| 特性 | 手动启动 | Launch文件 |
|---|---|---|
| 启动效率 | 低（逐个启动） | 高（一键启动） |
| 参数管理 | 分散 | 集中 |
| 可维护性 | 差 | 好 |
| 复用性 | 无 | 强 |
| 错误率 | 高 | 低 |
2. 构建你的第一个Python Launch文件
让我们从最简单的例子开始，创建一个能够启动turtlesim模拟器和键盘控制节点的Launch文件。
2.1 基础框架
每个Python Launch文件都遵循相同的基本结构：
from launch import LaunchDescription def generate_launch_description(): return LaunchDescription([ # 在这里添加你的节点和操作 ])这个框架的核心是generate_launch_description()函数，它返回一个包含所有启动操作的LaunchDescription对象。
2.2 添加节点
要为turtlesim添加节点，我们可以使用Node动作：
from launch_ros.actions import Node def generate_launch_description(): turtlesim_node = Node( package='turtlesim', executable='turtlesim_node', name='sim' ) return LaunchDescription([ turtlesim_node ])对于需要终端交互的节点（如键盘控制），我们可以使用ExecuteProcess：
from launch.actions import ExecuteProcess teleop_key = ExecuteProcess( cmd=['xterm', '-e', 'ros2', 'run', 'turtlesim', 'turtle_teleop_key'], name='teleop_key' )注意：使用
ExecuteProcess需要系统安装xterm，可以通过sudo apt-get install xterm安装
2.3 完整示例
将上述内容组合起来，我们得到一个完整的Launch文件：
from launch import LaunchDescription from launch_ros.actions import Node from launch.actions import ExecuteProcess def generate_launch_description(): turtlesim_node = Node( package='turtlesim', executable='turtlesim_node', name='sim' ) teleop_key = ExecuteProcess( cmd=['xterm', '-e', 'ros2', 'run', 'turtlesim', 'turtle_teleop_key'], name='teleop_key' ) return LaunchDescription([ turtlesim_node, teleop_key ])3. 进阶Launch文件技巧
掌握了基础后，让我们看看如何将Launch文件应用到更复杂的机器人项目中。
3.1 参数配置
ROS2节点通常需要参数配置，Launch文件提供了多种参数传递方式：
直接在Launch文件中设置参数：
Node( package='my_package', executable='my_node', name='my_node', parameters=[{ 'param1': 42, 'param2': 'value' }] )从YAML文件加载参数：
import os from ament_index_python.packages import get_package_share_directory config = os.path.join( get_package_share_directory('my_package'), 'config', 'params.yaml' ) Node( package='my_package', executable='my_node', name='my_node', parameters=[config] )3.2 命名空间管理
当系统中有多个相同类型的节点时，命名空间可以避免名称冲突：
Node( package='sensor_driver', executable='lidar_node', name='lidar', namespace='front' ) Node( package='sensor_driver', executable='lidar_node', name='lidar', namespace='rear' )3.3 条件启动
有时我们需要根据条件决定是否启动某些节点：
from launch.conditions import IfCondition from launch.substitutions import LaunchConfiguration Node( package='my_package', executable='my_node', name='my_node', condition=IfCondition(LaunchConfiguration('launch_my_node')) )然后在启动时可以通过参数控制：
ros2 launch my_package my_launch_file.py launch_my_node:=true4. 构建模块化Launch系统
对于大型机器人项目，建议采用模块化的Launch文件结构：
launch/ ├── sensors.launch.py # 所有传感器节点 ├── perception.launch.py # 感知相关节点 ├── navigation.launch.py # 导航相关节点 └── main.launch.py # 主启动文件，包含其他模块主启动文件示例：
import os from ament_index_python.packages import get_package_share_directory from launch import LaunchDescription from launch.actions import IncludeLaunchDescription from launch.launch_description_sources import PythonLaunchDescriptionSource def generate_launch_description(): sensors = IncludeLaunchDescription( PythonLaunchDescriptionSource([ os.path.join( get_package_share_directory('my_robot'), 'launch', 'sensors.launch.py' ) ]) ) perception = IncludeLaunchDescription( PythonLaunchDescriptionSource([ os.path.join( get_package_share_directory('my_robot'), 'launch', 'perception.launch.py' ) ]) ) navigation = IncludeLaunchDescription( PythonLaunchDescriptionSource([ os.path.join( get_package_share_directory('my_robot'), 'launch', 'navigation.launch.py' ) ]) ) return LaunchDescription([ sensors, perception, navigation ])这种模块化设计带来了以下好处：
- 各功能模块解耦
- 便于单独测试特定子系统
- 提高代码复用率
- 更清晰的系统架构
5. 实战：移动机器人Launch文件示例
让我们看一个更接近真实项目的例子，假设我们要为一个室内移动机器人创建Launch文件。
5.1 传感器启动模块
from launch import LaunchDescription from launch_ros.actions import Node import os from ament_index_python.packages import get_package_share_directory def generate_launch_description(): # LiDAR配置 lidar_config = os.path.join( get_package_share_directory('robot_bringup'), 'config', 'lidar.yaml' ) lidar_node = Node( package='rplidar_ros', executable='rplidar_node', name='rplidar_node', parameters=[lidar_config] ) # 摄像头配置 camera_config = os.path.join( get_package_share_directory('robot_bringup'), 'config', 'camera.yaml' ) camera_node = Node( package='usb_cam', executable='usb_cam_node_exe', name='usb_cam', parameters=[camera_config] ) return LaunchDescription([ lidar_node, camera_node ])5.2 SLAM启动模块
from launch import LaunchDescription from launch_ros.actions import Node import os from ament_index_python.packages import get_package_share_directory def generate_launch_description(): slam_config = os.path.join( get_package_share_directory('robot_bringup'), 'config', 'slam.yaml' ) slam_node = Node( package='slam_toolbox', executable='async_slam_toolbox_node', name='slam_toolbox', parameters=[slam_config], remappings=[ ('/scan', '/laser_scan'), ('/map', '/slam_map') ] ) return LaunchDescription([ slam_node ])5.3 导航启动模块
from launch import LaunchDescription from launch_ros.actions import Node import os from ament_index_python.packages import get_package_share_directory def generate_launch_description(): nav2_config = os.path.join( get_package_share_directory('robot_bringup'), 'config', 'nav2.yaml' ) nav2_node = Node( package='nav2_controller', executable='controller_server', name='controller_server', parameters=[nav2_config] ) planner_node = Node( package='nav2_planner', executable='planner_server', name='planner_server', parameters=[nav2_config] ) return LaunchDescription([ nav2_node, planner_node ])5.4 主启动文件
import os from ament_index_python.packages import get_package_share_directory from launch import LaunchDescription from launch.actions import IncludeLaunchDescription, DeclareLaunchArgument from launch.launch_description_sources import PythonLaunchDescriptionSource from launch.substitutions import LaunchConfiguration def generate_launch_description(): # 声明可配置参数 use_slam = DeclareLaunchArgument( 'use_slam', default_value='true', description='Whether to use SLAM' ) use_navigation = DeclareLaunchArgument( 'use_navigation', default_value='true', description='Whether to use navigation' ) # 包含各模块启动文件 sensors = IncludeLaunchDescription( PythonLaunchDescriptionSource([ os.path.join( get_package_share_directory('robot_bringup'), 'launch', 'sensors.launch.py' ) ]) ) slam = IncludeLaunchDescription( PythonLaunchDescriptionSource([ os.path.join( get_package_share_directory('robot_bringup'), 'launch', 'slam.launch.py' ) ]), condition=IfCondition(LaunchConfiguration('use_slam')) ) navigation = IncludeLaunchDescription( PythonLaunchDescriptionSource([ os.path.join( get_package_share_directory('robot_bringup'), 'launch', 'navigation.launch.py' ) ]), condition=IfCondition(LaunchConfiguration('use_navigation')) ) return LaunchDescription([ use_slam, use_navigation, sensors, slam, navigation ])这个完整的Launch系统可以让你通过一条命令启动整个机器人系统：
ros2 launch robot_bringup main.launch.py或者选择性启动部分功能：
ros2 launch robot_bringup main.launch.py use_slam:=false在实际项目中，我发现模块化的Launch文件结构大大简化了调试过程。当某个子系统出现问题时，可以单独测试该模块，而不必启动整个系统。同时，参数配置文件的使用使得调整系统行为变得非常方便，无需重新编译代码。