第3章 全局代价地图参数详解：inflation_layer、static_layer、obstacle_layer 的配置与避坑

全局代价地图，说白了就是机器人用来「看全局」的那张图。它告诉规划器：哪里能走，哪里不能走，哪里靠近障碍物要绕远点。我刚开始接触导航栈的时候，总觉得代价地图嘛，不就是把地图和传感器数据叠一叠？后来被现实狠狠教育了几次——参数没配好，机器人要么贴着墙走，要么在空旷地方突然急刹。嗯，这一章咱们就把三个核心层掰开揉碎讲清楚。

3.1 static_layer —— 地图的「底图」

static_layer 负责加载你预先建好的静态地图。说白了，它就是一张黑白图——黑色是障碍，白色是自由空间，灰色是未知区域。我个人习惯把地图分辨率设在 0.05m，太高了计算量大，太低了路径容易钻缝。

3.2 obstacle_layer —— 实时障碍物的「眼睛」

这一层负责把激光雷达、深度相机等传感器的数据实时注入代价地图。你想想看，如果没有这一层，机器人就是个瞎子——静态地图再准，也挡不住突然出现的纸箱或者人。

配置时最核心的是 observation_sources，它是一个列表，告诉代价地图你要用哪些传感器。每个传感器源还有一堆子参数：

参数	说明	我的建议值
obstacle_range	障碍物最大检测距离	2.5 ~ 3.0 米（室内）
raytrace_range	清除障碍的最大距离	3.0 ~ 4.0 米
marking	是否标记障碍	true
clearing	是否清除障碍（自由空间）	true
data_type	传感器数据类型	"LaserScan" 或 "PointCloud2"

还有一个容易被忽略的参数——combination_method。它决定了多个传感器源的代价如何合并。默认是 0（最大值），我个人习惯用 1（叠加），这样多个传感器同时检测到障碍时，代价会更高，机器人会更谨慎。

3.3 inflation_layer —— 安全缓冲区的「守护神」

这一层的作用，说白了就是把障碍物「撑胖」一圈。机器人不是质点，它有尺寸。inflation_layer 会在障碍物周围生成一个代价梯度，越靠近障碍代价越高，规划器就会主动绕开。

两个核心参数：

• inflation_radius：膨胀半径。我一般设成机器人宽度的一半再加 0.1~0.2 米。比如机器人宽 0.5m，我就设 0.35m。
• cost_scaling_factor：代价衰减因子。值越大，代价下降越快。默认是 10.0，但我觉得太陡了，容易让路径贴着膨胀边缘走。我习惯用 5.0 ~ 8.0。

3.4 三层协作的典型配置示例

下面是一个我常用的全局代价地图配置文件（YAML 格式），你可以直接拿去改：

global_costmap:
  global_frame: map
  robot_base_frame: base_footprint
  update_frequency: 1.0
  publish_frequency: 0.5
  width: 20.0
  height: 20.0
  resolution: 0.05
  static_map: true
  rolling_window: false

  plugins:
    - {name: static_layer, type: "costmap_2d::StaticLayer"}
    - {name: obstacle_layer, type: "costmap_2d::ObstacleLayer"}
    - {name: inflation_layer, type: "costmap_2d::InflationLayer"}

  static_layer:
    map_topic: map
    subscribe_to_updates: false
    track_unknown_space: true

  obstacle_layer:
    observation_sources: laser_scan_sensor
    laser_scan_sensor: {
      sensor_frame: laser_frame,
      data_type: LaserScan,
      topic: /scan,
      marking: true,
      clearing: true,
      obstacle_range: 2.5,
      raytrace_range: 3.5
    }
    combination_method: 1

  inflation_layer:
    inflation_radius: 0.35
    cost_scaling_factor: 6.0

3.5 几个让我印象深刻的坑

• 坑一：地图坐标系对不上。 有一次我换了新雷达，忘了改 sensor_frame，结果障碍物全偏移了半米。检查 TF 树永远是第一步。
• 坑二：update_frequency 太高。 全局代价地图不需要高频更新，1Hz 足够。设成 5Hz 只会浪费 CPU，而且可能导致路径频繁重规划。
• 坑三：rolling_window 与 static_map 冲突。 如果你用滚动窗口，static_map 必须设成 false。我见过有人两个都设 true，然后地图一片空白。