4、Launch文件进阶：参数传递、条件判断、包含其他Launch、命名空间与重映射等高级特性

在ROS2的工程化交付中，Launch文件早已不是简单的节点启动脚本，而是整个机器人应用系统的“编排中枢”。当系统包含多个传感器驱动、导航算法、视觉处理容器以及硬件接口节点时，仅靠基础的 node 标签堆叠无法应对复杂的部署需求。本章将深入剖析Launch文件的高级特性，包括参数传递机制、条件判断逻辑、Launch文件嵌套包含、命名空间隔离与话题重映射。这些特性直接决定了系统能否在不同硬件平台、不同运行模式（仿真/实车）之间灵活切换，是衡量一个ROS2开发者是否具备“交付思维”的关键分水岭。

在深入细节之前，我们需要建立对Launch文件本质的认知：它并非编程语言，而是一种声明式配置语言，基于XML或Python（launch_pytest等）描述节点启动的拓扑关系与参数环境。高级特性的核心价值在于“复用”与“隔离”——复用意味着同一套Launch文件可以通过参数化适配不同场景，隔离则确保多机器人或多模块运行时互不干扰。下面我们逐一拆解这些特性。

4.1 参数传递：从硬编码到动态配置

核心原理

参数传递是Launch文件实现灵活性的基石。在ROS2中，参数分为Launch参数（用于控制Launch文件自身行为）和ROS节点参数（传递给节点的配置）。Launch参数通过 declare_launch_argument 声明，在启动时通过命令行 ros2 launch pkg file.launch.py arg:=value 传入。节点参数则通过 parameters 属性加载YAML文件或直接内联定义。这种双层参数结构允许我们在不修改代码的情况下，切换传感器配置、算法阈值或日志级别。

操作流程

1. 声明Launch参数：在 launch_arguments 字典中定义默认值。
2. 引用参数：使用 LaunchConfiguration('参数名') 在节点定义中动态引用。
3. 加载参数文件：通过 ParameterFile 或 SetParameter 实体将YAML文件内容注入节点。
4. 命令行覆盖：启动时通过 := 语法覆盖默认值。

# example.launch.py
from launch import LaunchDescription
from launch.actions import DeclareLaunchArgument
from launch.substitutions import LaunchConfiguration
from launch_ros.actions import Node

def generate_launch_description():
    return LaunchDescription([
        DeclareLaunchArgument('use_sim_time', default_value='false'),
        DeclareLaunchArgument('robot_name', default_value='tbot'),
        Node(
            package='robot_bringup',
            executable='core_node',
            name='core',
            parameters=[{
                'use_sim_time': LaunchConfiguration('use_sim_time'),
                'robot_id': LaunchConfiguration('robot_name')
            }]
        )
    ])

案例拆解：多传感器配置切换

假设我们有一个移动机器人平台，搭载激光雷达和深度相机。实车运行时需要启用硬件驱动，仿真时则使用静态数据发布器。通过参数传递，我们可以设计如下方案：

这种设计将“启动逻辑”与“具体配置”解耦，交付时只需提供不同的参数组合文件，无需维护多份Launch脚本。

4.2 条件判断：让Launch文件具备决策能力

核心原理

条件判断允许Launch文件根据运行环境或参数值动态决定是否执行某个动作。ROS2提供了 IfCondition 和 UnlessCondition 两个类，它们接受一个Python表达式字符串，返回布尔值。这类似于编程语言中的 if 语句，但作用于声明式配置层。条件判断的典型应用场景包括：是否启动可视化工具（RViz）、是否启用GPU加速、是否在仿真模式下运行。

判断方法

• 基于Launch参数判断：IfCondition(LaunchConfiguration('use_rviz'))，当参数值为 true 时执行。
• 基于环境变量判断：通过 EnvironmentVariable('ROS_DOMAIN_ID') 结合字符串比较。
• 复合条件：使用Python表达式如 LaunchConfiguration('mode') == 'debug' and LaunchConfiguration('verbose') == 'true'。

from launch.conditions import IfCondition, UnlessCondition
from launch.actions import ExecuteProcess

# 仅当 use_rviz 为 true 时启动 RViz
rviz_node = Node(
    package='rviz2',
    executable='rviz2',
    name='rviz',
    condition=IfCondition(LaunchConfiguration('use_rviz'))
)

实战场景：仿真与实车双模式切换

在交付给客户的机器人系统中，我们经常需要同时支持仿真演示和实车运行。通过条件判断，可以构建一个“智能”Launch文件：

1. 读取 sim_mode 参数。
2. 若为 true，启动Gazebo仿真环境、加载机器人模型、发布静态变换。
3. 若为 false，启动硬件驱动节点、连接串口或CAN总线。
4. 无论哪种模式，都启动导航堆栈和状态估计节点。

这种设计将环境差异封装在条件分支中，主逻辑保持单一，极大降低了维护成本。

4.3 包含其他Launch：构建模块化启动体系

核心原理

大型机器人系统通常由多个子系统组成（感知、规划、控制、交互）。将所有节点写在一个Launch文件中会导致文件臃肿、难以维护。IncludeLaunchDescription 允许我们将子系统拆分为独立的Launch文件，再通过组合方式构建顶层启动脚本。这类似于软件工程中的模块化设计，每个子系统可以独立开发、测试和交付。

操作流程

1. 定义子系统Launch：例如 sensors.launch.py、navigation.launch.py。
2. 在顶层包含：使用 IncludeLaunchDescription 指定子Launch文件的路径。
3. 传递参数：通过 launch_arguments 字典向子Launch传递参数。
4. 作用域隔离：子Launch中的参数和节点默认在独立作用域中，避免命名冲突。

from launch.actions import IncludeLaunchDescription
from launch.launch_description_sources import PythonLaunchDescriptionSource
from ament_index_python.packages import get_package_share_directory

sensors_launch = IncludeLaunchDescription(
    PythonLaunchDescriptionSource(
        get_package_share_directory('robot_bringup') + '/launch/sensors.launch.py'
    ),
    launch_arguments={'sensor_type': LaunchConfiguration('sensor_type')}.items()
)

案例拆解：多机器人系统组合

假设我们需要部署3台机器人协同工作。每台机器人拥有独立的命名空间（如 robot1、robot2），但共享同一套导航算法。通过包含机制，我们可以编写一个 single_robot.launch.py 处理单台机器人的完整启动，然后在顶层Launch中循环包含三次，每次传入不同的 namespace 参数。这种“模板+实例”的模式，使得扩展机器人数量只需修改顶层文件，无需改动子系统逻辑。

4.4 命名空间与重映射：实现资源隔离与灵活通信

核心原理

命名空间（Namespace）为节点、话题、服务提供了逻辑隔离边界。在ROS2中，命名空间通过 ns 属性设置，所有在该命名空间下的资源都会自动添加前缀。重映射（Remapping）则允许我们改变话题或服务的实际名称，而无需修改节点代码。这两者结合，可以解决多机器人场景下的资源冲突问题，以及不同算法模块间的接口适配问题。

操作流程

• 设置命名空间：在 Node 定义中添加 namespace='robot1'，则该节点的所有话题变为 /robot1/topic_name。
• 话题重映射：使用 remappings 参数，将节点内部的 /scan 映射到 /robot1/scan。
• 参数重映射：通过 parameters 中的 __ns 前缀或 SetParameter 实现。

Node(
    package='robot_navigation',
    executable='nav_node',
    namespace='robot1',
    remappings=[
        ('/scan', '/robot1/lidar/scan'),
        ('/odom', '/robot1/odometry')
    ]
)

实战场景：多机器人协同导航

在仓库物流场景中，多台AGV同时运行。若不使用命名空间，所有机器人都会订阅相同的 /cmd_vel 话题，导致指令混乱。通过为每台机器人分配独立命名空间，并重映射其控制话题，可以实现完全隔离的通信拓扑。同时，中央调度系统可以通过 /robot1/status、/robot2/status 分别获取各机器人状态，实现统一管理。

4.5 综合案例：构建可交付的机器人应用启动系统

现在我们将上述特性整合，设计一个完整的交付方案。假设我们要交付一套室内巡检机器人系统，要求支持单机演示和多机协同两种模式。

系统架构：

1. 基础层：base.launch.py 包含硬件驱动、传感器驱动、状态估计。
2. 功能层：navigation.launch.py 包含地图服务、路径规划、运动控制。
3. 交互层：ui.launch.py 包含RViz可视化、Web服务器。

参数化设计：

• robot_id：用于命名空间隔离。
• sim_mode：切换仿真/实车。
• enable_ui：控制是否启动可视化界面。

启动命令示例：

# 单机仿真模式
ros2 launch robot_bringup main.launch.py robot_id:=demo1 sim_mode:=true enable_ui:=true

# 多机实车模式（机器人2）
ros2 launch robot_bringup main.launch.py robot_id:=robot2 sim_mode:=false enable_ui:=false

实施效果：通过参数组合，同一套Launch文件可以适配4种不同场景（单机/多机 × 仿真/实车），且所有节点资源通过命名空间完全隔离。交付时只需提供一份Launch文件集和参数说明文档，客户即可自行部署。

4.6 常见误区与总结

总结而言，Launch文件的高级特性是ROS2工程化交付的核心工具。参数传递提供了灵活性，条件判断赋予了适应性，包含机制实现了模块化，命名空间与重映射保障了隔离性。掌握这些特性，意味着你能够构建出既健壮又易扩展的机器人应用系统。在实际项目中，建议从简单的参数化开始，逐步引入包含和条件判断，最后根据多机需求设计命名空间方案。这种渐进式的设计方法，能够有效控制复杂度，确保交付质量。