Ubuntu20.04下Cartographer从零部署到实战建图导航
1. 环境准备：从零搭建Ubuntu20.04开发环境
刚接触Cartographer时，我最头疼的就是环境配置。记得第一次尝试时，因为漏装了几个依赖包，编译卡了整整一晚上。后来发现，干净的Ubuntu20.04系统才是最佳起点。下面是我总结的避坑指南：
首先确保系统已更新：
sudo apt-get update && sudo apt-get upgrade -y核心依赖安装（比官网多加了两个常用工具）：
sudo apt-get install -y python3-wstool python3-rosdep ninja-build stow liblua5.3-dev libboost-all-dev这里特别提醒：liblua5.3-dev是Lua脚本支持的关键，而libboost-all-dev会避免后续C++编译时的兼容性问题。我曾在树莓派上因为漏装后者，导致Cartographer节点频繁崩溃。
创建工作空间时有个小技巧：
mkdir -p ~/cartographer_ws/src cd ~/cartographer_ws/src git clone --recurse-submodules https://github.com/googlecartographer/cartographer_ros.git使用--recurse-submodules参数能自动下载子模块，比单独克隆三个仓库更可靠。去年帮学弟调试时发现，手动克隆ceres-solver经常会出现版本不匹配的问题。
2. 源码编译：解决Abseil依赖的玄学问题
编译环节最容易卡在Abseil库。有次在NVIDIA Jetson上编译，系统自带的Abseil版本直接导致SLAM轨迹漂移。后来发现必须用Cartographer自带的安装脚本：
cd ~/cartographer_ws src/cartographer/scripts/install_abseil.sh这个脚本会自动编译适合当前系统的版本。如果遇到权限问题，记得用chmod +x给脚本加执行权限。
修改package.xml的隐藏坑：
- 用VS Code打开
~/cartographer_ws/src/cartographer/package.xml - 搜索
libabsl-dev，把整行<depend>libabsl-dev</depend>删除 - 保存后执行：
rosdep update && rosdep install --from-paths src --ignore-src -y编译命令推荐这样用：
catkin_make_isolated --install --use-ninja -DCMAKE_BUILD_TYPE=Release加上Release参数能提升20%左右的运行效率。去年用Debug模式跑建图，差点以为我的Turtlebot3电池坏了——实际是没开编译器优化。
3. 配置文件深度解析：从Demo到实战的关键调整
新手最容易栽在Lua配置上。去年给学校机器人社团培训时，10个人里有8个因为tracking_frame设错导致地图错乱。关键参数得这样配：
-- 坐标系设置（实测Turtlebot3配置） tracking_frame = "base_footprint", -- 底盘坐标系 odom_frame = "odom", -- 里程计坐标系 published_frame = "base_footprint", -- 发布坐标系 -- 激光雷达参数（适合RPLIDAR A1） TRAJECTORY_BUILDER_2D.min_range = 0.2 -- 最小检测距离 TRAJECTORY_BUILDER_2D.max_range = 8.0 -- 最大检测距离 TRAJECTORY_BUILDER_2D.missing_data_ray_length = 5.0 -- 缺失数据处理 -- 特别提醒：室内环境要把use_imu_data设为false TRAJECTORY_BUILDER_2D.use_imu_data = false上周用这套配置给仓库AGV建图，8米长廊的闭合误差不到3cm。如果发现建图有重影，试试把POSE_GRAPH.constraint_builder.min_score调到0.8以上。
Launch文件要注意这几个细节：
<node name="cartographer_node" pkg="cartographer_ros" args="-configuration_directory $(find cartographer_ros)/configuration_files -configuration_basename agv_map.lua" output="screen"> <remap from="scan" to="/scan" /> <!-- 确保与雷达话题一致 --> </node>曾经有次把/scan写成scan，结果RViz里死活不出点云。建议先用rostopic list确认话题名称。
4. 实战建图与导航：从保存地图到路径规划
保存地图的正确姿势：
# 先结束当前轨迹（0是默认轨迹ID） rosservice call /finish_trajectory 0 # 保存为pbstream格式（支持后续继续建图） rosservice call /write_state "{filename: '/home/user/maps/warehouse.pbstream'}" # 转成ROS标准地图 rosrun cartographer_ros cartographer_pbstream_to_ros_map \ -map_filestem=/home/user/maps/warehouse \ -pbstream_filename=/home/user/maps/warehouse.pbstream \ -resolution=0.05上个月做项目时发现，直接存pgm会丢失位姿信息。后来用pbstream+pgm双备份，既方便查看又能继续编辑。
导航启动技巧：
- 先加载已有地图：
roslaunch cartographer_ros demo_backpack_2d.launch \ load_state_filename:=/home/user/maps/warehouse.pbstream- 再启动move_base：
roslaunch turtlebot3_navigation turtlebot3_navigation.launch \ map_file:=/home/user/maps/warehouse.yaml实测在D435i相机+RTAB-Map的组合下，这套流程能让Turtlebot3在20m²区域内稳定自主导航。如果遇到路径规划卡顿，记得调小planner_frequency参数。