Cartographer安装全攻略：从零开始到实战测试（手把手教学）
1. 为什么选择Cartographer？
如果你正在寻找一个开源的实时SLAM（同步定位与地图构建）解决方案，Cartographer绝对值得考虑。它由谷歌开发，特别擅长处理大规模环境下的2D/3D建图任务。我在实际项目中使用过多次，最直观的感受是它对激光雷达数据的处理非常高效，而且生成的栅格地图质量相当不错。
Cartographer最大的优势在于它的实时性和可扩展性。比如在机器人导航项目中，我测试过在16核CPU上它能实时处理每秒数万点的激光数据。对于初学者来说，它的另一个优点是文档相对完善，社区支持也比较活跃。不过要注意的是，它对系统环境的要求比较严格，这也是为什么很多人在安装阶段就会遇到各种问题。
2. 安装前的准备工作
2.1 硬件与系统要求
根据我的经验，Cartographer在以下环境中运行最稳定：
- 操作系统：Ubuntu 18.04/20.04（推荐LTS版本）
- ROS版本：Melodic或Noetic
- 内存：至少8GB（处理大型地图建议16GB+）
- CPU：四核以上（实测双核机器编译会非常慢）
注意：如果你用的是Windows系统，建议使用WSL2或直接安装双系统。我在WSL1上尝试过，由于文件系统性能问题，编译过程异常缓慢。
2.2 基础环境配置
首先更新系统软件包，这个步骤看似简单但很重要：
sudo apt-get update sudo apt-get upgrade -y接着安装一些基础开发工具：
sudo apt-get install -y build-essential cmake git wget如果你打算用ROS，需要先完成ROS基础安装。这里以Melodic为例：
sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list' sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 sudo apt-get update sudo apt-get install ros-melodic-desktop-full3. 两种安装方式详解
3.1 二进制安装（推荐新手）
这是最快捷的方式，适合只想快速体验Cartographer功能的用户：
sudo apt-get install ros-$(rosversion -d)-cartographer*安装完成后验证：
roscd cartographer_ros如果能正常进入目录，说明安装成功。
不过要注意，二进制版本可能存在两个问题：
- 版本可能不是最新的
- 某些高级功能可能被禁用
3.2 源码安装（完整功能）
3.2.1 安装依赖库
这是最关键的步骤之一，缺少任何依赖都可能导致后续编译失败：
sudo apt-get install -y \ cmake \ g++ \ git \ google-mock \ libboost-all-dev \ libcairo2-dev \ libeigen3-dev \ libgflags-dev \ libgoogle-glog-dev \ liblua5.2-dev \ libsuitesparse-dev \ libwebp-dev \ ninja-build \ protobuf-compiler \ python-sphinx3.2.2 Protobuf3特别处理
Cartographer需要Protobuf3，但ROS默认安装的是Protobuf2，这会导致版本冲突。我踩过这个坑，解决方法如下：
先卸载旧版本：
sudo apt-get remove libprotobuf-dev protoc --version # 确认是否已卸载安装Protobuf3依赖：
sudo apt-get install autoconf automake libtool curl make g++ unzip克隆并编译Protobuf3.6.0：
git clone -b v3.6.0 https://github.com/protocolbuffers/protobuf.git cd protobuf git submodule update --init --recursive ./autogen.sh ./configure make -j$(nproc) make check sudo make install sudo ldconfig最后确保protoc路径正确：
sudo cp /usr/local/bin/protoc /usr/bin4. 编译Cartographer
4.1 创建工作空间
建议单独创建一个工作空间：
mkdir -p ~/carto_ws/src cd ~/carto_ws/src克隆必要的仓库：
git clone https://github.com/googlecartographer/cartographer_ros.git git clone https://github.com/googlecartographer/cartographer.git git clone https://github.com/ceres-solver/ceres-solver.git4.2 编译Ceres Solver
Ceres是Cartographer依赖的优化库：
cd ceres-solver mkdir ceres-bin cd ceres-bin cmake .. make -j$(nproc) make test sudo make install4.3 编译Cartographer核心
这一步耗时较长（在我的i7笔记本上约30分钟）：
cd ~/carto_ws rosdep update rosdep install --from-paths src --ignore-src --rosdistro=$(rosversion -d) -y cd src/cartographer mkdir build cd build cmake .. -G Ninja ninja ninja test sudo ninja install4.4 编译ROS接口
最后编译ROS封装：
cd ~/carto_ws catkin_make_isolated --install --use-ninja source install_isolated/setup.bash5. 测试与验证
5.1 下载测试数据集
官方提供了几个示例bag文件：
wget -P ~/Downloads https://storage.googleapis.com/cartographer-public-data/bags/backpack_2d/cartographer_paper_deutsches_museum.bag5.2 运行2D建图测试
启动2D建图demo：
roslaunch cartographer_ros demo_backpack_2d.launch bag_filename:=${HOME}/Downloads/cartographer_paper_deutsches_museum.bag你应该能在RViz中看到实时构建的地图。我建议首次运行时打开终端查看输出信息，确保没有警告或错误。
5.3 常见问题解决
问题1：rosdep初始化失败
sudo rosdep init rosdep update问题2：缺少依赖项如果编译报错缺少某个库，可以用apt-file查找：
sudo apt-get install apt-file sudo apt-file update apt-file search 缺少的头文件名.h问题3：Protobuf版本冲突如果遇到protobuf相关错误，可以检查版本：
protoc --version确保输出是libprotoc 3.6.0
6. 进阶配置建议
安装完成后，你可能需要调整一些参数以获得更好的性能：
- 优化编译选项： 在cmake时添加：
-DCMAKE_BUILD_TYPE=Release- 调整线程数： ninja编译时可以使用：
ninja -j$(nproc)- 内存不足处理： 如果编译过程中被kill，可以尝试：
ninja -j2 # 减少并行编译任务数- 保存配置文件： 建议将环境变量写入bashrc：
echo "source ~/carto_ws/install_isolated/setup.bash" >> ~/.bashrc我在实际使用中发现，Cartographer对激光雷达的校准质量非常敏感。如果建图效果不理想，建议先检查传感器的标定数据。另外，对于室内场景，将trajectory_builder_2d.lua中的submaps.num_range_data调小（如从90改为60）可以提升细节表现。