Ubuntu20.04下Ceres和g2o库安装全攻略：从依赖安装到编译避坑

关注

原创最新推荐文章于 2026-09-14 13:36:30 发布 717 阅读 AI 写同款· GEO 优化 ›

Ubuntu20.04安装Ceres库 ceres真难安装。阅读详情

Ubuntu 20.04 环境下 C++ 优化库实战部署：Ceres与g2o的深度配置与工程化指南

在机器人、自动驾驶和三维视觉领域，后端优化是构建精准地图与定位的核心。许多开发者和研究者初次踏入这片领域时，往往会被两个名字所吸引：Ceres Solver 和 g2o。它们如同优化世界的“倚天剑”与“屠龙刀”，一个以通用非线性最小二乘求解见长，另一个则专精于图优化框架。然而，在Ubuntu 20.04这个长期支持版本上，将它们从源码顺利编译并集成到自己的项目中，却远非几条命令那么简单。依赖版本冲突、编译选项的微妙差异、系统路径的配置，每一个环节都可能成为项目启动前的“拦路虎”。本文旨在为你提供一份超越普通安装教程的深度实战指南，不仅告诉你如何安装，更会剖析背后的原理，分享从依赖管理到编译调优，再到工程集成的全链路经验，目标是让你在Ubuntu 20.04上建立起一个稳定、高效且易于维护的优化算法开发环境。

1. 环境深度剖析与系统性准备

在动手敲下第一条安装命令之前，理解你的系统环境至关重要。Ubuntu 20.04 LTS (Focal Fossa) 提供了相对稳定的软件库，但这也意味着其默认仓库中的某些库版本可能并非最新。对于Ceres和g2o这类活跃开发的项目，我们需要在“系统稳定性”与“功能前沿性”之间做出权衡。

首先，更新你的系统包列表并升级现有软件包，这是一个良好的起点：

sudo apt update && sudo apt upgrade -y

接下来，我们需要安装一系列构建工具和基础依赖。这些工具是编译任何C++项目的基石：

sudo apt install -y build-essential cmake git pkg-config

build-essential：包含了GCC编译器、make等核心工具链。
cmake：Ceres和g2o都使用CMake作为构建系统，它是现代C++项目的标配。
git：用于从GitHub克隆源代码。
pkg-config：帮助编译器查找库文件和头文件。

一个常被忽略但极其重要的步骤是检查和管理系统中的多版本库。例如，你的系统可能同时存在多个版本的Python或GCC。使用update-alternatives命令可以清晰地查看和管理它们：

# 查看可用的GCC版本
sudo update-alternatives --config gcc
# 查看可用的Python3版本
sudo update-alternatives --config python3

确保你选择了与项目要求兼容的版本。对于Ubuntu 20.04，默认的GCC 9通常是安全的。

2. Ceres Solver：非线性最小二乘求解器的精装部署

Ceres Solver由Google开发，以其鲁棒性、速度和丰富的接口著称。它的安装过程相对标准，但细节决定成败。

2.1 依赖库的精准安装与版本考量

Ceres依赖于一系列数学和工具库。直接使用apt安装是最快捷的方式，但让我们理解每一个依赖的作用：

sudo apt install -y libgoogle-glog-dev libgflags-dev libatlas-base-dev libeigen3-dev libsuitesparse-dev

注意：libgtest-dev通常用于编译和运行Ceres自带的测试，如果你不打算进行单元测试，可以省略。但安装它有助于验证编译是否正确。

让我们通过一个表格来快速理解这些核心依赖：

依赖库	主要功能	在Ceres中的作用
libeigen3-dev	高性能C++模板库，用于线性代数	矩阵运算的核心，Ceres重度依赖Eigen。
libsuitesparse-dev	稀疏矩阵处理算法套件（包含SuiteSparse）	提供稀疏Cholesky分解（如CHOLMOD）等高级求解器。
libgoogle-glog-dev	Google的日志库	输出详细的求解过程日志，便于调试。
libgflags-dev	Google的命令行标志解析库	处理Ceres求解器及示例程序中的命令行参数。
libatlas-base-dev	自动调优线性代数软件库	提供可选的BLAS/LAPACK实现，加速稠密矩阵运算。

关键点：libsuitesparse-dev 是安装中最容易出问题的依赖之一。确保它被正确安装，它包含了Ceres在解决大规模稀疏问题时所需的cxsparse和cholmod等组件。

2.2 源码获取与编译配置的艺术

不建议使用Ubuntu仓库中预编译的libceres-dev包，因为它可能版本较旧且功能受限。从GitHub获取最新稳定版源码是推荐做法。

# 克隆Ceres的源代码仓库
git clone https://github.com/ceres-solver/ceres-solver.git
cd ceres-solver
# 切换到最新的稳定标签，例如2.1.0（请查阅GitHub releases页面获取最新版本）
git checkout 2.1.0

现在，进入经典的CMake构建流程。build目录的创建是一个好习惯，它保持了源码树的整洁（Out-of-source build）。

mkdir build && cd build

接下来是配置阶段，这里有一些高级选项可以显著影响Ceres的性能和功能：

cmake .. \
  -DCMAKE_BUILD_TYPE=Release \
  -DBUILD_EXAMPLES=OFF \
  -DBUILD_TESTING=OFF \
  -DEIGENSPARSE=ON \
  -DCXX11=ON \
  -DCMAKE_INSTALL_PREFIX=/usr/local

-DCMAKE_BUILD_TYPE=Release：启用编译器优化，生成性能最优的发布版本。调试时可用Debug。
-DBUILD_EXAMPLES=OFF：如果你不需要示例程序，可以关闭以加快编译速度。
-DBUILD_TESTING=OFF：同上，关闭测试构建。
-DEIGENSPARSE=ON：强制使用Eigen的稀疏模块，这通常是好的。
-DCXX11=ON：确保使用C++11标准。
-DCMAKE_INSTALL_PREFIX=/usr/local：指定安装路径。/usr/local是用户级安装的标准位置。

提示：如果CMake报告找不到某个依赖（如SuiteSparse），你可以使用-D<PackageName>_DIR参数手动指定其CMake配置文件的路径。例如：-DSuiteSparse_DIR=/usr/lib/x86_64-linux-gnu/cmake/suitesparse/。

2.3 编译、安装与系统集成

配置成功后，开始编译。-j参数指定并行编译的作业数，通常设置为CPU核心数，以最大化利用计算资源。

make -j$(nproc) # $(nproc)会自动获取你的CPU核心数

编译过程可能需要几分钟。完成后，执行安装命令，这会将库文件、头文件等复制到CMAKE_INSTALL_PREFIX指定的目录（如/usr/local）。

sudo make install

最后，更新系统的动态链接器缓存，确保新安装的库能被找到：

sudo ldconfig

验证安装：创建一个简单的测试程序test_ceres.cc，尝试包含Ceres头文件并链接。如果能成功编译并运行一个简单的优化问题，则证明安装成功。

3. g2o：图优化框架的定制化安装与疑难排解

g2o（General Graph Optimization）是一个基于图模型的通用优化框架，在SLAM中应用极广。它的依赖更多样，安装过程也可能更曲折。

3.1 处理复杂的依赖关系

g2o的依赖包括图形界面、数学库和稀疏求解器。

sudo apt install -y qt5-qmake qt5-default libqglviewer-dev-qt5 \
  libsuitesparse-dev libcxsparse3 libcholmod3 libeigen3-dev \
  libsuitesparse-dev libblas-dev liblapack-dev

Qt5相关 (qt5-qmake, qt5-default, libqglviewer-dev-qt5)：用于编译g2o的可视化工具。如果你确定不需要GUI（例如在无头服务器上），可以通过CMake选项关闭，从而避免安装这些依赖。
SuiteSparse相关：与Ceres类似，g2o也需要它来处理稀疏矩阵。
BLAS/LAPACK：线性代数基础运算库。

3.2 源码编译与关键配置选项

同样，我们从GitHub获取源码并切换到稳定分支。

git clone https://github.com/RainerKuemmerle/g2o.git
cd g2o
git checkout master # 或最新的稳定tag，如 20230223_git
mkdir build && cd build

g2o的CMake配置选项更为丰富，允许你进行深度定制：

cmake .. \
  -DCMAKE_BUILD_TYPE=Release \
  -DG2O_BUILD_EXAMPLES=OFF \
  -DG2O_BUILD_APPS=ON \ # 构建应用程序（如g2o_viewer）
  -DG2O_USE_OPENGL=ON \
  -DG2O_USE_OPENMP=ON \ # 启用OpenMP并行，提升性能
  -DEIGEN3_FOUND=ON \
  -DCMAKE_INSTALL_PREFIX=/usr/local

一个常见的“坑”：g2o可能会与系统已安装的旧版Eigen发生冲突。如果遇到Eigen相关错误，可以尝试强制指定Eigen的路径：

-DEIGEN3_INCLUDE_DIR=/usr/include/eigen3

另一个潜在问题是Qt5版本。Ubuntu 20.04默认的Qt5版本是5.12。如果CMake找不到Qt5，可以尝试安装qtbase5-dev包，或显式指定Qt5的路径。

3.3 解决编译错误与安装后步骤

编译命令与Ceres类似：

make -j$(nproc)

如果编译过程中出现错误，请仔细阅读错误信息。常见问题包括：

找不到QGLViewer：确保libqglviewer-dev-qt5已安装。有时库文件命名可能略有不同，需要手动创建符号链接或修改CMake文件。
C++标准不兼容：g2o较新版本需要C++14或更高标准。在CMakeLists.txt中或通过CMake命令（-DCMAKE_CXX_STANDARD=14）进行设置。
符号重复定义：可能是由于多个版本的库冲突。确保清理旧的构建目录（rm -rf build）重新开始。

编译成功后，进行安装：

sudo make install
sudo ldconfig

验证g2o安装：尝试运行g2o提供的命令行工具或查看安装的文件：

# 查看g2o的头文件和库是否在标准路径下
ls /usr/local/include/g2o/
ls /usr/local/lib/libg2o_*.so

4. 工程化集成：在CMake项目中优雅地使用Ceres与g2o

安装完成只是第一步，如何在你自己的CMake项目中无缝使用它们，才是真正的挑战。这里分享一种稳健的配置方法。

4.1 编写健壮的FindPackage脚本与现代CMake集成

对于Ceres，由于其提供了优秀的CMake配置包，集成非常简单。在你的项目CMakeLists.txt中：

cmake_minimum_required(VERSION 3.10)
project(MySLAMProject)

set(CMAKE_CXX_STANDARD 14)

# 查找Ceres库
find_package(Ceres REQUIRED)

# 添加你的可执行文件
add_executable(my_app main.cpp)

# 将Ceres的库和头文件路径链接到你的目标
target_link_libraries(my_app Ceres::ceres)

对于g2o，情况稍微复杂，因为它可能没有提供完全兼容的CMake配置包。一种可靠的方法是使用find_library和find_path：

# 查找g2o的核心库及其组件
find_path(G2O_INCLUDE_DIR g2o/core/base_vertex.h
          PATHS /usr/local/include /usr/include)
find_library(G2O_CORE_LIB NAMES g2o_core
             PATHS /usr/local/lib /usr/lib)
find_library(G2O_STUFF_LIB NAMES g2o_stuff
             PATHS /usr/local/lib /usr/lib)
# ... 查找其他需要的g2o组件库，如g2o_solver_cholmod, g2o_types_sba等

if(G2O_INCLUDE_DIR AND G2O_CORE_LIB AND G2O_STUFF_LIB)
    message(STATUS "Found g2o: ${G2O_INCLUDE_DIR}")
    add_library(g2o INTERFACE IMPORTED)
    target_include_directories(g2o INTERFACE ${G2O_INCLUDE_DIR})
    target_link_libraries(g2o INTERFACE
        ${G2O_CORE_LIB}
        ${G2O_STUFF_LIB}
        # ... 链接其他找到的g2o库
        )
else()
    message(FATAL_ERROR "g2o not found!")
endif()

# 在你的目标中使用
target_link_libraries(my_app g2o)

4.2 依赖管理与容器化建议

为了避免“在我的机器上可以运行”的问题，考虑使用容器技术（如Docker）来固化你的开发环境。创建一个Dockerfile，将上述所有安装步骤脚本化，可以确保团队每个成员以及生产环境的一致性。

FROM ubuntu:20.04

# 安装系统依赖、Ceres、g2o...
RUN apt-get update && apt-get install -y ... # 所有上述apt命令
RUN git clone ... && cd ... && mkdir build ... # 所有编译安装步骤

# 设置工作目录和默认命令
WORKDIR /workspace
CMD ["/bin/bash"]

此外，对于更复杂的项目，可以考虑使用高级包管理器如vcpkg或conan来管理Ceres和g2o的依赖，它们能更好地处理跨平台和版本依赖问题。

4.3 性能调优与调试技巧

编译优化：在最终部署时，确保使用-DCMAKE_BUILD_TYPE=Release。对于g2o，开启-DG2O_USE_OPENMP=ON可以利用多核CPU加速优化求解。
符号调试：在开发阶段，使用Debug构建类型（-DCMAKE_BUILD_TYPE=Debug）并配合GDB或LLDB进行调试。尽管Ceres和g2o内部复杂，但你的代码逻辑问题可以通过断点清晰定位。
内存与性能剖析：使用valgrind检查内存泄漏，使用perf或gprof进行性能热点分析。特别是在处理大规模图优化时，瓶颈可能出现在线性求解器选择或雅可比矩阵计算上。

我在多个机器人项目中部署过这两个库，最深刻的体会是：环境隔离和版本记录至关重要。曾经因为系统升级导致SuiteSparse版本变化，整个优化系统结果出现微小偏差，排查了整整一周。现在，对于任何重要项目，我都会将完整的依赖树（包括库的版本号）记录在项目的README或environment.yml文件中，并优先考虑使用Docker容器。对于Ceres和g2o，直接从源码安装在/usr/local下虽然方便，但在处理多个需要不同版本库的项目时，使用CMAKE_INSTALL_PREFIX安装到独立目录，或者利用conda环境管理可能是更优雅的方案。记住，顺利安装只是起点，将它们稳定、高效地融入你的工程流水线，才是发挥其威力的关键。