C++项目在Ubuntu如何进行持续集成

在 Ubuntu 上为 C++ 项目搭建持续集成

方案总览与选型

先说说持续集成这个事儿，做C++项目，光本地编译通过可不够，代码一合并，环境一换，问题就全都冒出来了。所以，选一个合适的CI工具是第一步。主流方案有这么几种，大家可以根据自己的需求来选。

先说GitHub Actions，这玩意儿直接托管在GitHub上，配置即代码，对开源项目特别友好，团队协作也方便。如果你需要完全掌控自己的环境，那Jenkins是个经典选择，自托管，灵活可扩展，尤其适合内网环境和复杂的流水线需求。还有GitLab CI/CD，跟GitLab仓库深度集成，如果你用GitLab，那这个就是无缝衔接的方案。当然，如果只是轻量入门，Tra vis CI也是个不错的选择，跟GitHub集成得也很好。

基础环境方面，建议统一在Ubuntu上安装build-essential（包含GCC/G++）、CMake、Git这些工具，作为所有CI运行时的基线。这样一来，不管用什么方案，底层的编译环境都是一致的，能省去不少麻烦。

快速上手 GitHub Actions

我们来看看怎么快速上手。首先，在项目根目录创建文件.github/workflows/ci.yml。然后，像下面这样配置工作流：

name: C++ CI
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]
jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - name: Install dependencies
      run: sudo apt-get update && sudo apt-get install -y g++ cmake
    - name: Configure
      run: |
        mkdir -p build
        cd build
        cmake -DCMAKE_BUILD_TYPE=Release ..
    - name: Build
      run: cmake --build build -j$(nproc)
    - name: Test
      run: cd build && ctest --output-on-failure

这里有几个关键点。把测试接入CTest是明智之举，这样在CI中就能统一执行并输出结果，一目了然。另外，你还可以按需扩展矩阵构建，针对不同的编译器、标准、构建类型进行测试，覆盖面更广。

自托管 Jenkins 流水线

如果你需要私有化部署，Jenkins是个相当靠谱的选择。在Ubuntu上安装和启动Jenkins也很直接，参考下面的命令：

sudo apt update
sudo apt install -y openjdk-11-jre
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update
sudo apt install -y jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins

安装完成后，在Jenkins中创建Pipeline任务，选择“Pipeline script from SCM”，SCM选Git，然后指定仓库和分支，脚本路径设置为Jenkinsfile。下面是一个示例Jenkinsfile，思路跟GitHub Actions一致：拉取代码、配置环境、构建、测试。这个流程清晰又稳定。

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps { git url: 'https://github.com/your-org/your-cpp-project.git', branch: 'main' }
        }
        stage('Install deps') {
            steps { sh 'sudo apt-get update && sudo apt-get install -y g++ cmake' }
        }
        stage('Configure') {
            steps {sh 'mkdir -p build && cd build && cmake -DCMAKE_BUILD_TYPE=Release ..'}
        }
        stage('Build') {
            steps { sh 'cmake --build build -j$(nproc)' }
        }
        stage('Test') {
            steps { sh 'cd build && ctest --output-on-failure' }
        }
    }
}

Jenkins的亮点在于，它适合复杂流程编排和制品归档场景。通过Pipeline插件，你就能快速落地一套完整的CI流水线，灵活度很高。

其他托管与自建选项

除了上面两个，还有几个方案值得留意。GitLab CI/CD，在项目根目录创建.gitlab-ci.yml，使用ubuntu:20.04/22.04镜像安装g++，然后执行构建和测试，适合与GitLab仓库一体化使用，非常省心。Tra vis CI则更轻量，在仓库根目录创建.tra vis.yml，指定语言为c++，在install/script阶段安装依赖并执行构建与测试，适合开源项目快速接入，门槛极低。

质量门禁与最佳实践

最后，聊聊质量门禁。这不是简单的编译通过就完事儿，而是要通过一系列手段把代码质量锁死。编译器警告一定要开，在CMake或编译命令中启用-Wall -Wextra，必要时加入-Werror，这样代码在CI中就能始终保持在高标准上编译。静态分析也得跟上，在CI中加入Cppcheck或Clang Static Analyzer，能提前发现潜在缺陷，避免后期返工。测试方面，用CTest运行单元测试和集成测试，结合覆盖率工具（如gcov/lcov），上传报告作为合并前的质量门槛，这才能在团队里形成真正的质量意识。

依赖管理也不能忽视。系统库优先用apt安装，第三方依赖可以用vcpkg或Conan统一管理，同时在CI中缓存依赖，加速构建过程。这些小细节积累起来，就能让整个CI流程跑得又快又稳。